Xochitl

The main application on reMarkable paper tablets is called Xochitl. It shows the login screen (if enabled) and contains settings, document management and the document viewer and editor.

Xochitl is proprietary software, meaning it’s source code is not made available.

Since there is a lot of development taking place, there are no guarantees for compatibility between versions of Xochitl.

Running Xochitl

Xochitl is started by systemd when the paper tablet starts. It can be stopped using systemd:

systemctl stop xochitl

And started again:

systemctl start xochitl

⚠️ Note that Xochitl is required on startup when the device is encrypted, e.g. on reMarkable Paper Pro.

The reMarkable cloud synchronization service is called rm-sync. It sends and receives documents to and from the reMarkable cloud as part of reMarkable’s Connect service.

rm-sync will automatically start/stop together with xochitl when run through systemd.

Settings

Xochitl stores its settings in:

/home/root/.config/remarkable/xochitl.conf

The actual settings available will change between versions.

Documents

reMarkable documents are stored in:

/home/root/.local/share/remarkable/xochitl

It is possible to copy this directory, but note that Xochitl should not be running when accessing and/or changing the stored documents.

A document consists of several files. All files belonging to a document start with the same (randomly generated) Universally Unique Identifier (UUID), or are placed in a sub-directory which has the UUID as name. Each page (containing handwriting and/or text) is stored as a binary file with its own UUID inside the document folder.

Some documents are based on PDF or ePub files. These will additionally have the original PDF/ePub stored as {UUID}.pdf or {UUID}.epub.

Disclaimer

Please note that you will be solely responsible for any changes or modifications you make to our software, including by using Developer Mode. We reserve the right to not provide support to software that has been subject to such changes or modifications. Errors or defects resulting from changes or modifications made by you will not be covered by our Limited Warranty or Protection Plan, or any legal warranty you might have (to the extent permitted under applicable law). reMarkable disclaims all liability in that regard.