ebook liberation script
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
thufie 380fb6e557 Merge branch 'next' of thufie/ebook-liberator into master 4 months ago
project added project files 5 months ago
src/main/scala/liberator finished testing, appears to work 4 months ago
.gitignore edited .gitignore 5 months ago
LICENSE initial commit 9 months ago
README.md Update 'README.md' 4 months ago
build.sbt setting up sbt and base project files 5 months ago



Scala program for making a .pdf file from any proprietary ebook reader/webpage by scanning through all the pages. Tested with Kindle Cloud Reader, but should work with any e-reader application which is fussy and won’t make a friendly file for you.

Intended for personal use only with materials you own the rights to, of course.


The latest working version is available for download https://thufie.lain.haus/files/liberator.jar on my website.

To build it yourself, clone this repository, install sbt (scala build tool, you will probably need scala) and run sbt assembly in the directory (the output will tell you where the jar file is).


  • imagemagick (see troubleshooting and preemptively fix the common issue on Arch Linux)
  • Java or Scala
  • maim - screenshot tool
  • xdotool - usually included in X-based linux desktops


  • Either run with scala (preferred): scala liberator.jar (x/sway) (file) (pages) (delay)
  • Or run with java: java -jar liberator.jar (x/sway) (file) (pages) (delay)
  • so for example: scala liberator.jar x Free_Culture 345 500 (where the delay is in milliseconds, so 500 is 0.5 )
  • Do a test run with only a few pages first to get the feel of it, since YOU CANNOT STOP IT ONCE IT HAS STARTED.


  • If you get the error: convert: attempt to perform an operation not allowed by the security policy 'PDF' @ error/constitute.c/IsCoderAuthorized/408.
  • Make a bug report or contact me if you have any other issues.