whatisgithub

What is rm-render?

txoof/rm-render — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

A self-hosted tool that watches an rmfakecloud server and automatically converts synced reMarkable tablet documents, including handwritten notes, into browsable PDF files.

Mindmap

mindmap
  root((repo))
    What it does
      Converts reMarkable files to PDF
      Overlays handwritten annotations
      Serves files over local web
    Tech stack
      Python
      Docker and nginx
      Systemd service
    Use cases
      Read tablet notes as PDF
      Auto render new synced pages
      Browse notes from any device
    Audience
      Self hosters
      reMarkable tablet owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically convert reMarkable tablet notes into PDF files as soon as they sync to rmfakecloud.

USE CASE 2

Browse and open rendered tablet documents from a phone or laptop via a local web page.

USE CASE 3

Keep handwritten annotations and page links visible when converting annotated PDFs.

USE CASE 4

Run the converter as a background service that updates itself as new pages arrive.

What is it built with?

PythonDockernginxsystemd

How does it compare?

txoof/rm-render0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires an existing rmfakecloud installation with sync15 enabled, plus Docker and a couple of command line prerequisites.

So what is it?

This project takes documents from a reMarkable tablet and turns them into regular PDF files you can view in a browser. It is meant to work alongside rmfakecloud, a self hosted stand in for reMarkable's own cloud service, and it watches that service's storage for changes whenever your tablet syncs. When a change is detected, the tool reads the tablet's internal file format directly and renders it into a PDF, keeping pages in the right order and drawing any handwritten annotations on top of the original page. It handles three kinds of documents differently: a plain PDF is copied through as is, a PDF with handwritten notes gets those pen strokes layered onto each page while preserving the PDF's original clickable links, and a notebook, which has no original PDF at all, gets its handwritten pages drawn onto a blank page. The finished PDFs are served through a small local web server so you can browse and open them from any device on your network. Installation is handled by a single script that detects your existing rmfakecloud setup, sets up the local web server configuration, and installs a background service so the tool keeps running and updating automatically as new pages sync in. The same script can update the tool later, or remove it entirely, including an option to delete the rendered PDF files. The tool runs on Ubuntu Linux and needs an existing rmfakecloud installation with a specific sync feature turned on, along with a couple of small helper programs for detecting file changes and running Python code. It has a few known gaps: certain newer pen colors may not render correctly, links inside handwritten annotations are not preserved, very large PDF files are skipped by default, and it cannot send changes back to the tablet, only read from it. The README does not state a license for this project.

Copy-paste prompts

Prompt 1
Help me install rm-render alongside my existing rmfakecloud setup on Ubuntu.
Prompt 2
Explain how rm-render decides whether a synced document is a plain PDF, an annotated PDF, or a notebook.
Prompt 3
Set up the rm-render systemd service to run under my own username with a custom rmfakecloud path.
Prompt 4
Show me how to limit rm-render to skip PDFs larger than a certain size using --max-pdf-mb.

Frequently asked questions

What is rm-render?

A self-hosted tool that watches an rmfakecloud server and automatically converts synced reMarkable tablet documents, including handwritten notes, into browsable PDF files.

What language is rm-render written in?

Mainly Python. The stack also includes Python, Docker, nginx.

How hard is rm-render to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is rm-render for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.