Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
CoolReader 3 X11 gui port for Kindle Touch, minimally adapted for the touch interface
Branch: kindle_touch
Pull request Compare This branch is 381 commits behind varnie:kindle_touch.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
android
cmake
cr3gui
cr3qt-kindle
cr3qt
cr3wx
crengine
fb2props
packages
thirdparty
tinydict
tools
.gitignore
CMakeLists.txt
README.TXT
README.md
changelog

README.md

Hacked Up Reader for Kindle Touch

HackedUpReader is a CoolReader 3 port for the Kindle Touch using the X11 gui of the CoolReader project, minimally adapted for the touch interface.

It is only meant to act as a temporary solution to get a ePub reader for the Kindle Touch.

HackedUpReader is by no means thought for general usage. Currently you need to be familiar with accessing your Kindle Touch and starting programs from the command line to use it.

What works:

  • reading e-books
  • setting options
  • battery display

What doesn't work:

  • a lot that needs keyboard input
  • selecting other e-books
  • advanced features like bookmarking because of missing keyboard
  • some fonts lead to a crash (none of the default fonts on the Touch)
  • no automatic screen refresh for removing e-ink artifacts

Installation and running

Extract the archive into your Kindle Touch user data directory.

ssh into your Kindle Touch and start it with:

/mnt/us/cr3xcb/bin/cr3 /mnt/us/path/to/your/ebook.epub &

Because of some hard coded paths HackedUpReader must be in the /mnt/us/cr3xcb directory.

Controls

When in the main screen, touching in the lower half of the screen opens the next page, touching in the upper half opens the previous page. Touching the top bar will open the menu.

When in the menu, touching the top bar acts as 'Ok', touching the bottom bar on the left side will open the previous menu page, touching the right side will open the next menu page if there are any.

Touching numbered sections in the menu will select them or open any existing sub menu.

Compilation

The source code can be found at https://github.com/bhaak/HackedUpReader

You need to set the correct values for your cross-compilation environment in tools/toolchain-arm-linux-gnueabi.cmake for the cmake variables CMAKE_C_COMPILER, CMAKE_CXX_COMPILER, CMAKE_STRIP and CMAKE_FIND_ROOT_PATH.

In the following command, "/kindle_development" should be the same directory as CMAKE_FIND_ROOT_PATH.

$ mkdir build; cd build
$ env PKG_CONFIG_LIBDIR=/kindle_development_dir/lib/pkgconfig \
   cmake \
    -DCMAKE_PREFIX_PATH=/kindle_development_dir \
    -DCMAKE_INSTALL_PREFIX=/mnt/us/cr3xcb -DCMAKE_BUILD_TYPE=Release -DGUI=CRGUI_XCB \
    -DCMAKE_TOOLCHAIN_FILE=`pwd`/../tools/toolchain-arm-linux-gnueabi.cmake ..
$ make && make install

Who are you and why are you doing this?

I'm Patric Mueller bhaak@gmx.net and I'm doing this because - contrary to Amazon who's manufacturing a great piece of hardware but is equipping it with inferior software - I like my e-books kerned, hyphenated and justified.

Something went wrong with that request. Please try again.