remarkable

name	remarkable
description	Send files and web articles to a reMarkable e-ink tablet via the reMarkable Cloud. Upload PDFs, EPUBs, or convert web articles to readable ebooks and send them to the device. Also browse and manage files on the device. Use when the user mentions reMarkable, wants to send an article or document to their e-reader, or manage reMarkable cloud files.

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