Scrybble remarks

May 30, 2026 · View on GitHub

With Remarks, you can export notebooks and PDFs from your ReMarkable.

Export your notebooks as PDF
Extract highlights as text

Install

Remarks is designed and developed for Linux. There are no Remarks binaries.

Install nix
nix develop to work on remarks
nix run .# to run remarks

If you don't want to use Nix, you can use poetry and install the dependencies manually.

Remarks provides a nix flake for building docker images. There are two flavors, a python Flask-powered server for hosting purposes and a binary for CLI usage. The CLI container has the exact same API as the unbundled remarks python application.

# Render server (HTTP API on :5000):
nix build .#dockerServer && docker load < result

# One-shot CLI:
nix build .#dockerBin && docker load < result

The server reads a few environment variables:

Variable	Default	Purpose
`REMARKS_BIND_HOST`	`0.0.0.0`	Address gunicorn / the dev server binds to
`REMARKS_BIND_PORT`	`5000`	Port to listen on
`REMARKS_TEMP_DIR`	system temp dir	Where intermediate files are written (point at a writable volume in a read-only-root container)

GET /health returns 200 for container health checks.

Functionality

Convert a ReMarkable notebook to PDF
Extract highlights to (Obsidian-compatible) markdown

A visual example

Highlight and annotate PDFs

And then use remarks to export annotated pages to Markdown, PDF, PNG, or SVG on your computer:

WHAT IS LIFE?

Based on lectures delivered under the auspices of the Dublin Institute for Advanced Studies at Trinity College, Dublin, in February 1943

To the memory of My Parents

Usage and Demo

Run remarks and check out what arguments are available:

python -m pytest -q remarks/test_initial.py

Credits and Acknowledgements

Scrybble A paid user-friendly service that helps non-technical ReMarkable users synchronize their notebooks to Obsidian. Financially supports @Azeirah to work on remarks.
lucasrla who wrote the original implementation of remarks
@JorjMcKie who wrote and maintains the great PyMuPDF
u/stucule who posted to r/RemarkableTablet the first account (that I could find online) about reverse engineering .rm files
@ax3l who wrote lines-are-rusty / lines-are-beautiful and also contributed to reverse engineering of .rm files
@edupont, @Liblor, @florian-wagner, and @jackjackk for their contributions to rM2svg
@ericsfraga, @jmiserez, @peerdavid, @phill777 and @lschwetlick for updating rM2svg to the most recent .rm format
@lschwetlick who wrote rMsync and also two blog posts about reMarkable-related software [1, 2]
@soulisalmed who wrote biff
@benlongo who wrote remarkable-highlights

For more reMarkable resources, check out awesome-reMarkable and remarkablewiki.com.

License

remarks is Free Software distributed under the GNU General Public License v3.0.

Disclaimers

This is a hobby project of an enthusiastic reMarkable user. There is no warranty whatsoever. Use it at your own risk.

The author(s) and contributor(s) are not associated with reMarkable AS, Norway. reMarkable is a registered trademark of reMarkable AS in some countries. Please see https://remarkable.com for their products.