Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

gandergo/eink-vnc

Open more actions menu
 
 

Repository files navigation

eInk VNC

A lightweight CLI (command line interface) tool to view a remote screen over VNC, designed to work on eInk screens. For now, you can only view, so you'll have to connect a keyboard to the serving computer, or find some other way to interact with it.

This tool has been confirmed to work on several Kobo devices, such as the Kobo Libra 2 and Elipsa2E. It was optimized for text based workflows (document reading and writing), doing that it achieves a framerate of 30 fps.

As VNC server we tested successfuly with TightVNC, x11vnc and TigerVNC.

Warning

The screen can refresh up to 30 times per second, this will degrade the eInk display rapidly. Do not use with fast changing content like videos.

Furthermore, this tool was only tested on Kobo Libra 2 and Kobo Elipsa 2E. It is possible that it will damage yours. I cannot be held responsible, use this tool at your own risk.

einkvnc_demo_kobo_rotated.webm

Usage

You can use this tool by connecting to the eInk device through SSH, or using menu launchers on the device itself.

To connect to a VNC server:

./einkvnc [IP_ADDRESS] [PORT] [OPTIONS]

For example:

./einkvnc 192.168.2.1 5902 --password abcdefg123 --contrast 2 

For faster framerates, use USB networking (see https://www.mobileread.com/forums/showthread.php?t=254214).

Derivatives

The code responsible for rendering to the eInk display is written by baskerville and taken from https://github.com/baskerville/plato. The code responsible for communicating using the VNC protocol is written by whitequark and taken from https://github.com/whitequark/rust-vnc.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.