Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/CrazyCoder/coolreader-kindle-qt

Cool Reader 3 port for Kindle Paperwhite, Touch, 4NT, 3, DX
https://github.com/CrazyCoder/coolreader-kindle-qt

Last synced: 18 days ago
JSON representation

Cool Reader 3 port for Kindle Paperwhite, Touch, 4NT, 3, DX

Awesome Lists containing this project

README 

        
Cool Reader 3 port for Kindle Paperwhite, Touch, 4NT, 3, DX

=========================================

This project is a port of Cool Reader application (by **Vadim Lopatin** AKA **Buggins**) to Kindle.

It supports epub (non-DRM), fb2, doc, txt, rtf, html, chm, tcr, pdb, prc, mobi (non-DRM), pml formats.



The port was originally created by **Andy Wooden**, **fau** and **VladKi**, the project had no fixed home and its

sources were distributed as tarballs, making it hard to maintain and provide updates.

This site is the **new project home**.



The fronentd is Qt based (QWS) and has custom display and keyboard drivers. Up until October 2012 there was no good

working graphics driver available for Kindle 4 (2011 and 2012 models), this caused a problem with poor eink contrast

display. Finally, **Andy Wooden** has found some time to make it work properly on Kindle 4, he contacted me with the

updated driver source that I compiled and released with the new Cool Reader distribution on various forums.



Another goal of this project is to make it easier to install on new Kindle devices. As K4 has no keyboard, there is no

hack like launchpad for it. However, it's possible to run **Kindlets** (these are small apps written in Java, almost

like the old Java Applets). [cr3runner](http://code.google.com/p/cr3runner/) by **Victor Pyankov** provides an easy way

to run custom applications and scripts on Kindle 4 devices. Kindlets are signed with developer keys that need to be

available on your device, it makes the installation process pretty hard (2 system files need to be replaced manually).



[KindleTool](https://github.com/NiLuJe/KindleTool) project allows to package custom files and scripts to be run on

jailbroken devices from the standard Kindle Update menu. Some users were providing **cr3runner** installer, but it

was old, crashed often and didn't install on Kindle 4 2012 (black) model. I changed it a bit to provide better user

experience (no menu when there is only one command, **Cool Reader** name in the documents list, updated installer that runs

on all K4 models).



So, here you have the latest **Qt drivers providing perfect contrast** on K4, most recent **Cool Reader 3 Qt port** for

Kindle based on the git **crengine** sources, updated **cr3runner** to easily run it on your device and packaged into

Kindle update with the help of **KindleTool** for easier installation. No need to research and google, everything is in

one place!



Feel free to fork and send me pull requests/patches.



Kindle Paperwhite and Touch Support

=========================================

-   [Installation instructions](http://www.mobileread.com/forums/showpost.php?p=2278589&postcount=147) (eng)

-   [Installation instructions](http://www.the-ebook.org/forum/viewtopic.php?p=973382#973382) (rus)



Quick Installation Guide for K3/K4NT

=========================================

-   [Russian guide](http://kindle.copiny.com/question/details/id/66374)



1.  [Jailbreak](http://wiki.mobileread.com/wiki/Kindle4NTHacking) your Kindle

2.  Copy **update_cr3runner_n.n_install-k4.bin** from

    [cr3runner.zip](https://github.com/downloads/CrazyCoder/coolreader-kindle-qt/cr3runner.zip) to Kindle flash root

3.  Copy all directories from **cr3-kindle-nnnn-nn-nn.zip** available in

    [Downloads](https://github.com/CrazyCoder/coolreader-kindle-qt/downloads) to Kindle flash root

4.  (optional, but recommended) Download the latest test version as the 

    [repository snapshot zip](https://github.com/CrazyCoder/coolreader-kindle-qt/zipball/master) and copy all the files

    from the **dist** folder replacing all existing files on the connected Kindle (this way you update to the most recent

    version with all the latest changes)

5.  From the Kindle **Settings** dialog open menu, run **Update Your Kindle**

6.  After reboot you should have **Cool Reader** in the documents list, open it.



Kindle 3/DX owners can also use [launchpad](http://www.mobileread.com/forums/showthread.php?t=97636).



Links

=========================================

-   Russian discussion thread on [the-ebook.org forum](http://www.the-ebook.org/forum/viewtopic.php?t=20811)

-   English discussion thread on [mobileread.com forum](http://www.mobileread.com/forums/showthread.php?t=148850)