Printr

Little receipts that do you good, every morning.

Site · Blocks · The app · Install

🇫🇷 Version française

Printr turns an Epson TM-T88V receipt printer into a family gadget. You compose a ticket from 40 blocks (weather, horoscope, sudoku, word search, riddles, news, photos…), print it from your phone, schedule it for 7:30 on weekdays, or send a little note with a photo to the people who stayed home. A single Rust binary, running on a Raspberry Pi, that speaks ESC/POS directly to the printer.

• 40 blocks: weather, calendar, horoscope (serious, whimsical, snarky or downright insulting), word of the day, arrow words, sudoku, nonogram, word search, Categories, coloring, riddles with their answer printed upside down, workout challenge, shopping list, bin collection days, guest Wi-Fi, gift coupons, a receipt-style monthly report, news from RSS feeds, photos…
• A web app for the family: accounts, saved and shared tickets, live preview, scheduling in 24-hour format, history.
• Lean: almost everything is computed locally or comes from free APIs that need no key. Claude only writes the horoscope and the word of the day (one small call to Claude Haiku, cached for the day).
• A tidy CLI: preview in the terminal, progress block by block, readable errors.

export PRINTR_LANG=en                                          # English app and tickets (French by default)
cargo run --release -- --preview print examples/complet.json   # preview in the terminal, no printer needed
cargo run --release -- --device /dev/usb/lp0 serve             # interface at http://localhost:8080
scripts/deploy.sh pi@printer.local                             # install on a Raspberry Pi (or --local)

On first launch, the interface asks you to create your account, then the accounts of the family.

No printer yet? scripts/demo.sh prints the full ticket in an emulator and gives you a PNG image of it.

Written every day by Claude, on a theme picked at random. Real excerpts (translated from the French output):

printr print examples/matin.json    # ticket made of blocks (see below)
cat ticket.json | printr print      # same, from standard input
printr --preview print ticket.json  # preview in the terminal, nothing printed
printr --refresh print ticket.json  # regenerates what is cached: sun, horoscopes, word of the day
printr -q print ticket.json         # quiet, only shows errors
printr test                         # test ticket (styles, accents, QR code)
printr text "Hi there!"             # free text, then a cut
echo "from stdin" | printr text     # reads standard input
printr text --no-cut "no cut"
printr image photo.jpg              # image scaled down to 512 px, dithered (Floyd–Steinberg)
printr image --no-dither logo.png   # plain black-and-white threshold, for logos and line drawings

Destination, your choice:

A ticket is a list of blocks. Blocks are built in parallel (network requests included), and each result appears in the CLI as soon as it is ready; the ticket is then printed in the defined order. A block that fails prints an error message instead of blocking the ticket. An unknown parameter is an error, so typos get caught.

{
  "cut": true,
  "spacing": 1,
  "blocks": [
    { "type": "title", "text": "Hello!" },
    { "type": "weather", "location": "Lyon", "days": 3 },
    { "type": "horoscope", "sign": "scorpion", "tone": "farfelu" }
  ]
}

Each block has an example in docs/exemples/: the JSON ticket and its rendering, regenerated by docs/exemples/generer.sh (dummy data). They are all shown as pictures on the blocks page of the website.

Bin collection example, with the yellow bin every other Friday:

{ "type": "poubelles", "collections": [
  { "name": "household waste", "days": ["lundi", "vendredi"] },
  { "name": "yellow bin", "days": ["vendredi"], "every": 2, "from": "2026-10-09" }
] }

The block reads the RSS or Atom feeds you give it, without AI, for free and in under a second. Articles are ranked by:

• the requested themes: found in the title (the strongest match), in the URL's section, in the categories, or in the summary. A theme matches at the start of a word ("climat" finds "climatique"; the feeds are in French, so the example themes are too);
• their position in the feed (the newsroom's front page first);
• cross-coverage: a topic covered by several feeds moves up;
• their freshness (beyond max_age_hours, the article is dropped).

Live streams, videos, podcasts and opinion pieces are dropped, as are articles containing a word from exclude. Two articles on the same subject are never kept together. The first qr articles get a QR code, two per line. PRINTR_DEBUG=1 shows the full ranking.

{ "type": "news", "title": "France",
  "feeds": ["https://www.franceinfo.fr/titres.rss", "https://www.lemonde.fr/rss/une.xml"],
  "themes": ["climat", "sciences", "santé"], "exclude": ["football"] }

The barnum block calls Barnum on the command line: barnum if it is installed, otherwise the command given in PRINTR_BARNUM, for example PRINTR_BARNUM="python3 /opt/barnum/main.py" (Barnum only needs Python 3.10).

Every now and then (one print in twenty), the machine slips a strange message into the ticket, with no header, like printed noise: this is the glitch. PRINTR_GLITCH sets how often it happens (PRINTR_GLITCH=5 for one in five, 0 for never); { "type": "glitch" } forces one. It never appears in previews.

The arrow_word block relies on the CrossWords library (Apache 2.0, © 2026 Pierre, XNinety9; see NOTICE). On first use, it downloads its word list with curl (about thirty seconds, only once) into printr's cache. Definitions come from its cache (crosswords/definitions.txt, or definitions-en.txt in English), completed at print time by Claude for the words it does not know: less than a cent per new grid at levels 1 and 2 (Claude Haiku), about ten cents at levels 3 and 4 (Claude Opus). Previews never call Claude, and a word that Claude could not define is not asked for again: its length is printed instead.

The horoscope and word_of_the_day blocks use the Claude API: set ANTHROPIC_API_KEY (and optionally PRINTR_CLAUDE_MODEL, claude-haiku-5-5 by default).

Date-dependent content is cached: reprinting the same ticket gives the same results, without a new API call. --refresh forces a new generation. The cache lives in ~/.cache/printr (or $PRINTR_CACHE_DIR, or /var/cache/printr with the systemd service). PRINTR_DEBUG=1 shows the raw API responses.

Printr speaks French by default. Setting PRINTR_LANG=en (in /etc/printr.env for the service) switches the whole installation to English: the web interface, the command line, messages and tickets. Blocks with content (riddles, quotes, word searches, workouts, gift coupons…) have their own English list, and Claude writes the horoscope and the word of the day in English.

Arrow words come from CrossWords' English dictionary, with English clues (its definitions-en.txt cache, completed by Claude). The offline Barnum horoscope is written in English too, with Barnum 0.3 or later (an older Barnum prints it in French). Only the name day stays in French, for lack of an English source; public holidays are the French ones, named in English.

printr serve serves a web interface designed for phones as well as computers:

• Compose: add blocks (at the end or between two others), adjust them, and reorder them by dragging their handle, with a live preview of the ticket. Claude blocks (horoscope, word of the day) don't call the API in preview: they only cost something when printed.
• My tickets: saved tickets (presets), printed in one tap, shared with the family, and scheduled (days and time). A missed schedule more than 15 minutes late is not caught up.
• Little note: a photo taken with the phone, a drawing (heart, star…), a few words.
• Shopping: the family's shared list. Everyone adds what is missing, and it gets printed on the way out (then it empties itself). An iOS shortcut can also add items to it with POST /api/shopping and the token.
• History: who printed what, and any errors.

Each family member has their own account. The first one is created from the app's home screen (from the home network); the others from the My account menu, where everyone also changes their own password. The first account is the administrator: only they can delete accounts. From the command line, even while the server is running (it rereads its data):

printr user add Camille       # asks for the password (or reads it from standard input)
printr user passwd Camille
printr user remove Camille
printr user list

Data (accounts, presets, history, photos) lives in $PRINTR_DATA_DIR, otherwise ~/.local/share/printr, or /var/lib/printr with the systemd service. To work on the interface without recompiling: PRINTR_WEB_DIR=web printr serve.

printr serve --listen 0.0.0.0:8080 --token $(openssl rand -hex 24)   # token: optional

For scripts, POST requests require the header Authorization: Bearer <token> (set with --token). Adding ?preview returns the text preview without printing. The response is {"ok": true, "errors": [...]}, where errors lists the blocks that failed. Requests are handled one at a time, so two prints never get mixed up.

curl -X POST http://raspberrypi:8080/print -H "Authorization: Bearer $PRINTR_TOKEN" \
     --data @examples/matin.json

Apple does not offer an API for Reminders, but the Shortcuts app can send the list to the Pi. In a new shortcut:

1. Find Reminders: filter "List is Shopping" (use the name of your own list) and "Is not completed".
2. Combine Text: input = the reminders, separator = "New Line".
3. Get Contents of URL:
   • URL: http://<pi-ip>:8080/todo, method POST;
   • header Authorization = Bearer <token>;
   • JSON body: title (text) = Shopping, text (text) = Combined Text.
4. Optional: Show Notification with the result.

To automate it: Shortcuts > Automation > Time of Day, then "Run Immediately". The phone must be able to reach the Pi (same Wi-Fi, or a VPN such as Tailscale).

The app can be opened to the Internet behind an HTTPS reverse proxy (Caddy, nginx…). It protects itself as follows:

• Accounts: passwords hashed with Argon2 (8 characters minimum), session cookie HttpOnly, SameSite=Lax, and Secure over HTTPS. The first account, the administrator's, can only be created from the local network; only the administrator can delete an account.
• Password attempts: five failures per address within fifteen minutes, then a block; only one check runs at a time, so mass guessing cannot exhaust the memory. Behind the proxy, the client address is read from X-Forwarded-For (last entry).
• Cross-site requests are refused (Origin header), even from a neighboring subdomain.
• Local network out of reach: from the app or a script, blocks (images, RSS feeds, calendars…) only reach public addresses, redirects included, and never read any file on the machine. From the command line, everything stays allowed.
• Abuse: 60 blocks per ticket at most, images decoded with size limits, and PRINTR_MAX_TICKETS_PER_HOUR prints per person per hour (20 by default).
• Service running without privileges, with capped memory and a read-only system (see deploy/printr.service); a content security policy (CSP) on the interface.

Updates: once a day (PRINTR_UPDATE_INTERVAL minutes to change it, 5 minimum), printr checks GitHub to see whether a newer version has been published, and reports it to the administrator ("My account"). Nothing is downloaded or installed on its own: updating stays a human action (scripts/deploy.sh), after reading what's new, so a compromised GitHub account cannot run anything on the machines. PRINTR_UPDATE_CHECK=off turns the check off.

On the machine side, it is still advisable to accept SSH keys only, and to check that your router's IPv6 firewall does not let connections into the local network.

emupos simulates the printer and renders each ticket as a PNG plus text. The emulator/ folder contains a TM-T88V profile (512 dots, 180 dpi).

To generate the full ticket (all the blocks) in one command:

scripts/demo.sh                           Read the rest on GitHub