A Python package for interacting with the Remarkable Cloud API.

Specifically targeting my personal needs for projects such as

• @j6k4m8/Goosepaper — daily newspaper / RSS or feed syndicator that generates a document for the reMarkable
• @j6k4m8/remarkabib — reference and bibliography management with the reMarkable
• @j6k4m8/epistolary — an email client that lets you hand-write replies on the reMarkable

But if you have use-cases, let's support them!

As far as I can tell, all the major players in the reMarkable client SDK space are pretty much defunct.

• @subutux/rmapy is archived because of the moving target of the reMarkable API.
• @splitbrain/reMarkableAPI no longer appears to work.
• @juruen/rmapi, which was the de facto standard for a while, is also archived as of July 2024.

This sucks. reMarkable seems to be deliberately avoiding all of the excited developer momentum behind these projects and is instead making fiddly tweaks that break compatibility every few months. It bums me out.

This is my attempt to make a simple, easy-to-use Python package for interacting with the reMarkable Cloud API. Contributions are VERY welcome.

• Base authentication (#1)
• List documents (#1)

• Download documents by ID
• Download PDFs of documents with annotations included
• Upload documents (PDFs, EPUBs, etc.)
• Delete documents by ID
• Create folders
• List folders
• Delete folders by ID
• Move documents between folders
• Rename documents
• Rename folders
• Syncing to a local directory
• Syncing from a local directory
• Device registration from a short code