NewspaSync
A personal morning newspaper, printed to a reMarkable every day.
Snapshot
- Status
- Active
- Reads on
- reMarkable · any email inbox
- Distribution
- Docker image on GHCR · Unraid template
- Built with
- Python · FastAPI · JinjaWeasyPrint · APSchedulerrmapi · IMAP/SMTPDocker · GitHub Actions
How it works
It runs as a single Docker container on a home server, with a browser interface for managing feeds, editions, courses and settings. Every source can be switched off, and any source that fails shows a short note in its section instead of breaking the whole issue.
Gather
At a set time each morning, the app pulls from every source that edition has switched on: news feeds, the weather, tasks, email, puzzles, lessons and the output of shell commands.
Typeset
Everything is laid out as a newspaper PDF in columns, at A5 to match the reMarkable's screen or at A4, with the theme, font size and number of columns set per edition.
Deliver
Today's issue is uploaded to the reMarkable, yesterday's moves to an archive folder, and old issues are cleared out. An edition can also be emailed, or sent to both.
Highlights
- Editions: several named newspapers, each with its own schedule, sources, look and delivery. Schedules can be changed from the web UI without a restart.
- Learning feeds deliver an uploaded course one lesson a day. A lesson only counts as delivered once the PDF has been built, so a reMarkable outage never skips one.
- A job-search section collects listings from Seek, university Workday sites and RSS feeds, drops any already seen, scores the rest against your criteria, and prints only new ones that score well enough.
- Shell snippets put the output of any command in the paper, such as disk space or uptime. A Test button runs the command in the container first, since a command that works on the host may fail inside Docker.
- Snippets have guardrails: a blocklist for destructive commands, a time limit on each one, colour codes stripped out, and output cut off at a fixed length so one command can't take over the page.
- Optional article summaries work with any OpenAI-compatible service, including a local Ollama, so nothing has to leave the house.
- Installed as a one-click Unraid template. Settings are edited in the browser, and every push to main publishes a new image to GHCR. Config, PDFs and the reMarkable login live on mounted volumes, so updates never touch them.