Skip to main content
100%

Gist e2d5c944bbd632e3ae0530e602977f45

✓ Published0🌍 Public
UUtopiah
Last edited Dec 3, 2021
Created on Oct 26, 2020

This visualization demonstrates a shell-based toolkit for managing a reMarkable tablet’s document library, showing how to query, sync, and convert PDF and EPUB files via command-line functions. It uses `grep`, `sed`, `jq`, and `qrencode` to extract metadata like bookmarked pages and last-read positions, then generates QR codes or PDF summaries with ImageMagick’s `convert`. The code also synchronizes reading progress across two devices using `scp` and `ssh`, restarting the `xochitl` service to trigger file detection. Data originates from the tablet’s local JSON metadata and content files under `~/.local/share/remarkable/xochitl/`.

AI-generated description

Similar vizzes

Loading thumbnail…

Gist d26e178be3840d0d68cead166eb45a18

This example shows a shell script that synchronizes PDF and EPUB files from a Nextcloud instance to a reMarkable tablet, automatically adding the necessary metadata and content files so the documents appear in the tablet’s library. The script uses `rsync` to transfer files, `mount.davfs` to access the Nextcloud WebDAV endpoint, and custom helper functions to generate `.metadata` and `.content` JSON files for each new document. It also tracks newly added files in `/tmp/newfilesaddedduringsync` and optionally restarts the `xochitl` service if a configuration file requests it.

UUtopiah
77% match
Loading thumbnail…

Gist a3437be5adb89eae6d56a2565ad9ad51

This shell script demonstrates how to insert a blank page into a reMarkable tablet PDF file, using the `qpdf` command to split and reassemble pages and `jq` to manipulate the tablet’s JSON metadata. It locates the insertion point from a page title, renumbers all subsequent PDF pages, and shifts the corresponding `.rm` annotation and highlight files to new UUIDs based on the updated `.content` page array. The script relies on `xochitl-data` file paths and handles page-count calculations via `jq`.

UUtopiah
76% match
Loading thumbnail…

Gist 80a7dc5935d9fb21b1c12d26bdc8ef5d

This example shows a Telegram bot that lets users send documents, photos, or URLs to a reMarkable tablet, automatically adding them as readable files. The bot uses `node-telegram-bot-api` with polling to listen for commands and messages, while `child_process.execSync` runs shell commands like `wget` to download content and `adddoc` to insert files into the tablet’s storage. It distinguishes between PDF/EPUB links and other URLs, generating a minimal ePub from a template when needed, then restarts the `xochitl` service to refresh the device’s library.

UUtopiah
75% match
Loading thumbnail…

Gist 6ec7169c37cdd07ba6003e3004741d6d

This example demonstrates a workflow for sending academic PDFs to a reMarkable tablet directly from a DOI reference on a webpage. It shows how a DOI retrieved from a hovered reference is used to fetch and download the corresponding PDF, then transfer it to the device via SSH. The code uses Express with CORS to handle HTTP requests, `execSync` for shell commands like `curl` and `wget`, and `scp` for file transfer. The visualization aspect is minimal, focusing on the automated pipeline rather than graphical output.

UUtopiah
74% match
Loading thumbnail…

Gist 1c748c68adc016993b3c95f83dca603e

This shell script demonstrates a workflow for syncing highlights from a reMarkable tablet to the Readwise API. It iterates through directories containing highlight files, extracts the document title from accompanying metadata, and processes JSON highlight data using `jq`. The script filters out empty highlights, constructs JSON payloads with the text, title, and author, then sends them via `curl` POST requests to `https://readwise.io/api/v2/highlights/` with an authorization token. The output is a series of API calls that populate a Readwise library with annotated passages.

UUtopiah
74% match
Loading thumbnail…

On device offline dictionary for reMarkable

This script generates an offline dictionary ePub for the reMarkable tablet, converting highlighted words into a reference document. It first extracts single-word highlights from existing ePub files using `grep` and `sed`, then queries the wordset-dictionary JSON files via `jq` to fetch definitions. New definitions are appended to an HTML content file, wrapped in the epubTemplate structure, and compressed into a new ePub using `7z`. The result is automatically copied into the xochitl data directory, with metadata and content JSON created via shell commands, and the xochitl service restarted to load the updated dictionary.

UUtopiah
69% match
Loading thumbnail…

Gist 51d73414b163626dccd6ae63005f03dc

This example demonstrates a web server that forwards a PDF from a URL directly to a reMarkable tablet. It shows how an HTTP request containing a `pdf` query parameter triggers a download and upload cycle, ultimately returning the uploaded document’s ID as JSON. The code uses Express with CORS for the server, Node’s `https` module for fetching the remote PDF, and the `remarkable-typescript` library to authenticate via a device token and upload the file. The visualization’s behavior is purely functional, with no graphical rendering involved.

UUtopiah
68% match
Loading thumbnail…

Title of the document

This shell script generates a minimal EPUB 3 template structure for creating e-books on a reMarkable tablet. It creates the required META-INF directory with a container.xml file, the OEBPS directory containing cover, content, and table-of-contents XHTML pages, plus a content.opf package manifest and a mimetype file. The script uses standard Bash echo commands to write each XML and XHTML file, producing a valid, ready-to-fill EPUB skeleton.

UUtopiah
65% match