Skip to content
HostisHumaniPublic

About

A modular ESC/POS printing platform with a modern web interface.

Topics

Resources

Stars

19 stars

Watchers

0 watching

Forks

Latest commit

 

History

112 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ReceiptPi Logo

License Status Python Platform Last Commit

Features • Quick Start • Documentation • Issues

ReceiptPi

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.

Home page Shopping list Design settings

Features

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

Quick start

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.sh

Then open http://<hostname>:5000 and create the admin account.

Documentation

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.

Roadmap

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.

Contributing

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).

Trademark Notice

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.

Third-Party Licenses

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.

License

MIT - see LICENSE.

About

A modular ESC/POS printing platform with a modern web interface.

Topics

Resources

Stars

19 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages