About
This is a VNC viewer for eReaders. Copyright (c) 2013 Hans-Werner Hilse [email protected]
It works on the framebuffer, using the einkfb API from e-ink devices (einkfb.h) to do screen refreshes. This is based on LibVNCClient, part of the LibVNCServer project.
There is a discussion thread on MobileRead: http://www.mobileread.com/forums/showthread.php?t=150434
Note that the current version is a major rewrite of the original version. The current version is implemented in Lua, targeted at LuaJIT.
Configuration
Input handling is configurable/customizable in "config.lua".
kVNCviewer supports many options that determine various settings. Run it without arguments to show a list of supported options. In addition, LibVNCClient parses options, which allows for additional configuration. Look into the documentation of LibVNCClient to see the options it accepts.
Building
In order to build kVNCViewer, you can use GNU make. A Kindle (and other eReaders)-specific toolchain can be found at @koreader/koxtoolchain. Specify a toolchain prefix as the "ARCH" variable, and it should build luajit, zlib, libjpeg and finally libvncclient. E.g., for legacy Kindles:
make ARCH=arm-kindle-linux-gnueabi
You can find the result in the "dist/" subdirectory. Also, a .zip file is created for distribution.
Running
You need to copy the program and the libraries it needs onto your eReader (you can try running it without and it will show you which libraries are missing). Then, from a launcher app or shell, call:
./luajit vncviewer.lua 192.168.1.1:5900
You will need to enter the correct server address or name and screen number.
Licensing/Copying
This software is licensed under the GPLv2 (see file COPYING).