A VNC viewer for ebook readers
C Assembly HTML Shell Java Lua Other
Switch branches/tags
Nothing to show
Latest commit e6bec4d Mar 2, 2015 @hwhw Merge pull request #7 from langelgjm/master
removed GLIBC 2.7 dependency, added bugfix for Kindle DX


This is a VNC viewer for e-book devices
Copyright (c) 2013 Hans-Werner Hilse <hilse@web.de>

It works on the framebuffer, using the einkfb API from e-ink devices (einkfb.h) to do screen refreshs.
This is based on LibVNCclient (part of the LibVNCserver project, see http://libvncserver.sourceforge.net/.

There's a discussion thread at

Note that the current version is a major rewrite from the original version.
The current version is implemented in Lua, targeted at LuaJIT.


input handling is configurable/customizable in "config.lua".

kVNCviewer supports a lot of options that determine various settings. Run it without any argument to show a list of supported options. In addition, libvncviewer parses the options, too. That allows for additional configuration settings. Look into the documentation of libvncviewer to see those options:


In order to build kindlevncviewer, you can use GNU make. Specify a toolchain prefix as "ARCH" variable:

    make ARCH=arm-linux-gnueabihf

and it should build luajit, zlib, libjpeg and finally libvncclient.

You can find the result in the "dist/<ARCH>" subdirectory. Also, a .zip file is created for distribution.


You need to copy the program and the libraries it needs (you can just try running it without and it will show you which libraries are missing) onto your ebook device. Then call (from a launcher app or a shell)

    ./luajit vncviewer.lua

(you will need to put in the correct server address or name and screen number).


This software is licensed under the GPLv2 (see file COPYING).