goMarkableStream

Go Static Badge

goMarkableStream

Screen recording 2026-02-04 11.24.44.webm

Overview

goMarkableStream is a lightweight and user-friendly application designed specifically for the reMarkable tablet.

Its primary goal is to enable users to stream their reMarkable tablet screen to a web browser without the need for any hacks or modifications that could void the warranty.

Table of Contents

Device Support

Actively supported and tested:

Experimental (not actively tested):

Version Support

The latest version of goMarkableStream is actively developed and tested on reMarkable 2 with firmware 3.24+.

For older firmware versions:

Features

Core Benefits

Streaming

Remote Access (Tailscale)

Interaction

Presentation Mode

UI

Available Binaries

Each release provides four binary variants:

Binary Device Tailscale Support
gomarkablestream-RMPRO reMarkable Paper Pro (arm64) Yes
gomarkablestream-RM2 reMarkable 2 (arm) Yes
gomarkablestream-RMPRO-lite reMarkable Paper Pro (arm64) No
gomarkablestream-RM2-lite reMarkable 2 (arm) No

Which binary should I use?

Quick Start

  1. Connect your reMarkable to your computer via USB-C cable and SSH into it: 
    ssh root@10.11.99.1
  2. Download and run (choose your device): ```bash

    Set your device: RM2 for reMarkable 2, RMPRO for Paper Pro

    DEVICE=RM2

Download latest version

VERSION=$(wget -q -O - https://api.github.com/repos/owulveryck/goMarkableStream/releases/latest | grep tag_name | awk -F" ‘{print $4}’) wget -O goMarkableStream https://github.com/owulveryck/goMarkableStream/releases/download/$VERSION/gomarkablestream-$DEVICE chmod +x goMarkableStream ./goMarkableStream


3. Open https://10.11.99.1:2001 in your browser
   - Default credentials: `admin` / `password`

_Note_: You can also connect via Wi-Fi using your tablet's IP address or `remarkable.local.` (with trailing dot) on Apple devices.

For lite versions (without Tailscale), append `-lite` to the device name: `gomarkablestream-RM2-lite`

To update to a new version, use the built-in download command: `./goMarkableStream download` (see [Subcommands](#subcommands)).

### Errors due to missing packages

If you get errors such as `wget: note: TLS certificate validation not implemented`, download goMarkableStream on your local computer and copy it over:

```bash
# On your local computer (set DEVICE to RM2 or RMPRO)
DEVICE=RM2
VERSION=$(wget -q -O - https://api.github.com/repos/owulveryck/goMarkableStream/releases/latest | grep tag_name | awk -F\" '{print $4}')
wget -O goMarkableStream https://github.com/owulveryck/goMarkableStream/releases/download/$VERSION/gomarkablestream-$DEVICE
chmod +x goMarkableStream

# Copy to reMarkable (via USB-C)
scp ./goMarkableStream root@10.11.99.1:/home/root/goMarkableStream

# SSH and run
ssh root@10.11.99.1 ./goMarkableStream

Setup as a Systemd Service

The easiest way to install goMarkableStream as a systemd service is using the built-in install subcommand:

./goMarkableStream install

This will create the service file and enable it to start automatically on boot. You can change the settings by editing /home/root/.config/goMarkableStream/env

Alternatively, you can manually create the service file after connecting via USB-C (ssh root@10.11.99.1):

cat <<'EOF' > /etc/systemd/system/goMarkableStream.service
[Unit]
Description=goMarkableStream Server

[Service]
ExecStart=/home/root/goMarkableStream
Restart=always

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable --now goMarkableStream.service

To check status: systemctl status goMarkableStream.service

To view logs: journalctl -u goMarkableStream.service

To stop: systemctl stop goMarkableStream.service

Note: After a reMarkable system update, you may need to re-download the binary and restart the service.

Subcommands

goMarkableStream provides built-in subcommands to simplify installation and updates:

install

Installs goMarkableStream as a systemd service for automatic startup:

./goMarkableStream install

This command:

download

Downloads the latest version from GitHub releases:

./goMarkableStream download

This command:

  1. Computes the SHA256 checksum of the currently running binary
  2. Fetches the latest release from GitHub
  3. Compares the current checksum against all binaries in the release
  4. If you’re already running the latest version, it tells you
  5. If a newer version is available, prompts you to confirm the download
  6. Lists all available binaries and lets you choose which one to download
  7. Downloads and verifies the checksum of the selected binary
  8. Asks if you want to replace the current binary with the downloaded one

This is the recommended way to update goMarkableStream on your device.

Configurations

Device Configuration

Configure the application via environment variables:

Tailscale Configuration

Tailscale allows secure remote access to your reMarkable tablet from anywhere on your tailnet, without exposing the device to the public internet. When enabled, goMarkableStream creates both a local listener (on RK_SERVER_BIND_ADDR) and a Tailscale listener.

Requirements:

Environment variables:

Example usage:

# Enable Tailscale with interactive login (displays login URL in console)
RK_TAILSCALE_ENABLED=true ./goMarkableStream

# Enable Tailscale with auth key (headless setup)
RK_TAILSCALE_ENABLED=true RK_TAILSCALE_AUTHKEY=tskey-auth-xxx ./goMarkableStream

# Recommended: ephemeral mode with auth key (node removed on disconnect, random hostname suffix)
RK_TAILSCALE_ENABLED=true RK_TAILSCALE_EPHEMERAL=true RK_TAILSCALE_AUTHKEY=tskey-auth-xxx ./goMarkableStream

# Access via Tailscale: https://gomarkablestream.your-tailnet.ts.net:8443
# Access locally: https://remarkable.local.:2001

Systemd service with Tailscale:

Add the environment variables to your systemd service file:

[Service]
Environment="RK_TAILSCALE_ENABLED=true"
Environment="RK_TAILSCALE_AUTHKEY=tskey-auth-xxx"
ExecStart=/home/root/goMarkableStream

Endpoint Configuration

Add query parameters to the URL (?parameter=value&otherparameter=value):

API Endpoints

Presentation Mode

goMarkableStream introduces an innovative experimental feature that allows users to set a presentation or video in the background, enabling live annotations using a reMarkable tablet. This feature is ideal for enhancing presentations or educational content by allowing dynamic, real-time interaction.

How It Works

Usage Example

Compatibility

goMarkableStream is fully integrated with Reveal.js, making it a perfect tool for presentations. Switch slides or navigate through your presentation directly from your reMarkable tablet. This seamless integration enhances the experience of both presenting and viewing, making it ideal for educational and professional environments.

How to: add the ?present=https://your-reveal-js-presentation

Note: Due to browser restrictions, the URL must be HTTPS.

Limitations and Performance

Technical Details

This tool suits my needs and is an ongoing development. You can find various information about the journey on my blog:

reMarkable HTTP Server

This is a standalone application that runs directly on a reMarkable tablet. It does not have any dependencies on third-party libraries, making it a completely self-sufficient solution. This application exposes an HTTP server with several endpoints.

Implementation

The image data is read directly from the main process’s memory as a BGRA byte array.

Delta Compression: The streaming uses delta encoding to minimize bandwidth:

The CPU footprint is relatively low, using about 10% of the CPU for a frame every 200 ms. You can increase the frame rate, but it will consume slightly more CPU.

On the client side, the streamed byte data is decoded (with automatic gzip decompression for full frames using the browser’s native DecompressionStream API) and displayed on a canvas through WebGL.

Additionally, the application features a side menu which allows users to rotate the displayed image. All image transformations utilize native browser implementations, providing optimized performance.

Compilation

GOOS=linux GOARCH=arm GOARM=7 CGO_ENABLED=0 go build -v -trimpath -ldflags="-s -w" .

To install and run, you can then execute:

scp goMarkableStream root@remarkable:
ssh root@remarkable ./goMarkableStream

Contributing

I welcome contributions from the community to improve and enhance the reMarkable Screen Streaming Tool. If you have any ideas, bug reports, or feature requests, please submit them through the GitHub repository’s issue tracker.

License

The reMarkable Screen Streaming Tool is released under the MIT License . Feel free to modify, distribute, and use the tool in accordance with the terms of the license.

This site is open source. Improve this page.