Kindle -- KOReader: a document reader for PDF, DJVU, EPUB, FB2, HTML, ... (GPLv3)
#1  hawhill 03-26-2013, 03:49 PM

some of you may have come across the KindlePDFViewer (KPV) application in the past. Since a couple of month, we - the development team - tried to port its functionality over to touch based devices like the Kindle 5 (Touch) and the Kindle Paperwhite. The effort has now gotten far enough to warrant a first official release.

Since KindlePDFViewer got support for many more document formats than just PDF, that called for a new name. We settled on KOReader as the new name.

Moderator Notice

This thread was copied from its original home in the Kindle Developer's Corner, and has a wealth of (mostly disorganized ) accumulated information which is generally applicable to KOReader.

Please address any Kindle-specific questions (e.g. device integration, getting KOReader to run, anything where it matters that you are using a Kindle and not a Kobo/Pocketbook/Android) in the Kindle Developer's Corner.

This ensures that the Kindle experts can help you with Kindle-specific problems, and the KOReader experts can help you with KOReader-specific problems.

KOReader's features


Current limitations

KOReader is still in an early stage. You will notice some inconveniences, some incoherences in the user interface and maybe even a bug here and there. Feel free to ask questions in this thread and report bugs in our issue tracker (link at the bottom of this posting). Documentation is lacking. Help is welcome!

There is currently no support for pure keyboard-based devices. For those, you're encouraged to have a look at the stable version - KindlePDFViewer. An alternative, especially for the Kindle 4 (NT) is Librerator, a fork of KindlePDFViewer.

However, it is already usable - so feel free to give it a try. And of course, expect updates, so come back and check this post from time to time.


All releases and nightlies are linked here:

The wiki page with install & usage instructions is here:

You can find the source code here:
Please report bugs here:

The source code of KPV Booklet is available here:

Legacy, stable code for keyboard-based devices (K2, KDX, K3): KindlePDFViewer -

Forked version, especially for the K4 (NT), but also for other keyboard-based devices: Librerator -

#2  hawhill 03-26-2013, 04:02 PM
This post is reserved for FAQs


I installed the latest Nightly Build and it crashes!
You decide: Either invest time and get in contact with the developers to help debugging. But please check beforehand if this is already actively discussed. But then, you could also decide to not bother. Nightly Builds are untested almost by definition and there will always be some builds that don't work at all, don't work fully, etc. etc.

#3  twobob 03-26-2013, 04:05 PM

EDIT: Since more and more people are asking about this I have added these instructions here

Here is what I originally said many moons ago...

Let me know if you want this indexed or something. or anything.

Beastly awesomeness.
screenshot_2013_11_11T14_46_54+0000.png screenshot_2013_11_11T14_39_20+0000.png screenshot_2013_11_11T14_25_24+0000.png screenshot_2013_11_11T14_47_04+0000.png screenshot_2013_11_11T14_47_13+0000.png 

#4  hawhill 03-26-2013, 04:08 PM
Thanks! Let it get settled for a moment, I guess we'll have a flurry of updates in the coming days and weeks to really bring it in shape. It's still a bit rough around the edges. Still some work to do.

This is probably a good place to say big thanks to other contributors, first and foremost to @chrox and @houqp (Github names) who did awesome work to make this happen.

#5  twobob 03-26-2013, 04:39 PM
Okay mate. Undying admiration from our camp.

#6  dave2008 03-26-2013, 04:48 PM
Finally it's there

We are also working on the user document for installation and usage etc.

BTW, @twobob I am thinking of using KUAL to do update, should we write anupdate script and call it in KUAL or does KUAL supports customupdate features like launchpad?

#7  twobob 03-26-2013, 04:58 PM
Since I dont know what the customupdate thingy is I am am going to say it doesnt.

But if you can point me to a spec on that it could well do in the future.

So. In précis, for now a script, in the future was could look to include the functionality - once I know what it is!

#8  hawhill 03-26-2013, 05:07 PM
Launchpad's custumupdates macro was a simple script that
- checked the folder "customupdates" for any ZIP files
- if there were some, it would extract them to the /mnt/us (usb drive root) file system and delete the ZIP if successfully extracted

That allowed easy installation for apps - just drop a ZIP file in the "customupdates" folder, run the macro - done.

I guess such a thing could easily be made available for KUAL, too. Question is, however, if KUAL should be extended with such a script - I guess the discussion about that should go to the KUAL thread.

#9  twobob 03-26-2013, 05:10 PM
Agreed. Shutting up now. Noise ends here

#10  otichy 03-26-2013, 07:13 PM
Hooray! Can I just update the older nightlies from Chrox's repo with the new ones - is it a simple update like that?
And thanks!

  Next »  Last »  (1/110)
Today's Posts | Search this Thread | Login | Register