EWASHINGTON
Projects

NewspaSync

A personal morning newspaper, printed to a reMarkable every day.

reMarkableSelf-hosted Public repository

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
Overview

NewspaSync puts together a daily newspaper from the things people usually check on a phone first thing: the news, the weather, today's tasks, unread email, a puzzle and a short lesson. It lays them out as a PDF and puts it on a reMarkable before the day starts. The morning read happens on e-ink instead of a feed that keeps going, and the paper is finished when you reach the last page.

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.

RSS feedsWeatherWikipedia & WikiquoteWord of the dayTickTick tasksUnread emailSudokuJob listingsDaily lessonsShell outputAI summaries

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.