Features • Quick Start • Documentation • Issues
Deutsche Version / German version
ReceiptPi turns a Raspberry Pi and a receipt printer into a small household printer: shopping lists, to-dos, notes, weather reports, guest Wi-Fi slips and more, printed from your phone or automatically from Home Assistant and other systems. Everything runs on the Raspberry Pi in your home network.
| Lists | Shopping lists, to-do lists and task cards to tick off with a pen |
| Message | Print any text |
| Image | Photos and pictures in black and white: turn and crop them, add a message, preview the print |
| Weather | Weather reports (DWD or Open-Meteo) and automatic storm warnings |
| Recipes | Search and print recipes from Mealie, import its shopping lists |
| Guest Wi-Fi | A slip with name, password and QR code as soon as the FRITZ!Box guest network is on |
| System report | The state of your servers (Proxmox, PBS, any host via SSH) |
| Games | Sudoku, dice score sheets and tic-tac-toe boards |
| Print rules | Quiet hours, print limit, duplicate suppression, large text (Easy-Read) |
| History and pending jobs | Everything printed, and nothing lost: held-back prints wait until you print them |
| Accounts | Login, admins and users, each with their own drafts, history and settings |
| Design | 6 color themes with an optional glass look, German and English |
| Automation API, MQTT, Home Assistant | Print from scripts, Node-RED, n8n or Home Assistant |
| Backup | Save and restore settings and logos, without passwords |
On a Raspberry Pi with Raspberry Pi OS Lite (64-bit, trixie) and an Epson TM-T88V on USB:
sudo apt install git
git clone https://github.com/HostisHumani/ReceiptPi.git
cd ReceiptPi
sudo ./deploy/install.shThen open http://<hostname>:5000 and create the admin account.
- Installation: details, printer, watchers, troubleshooting
- First steps: from the first start to the first print
The documentation explains every feature step by step, with screenshots, in English and German: what it does, how to use it, and what to do if it doesn't work. For developers there is the developer reference.
Next up: NFC-tag-triggered printing (just a URL in the tag, no app needed), Tandoor as a second recipe manager next to Mealie, and a proper icon set replacing the interim home-screen icons. The roadmap may change as ReceiptPi is tested on more hardware.
Issues and pull requests are welcome. New modules should use Flask Blueprints, submit print jobs through the central queue and avoid direct writes to the printer or settings files. The developer reference explains the structure, the endpoints and how things work inside. A change to a feature updates its page in docs/ in both languages, see the style guide.
Every push and pull request to main runs Ruff and a Python syntax check
(.github/workflows/ci.yml) as well as CodeQL for Python and JavaScript
(.github/workflows/codeql.yml, also weekly).
Raspberry Pi is a trademark of Raspberry Pi Ltd. This project is not affiliated with, endorsed by, or sponsored by Raspberry Pi Ltd.
Epson and TM-T88V are trademarks of Seiko Epson Corporation. This project is not affiliated with, endorsed by, or sponsored by Epson.
ReceiptPi is an independent, community-built project designed to run on Raspberry Pi hardware and to be compatible with Epson ESC/POS thermal printers.
The web UI's icons are from Lucide (static/icons/),
used under the ISC License - see static/icons/LICENSE
for the full text.
The web UI's typefaces are IBM Plex Sans and IBM Plex Mono
(static/fonts/), self-hosted rather than loaded from Google Fonts, used
under the SIL Open Font License 1.1 - see
static/fonts/LICENSE.txt for the full text.
MIT - see LICENSE.



