rmdocs

A cli tool to convert .rm, .rmdoc and the xochitl folder of the reMarkable 2 to PDFs. It aims to reproduce reMarkable 2 output as faithfully as possible.

[!IMPORTANT] It is only compatible with .rm version 6. See below

[!CAUTION] I still consider this in early development.

Usage

  • Convert a single .rm file using rmdocs my_page.rm [destination folder]. [destination folder] defaults to current folder.
  • Convert a single .rmdoc file using rmdocs my_document.rmdoc [destination folder]. [destination folder] defaults to current folder.
  • Convert a folder containing a collection of .rm or .rmdoc (can't be mixed) using rmdocs [source folder] [destination folder]. [destination folder] is required.
  • Convert the xochitl folder at /home/root/.local/share/remarkable/xochitl/ on the remarkable using rmdocs [source folder] [destination folder]. [destination folder] is required.

If you have compatibility or assertions issues, please refer to below.

Installation

  1. Install pipx
  2. Install libcairo2. For instance, on debian based system use apt install libcairo2.
  3. Install rmdocs via pipx install rmdocs

[!NOTE]
Alternatively, you can use regular venv.

Compatibility

This software is only compatible with page version 6, and I do not plan on making it support other page version. For non-compatible pages a warning text will be shown instead of your strokes. Going to each of these pages individually and drawing (even if removing afterward) makes the reMarkable updates the page to v6.

Additionally, as there is no official API for reMarkable file structure, many assertion are made based on the files available while developing this software. The output of the software will show them as AssertionException. Please consider opening an issue when you have such errors.

Acknowledgment, contributions and license

This uses rmscene, and part of svg creation is based of rmc.

This software is mainly released under the MIT license. Certains files (from rmc) regarding the svg creation are under LGPL.

Contributions are welcomed :).

Project links

Data verified by PyPI on Jun 21, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Seb-sti1 from gravatar.com Seb-sti1

Credits

Author: Seb-sti1

GitHub Statistics

Data verified by PyPI on Jun 21, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rmdocs-3.5.3.tar.gz (20.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rmdocs-3.5.3-py3-none-any.whl (20.2 kB view details)

Uploaded Python 3

File details

Details for the file rmdocs-3.5.3.tar.gz.

File metadata

  • Download URL: rmdocs-3.5.3.tar.gz
  • Upload date:
  • Size: 20.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rmdocs-3.5.3.tar.gz
Algorithm Hash digest
SHA256 87ed07cf252359848443b5c5b804fbf2286784e29dce7a557d3e2d300e681b89
MD5 94ab0e88c5af5d90716de311415e2e4c
BLAKE2b-256 59cab3571bed5b1931615edc03b5262cab869df0be71adc990541c60a299a201

See more details on using hashes here.

Provenance

The following attestation bundles were made for rmdocs-3.5.3.tar.gz:

Publisher: release.yml on Seb-sti1/rmdocs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rmdocs-3.5.3-py3-none-any.whl.

File metadata

  • Download URL: rmdocs-3.5.3-py3-none-any.whl
  • Upload date:
  • Size: 20.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rmdocs-3.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5cd08a1d491fdd2cc00d370545a8ae37fbf79e09b1ba54e0cf0082e599d0ed39
MD5 faef6161c2d4135e16d009d7734141db
BLAKE2b-256 38aaea1fbfe9bd2f940b91361cb62795f0909f039e3c4c2353df8d7e8fae652f

See more details on using hashes here.

Provenance

The following attestation bundles were made for rmdocs-3.5.3-py3-none-any.whl:

Publisher: release.yml on Seb-sti1/rmdocs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page