zeigerpuppy / zotero-remarkable

Sync papers from Zotero to a reMarkable tablet

Zotero reMarkable sync

This uses the reverse engineered ReMarkable API library to automatically transfer files from a Zotero collection to a reMarkable folder. When files have been uploaded, they are then removed from the Zotero collection. Run this script periodically to continually transfer uploaded files.

Currently, the environment variables in the table below must be defined. You can use a .env file or define them any other way you choose.

Name	Description
ZOTERO_USER	Zotero user ID
ZOTERO_API_KEY	Zotero API key
ZOTERO_COLLECTION	Collection key to use in Zotero
WEBDAV_URL	URL of the WebDAV server hosting your Zotero files
WEBDAV_AUTH	username:password for WebDAV authentication
REMARKABLE_TOKEN	reMarkable API token
REMARKABLE_FOLDER	reMarkable destination folder (default /Zotero)

Zotero user ID and API key can be found on the settings page. The Zotero collection key can be found as the last component in the URL path when browsing on the Web interface. For example in the URL below, the collection key is ABCDEFG.

https://www.zotero.org/michaelmior/items/collectionKey/ABCDEFG

The reMarkable API token is generated by ReMarkable API. You will need a one-time code generated from reMarkable. With the code, run remarkable.php register YOUR_CODE_HERE. This will generate a file auth.token which contains the key.