explaingit

chrisgscott/share-to-remarkable

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A self-hosted service plus iOS Shortcut that sends any web page from your iPhone to a reMarkable tablet as a clean, readable PDF.

Mindmap

mindmap
  root((repo))
    What it does
      Send web pages to reMarkable
      Clean PDF conversion
      iOS Share Sheet integration
    Tech stack
      TypeScript
      Node.js
      Docker
      WeasyPrint
    Use cases
      Read later on e-ink
      Ad-free articles
      Personal read pipeline
    Audience
      reMarkable owners
      Self-hosters
      iOS users
    Setup
      Docker VPS
      Device token
      iOS Shortcut

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Send articles and web pages from your iPhone directly to your reMarkable tablet as clean PDFs.

USE CASE 2

Read distraction-free, reformatted web content on an e-ink screen without desktop-only browser extensions.

USE CASE 3

Build a personal read-later pipeline that strips ads and navigation before sending to your tablet.

What is it built with?

TypeScriptNode.jsDockerWeasyPrintReadability

How does it compare?

chrisgscott/share-to-remarkable4ssh1/mine-sweeperachawla19/intuitcode-extension
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-01-31
MaintenanceMaintained
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a Docker-capable VPS, a reMarkable account, and building an iOS Shortcut.

MIT license: free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Share-to-remarkable lets you send any web page from your iPhone to a reMarkable tablet as a clean, readable PDF. You tap Share in Safari or Chrome on iOS, and a few seconds later the article shows up on your tablet, formatted for reading rather than showing the original page layout with ads and navigation menus. The reMarkable browser extension already does this on desktop computers, but iOS does not allow browser extensions, so there was no equivalent for phones and tablets. This project fills that gap with a small self-hosted service paired with an iOS Shortcut. When you share a link, the Shortcut sends the URL to the service, which fetches the page, strips out ads and navigation using Mozilla's Readability library, the same one used in Firefox Reader View, converts the clean article into a PDF tuned for e-ink displays using WeasyPrint, and uploads it to your reMarkable Cloud account. Setting this up requires a reMarkable account, a server capable of running Docker (any basic VPS works, since the project bundles Node and WeasyPrint into the container), and an iPhone or iPad to build the Shortcut. The setup involves registering a device token with reMarkable, generating a shared secret to protect the service since it sits on the public internet, running the container, and then building the iOS Shortcut following the included instructions. The project is honest about its limits. Pages that render their content entirely through JavaScript may come back empty, since Readability cannot process them without a real browser. Some layouts confuse Readability into grabbing the wrong section of a page. A few news sites block server-side requests outright. The README also points out a simpler, no-server alternative that many people may prefer: converting the page to a PDF on-device and importing it directly into the reMarkable app. That method is simpler and does not depend on reMarkable's unofficial cloud API, but it preserves the page's full layout rather than reformatting it as a clean article. This project exists specifically for people who want the reformatted, e-ink-friendly version. It is licensed under MIT.

Copy-paste prompts

Prompt 1
Help me deploy this share-to-remarkable Docker container to a VPS with Coolify and set up HTTPS.
Prompt 2
Walk me through registering a reMarkable device token and generating a SHARE_SECRET for this service.
Prompt 3
Show me how to build the iOS Shortcut described in docs/ios-shortcut.md for this project.
Prompt 4
Explain how I could add a headless-Chromium fallback to src/extract.ts for JavaScript-heavy pages.

Frequently asked questions

What is share-to-remarkable?

A self-hosted service plus iOS Shortcut that sends any web page from your iPhone to a reMarkable tablet as a clean, readable PDF.

What language is share-to-remarkable written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Docker.

What license does share-to-remarkable use?

MIT license: free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is share-to-remarkable to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is share-to-remarkable for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.