reStream

reMarkable screen sharing over SSH.

Installation

1. Clone this repository: git clone https://github.com/rien/reStream.
2. (Optional but recommended) Install lz4 on your host and reMarkable.
3. Set up an SSH key and add it to the ssh-agent, then add your key to the reMarkable with ssh-copy-id root@10.11.99.1.

Usage

1. Connect your reMarkable with the USB cable.
2. Make sure you can open an SSH connection.
3. Run ./reStream.sh
4. A screen will pop-up on your local machine, with a live view of your reMarkable!

Options

• -p --portrait: shows the reMarkable screen in portrait mode (the default is landscape mode, 90 degrees rotated tot the right)
• -d --destination: the ssh destination of the reMarkable (default: root@10.11.99.1)

If you have problems, don't hesitate to open an issue or send me an email.

Requirements

On your host machine:

• Any POSIX-shell (e.g. bash)
• ffmpeg (with ffplay)
• ssh

On your reMarkable nothing is needed, unless you want...

Sub-second latency

To achieve sub-second latency, you'll need lz4 on your host and on your reMarkable.

You can install lz4 on your host with your usual package manager. On Ubuntu, apt install liblz4-tool will do the trick.

On your reMarkable you'll need a binary of lz4 build for the arm platform, you can do this yourself by installing the reMarkable toolchain and compiling lz4 from source with the toolchain enabled, or you can use the statically linked binary I have already built and put in this repo.

Copy the lz4 program to your reMarkable with scp lz4.arm.static root@10.11.99.1:/home/root/lz4, make it executable with ssh root@10.11.99.1 'chmod +x /home/root/lz4' and you're ready to go.

Troubleshooting

Steps you can try if the script isn't working:

• Set up an SSH key
• Update ffmpeg to version 4.