โ† Back to DevOps & Cloud
DevOps & Cloud by @nickian

remarkable

Send files and web articles to a reMarkable e-ink tablet

0
Source Code

reMarkable Cloud

Send documents and web articles to a reMarkable tablet via the cloud API. Uses rmapi for cloud access.

Setup

Install rmapi (Go required):

cd /tmp && git clone --depth 1 https://github.com/ddvk/rmapi.git
cd rmapi && go build -o /usr/local/bin/rmapi .

First run will prompt for a one-time code from https://my.remarkable.com/device/browser?showOtp=true

Python dependencies (for article conversion): readability-lxml, ebooklib, requests, beautifulsoup4, lxml.

Commands

Send a web article to the device

{baseDir}/scripts/remarkable.sh send-article --url "https://example.com/article" --dir /Articles
{baseDir}/scripts/remarkable.sh send-article --url "https://example.com/article" --format pdf --dir /
{baseDir}/scripts/remarkable.sh send-article --url "https://example.com/article" --title "Custom Title" --dir /Articles

Fetches article, extracts readable content, converts to EPUB (default) or PDF, uploads to reMarkable cloud. Device syncs automatically.

List files

{baseDir}/scripts/remarkable.sh ls /
{baseDir}/scripts/remarkable.sh ls /Articles
{baseDir}/scripts/remarkable.sh ls "/Book Notes"

Output: [f] = file, [d] = directory.

Upload a file

{baseDir}/scripts/remarkable.sh upload --file /path/to/document.pdf --dir /Books
{baseDir}/scripts/remarkable.sh upload --file /path/to/book.epub --dir /

Create a folder

{baseDir}/scripts/remarkable.sh mkdir --path /NewFolder

Search for files

{baseDir}/scripts/remarkable.sh find --name "article title"

Notes

  • EPUB is recommended for articles โ€” reflows nicely on e-ink
  • Device syncs automatically when connected to WiFi
  • Auth tokens are cached by rmapi at ~/.rmapi
  • Some sites block scraping โ€” if article fetch fails, try a different URL