Say it your way.
Type any announcement for local Piper speech, or upload MP3, WAV, M4A, AAC, FLAC, or OGG.
Open source · Self-hosted · Local-first
PostPush.
PostPush.
New mail.
Every room.
Turn a mailbox sensor event into a spoken message or custom sound on selected HomePods and AirPlay speakers — synchronized, configurable, and entirely under your control.
MQTT EVENTMail detected
AIRPLAYPlaying on 5 speakers
BUILT FOR YOUR HOME
A smarter way to hear the mailbox.
Everything needed for a personal, reliable mailbox announcement — without sending text, audio, or settings to another service.
Every room, in sync.
Choose individual HomePods, AirPlay speakers, and compatible Sonos devices — or include every new speaker automatically.
Fine-tuned for real life.
Set the volume, active hours, and cooldown, then test the complete flow directly from the browser.
Local by design.
Speech, audio, and configuration stay on your server. The project website uses no analytics, cookies, or trackers either.
Running at homeONE EVENT. THREE STEPS.
From the mailbox to every room.
PostPush connects the services already running at home and keeps the complete flow inside the local network.
The sensor detects mail
Home Assistant publishes a non-retained event to the configured MQTT topic.
PostPush prepares the message
It checks the schedule and cooldown, then uses local speech or the uploaded audio file.
OwnTone plays in sync
The announcement plays across the selected AirPlay speakers at the configured volume.
SIMPLE ON THE SURFACE
Everything in one calm, clear dashboard.
See MQTT, AirPlay, and audio health at a glance, choose exactly where the message should play, and review the latest mailbox event.
- Live MQTT, AirPlay, and audio status
- Speaker selection, volume, and cooldown
- Text-to-speech, uploads, and active hours
READY WHEN YOU ARE
Choose an installation path.
Use the guided Runtipi experience or run the same container with Docker Compose. Both keep everything on your server.
Before you start
- Home Assistant with a mailbox sensor
- An MQTT broker reachable by both services
- HomePods and server on the same network
- DoorBell app on the same host for Runtipi installs
Recommended for the easiest setup
Open Runtipi guide
- Install Ring HomePod Doorbell for its shared OwnTone service.
- Open Settings → App Stores in Runtipi.
- Add the repository below as a custom app store.
- Install PostPush and configure MQTT.
https://github.com/alexholzreiter/postpush
For any Docker host
Open Docker guide
- Clone the repository onto your server.
- Create and configure your .env file.
- Start the stack with Docker Compose.
git clone https://github.com/alexholzreiter/postpush.git
cd postpush
cp .env.example .env
docker compose up -dLOCAL-FIRST, FOR REAL
Smart-home data stays at home.
PostPush runs on hardware you control. Piper creates speech locally, and MQTT events, audio files, and settings never pass through our servers.
No cloud TTSNo analyticsNo advertising
GOOD TO KNOW
Questions, answered.
The practical details before mailbox announcements arrive in every room.
Does it work with HomePod mini?
Yes. OwnTone discovers HomePod and HomePod mini models as AirPlay 2 outputs. They must be reachable from the server on the same network or through correctly routed mDNS.
Can I choose individual speakers?
Yes. Select any combination of discovered AirPlay speakers or automatically include every available output. Volume is configurable as well.
Can it speak my own text?
Yes. PostPush generates the configured announcement locally with Piper, or it can play an uploaded MP3, WAV, M4A, AAC, FLAC, or OGG file.
How does Home Assistant trigger PostPush?
A Home Assistant automation publishes a non-retained message to the configured MQTT topic when the mailbox sensor detects mail.
Does the announcement leave my network?
No. Piper creates speech locally, settings stay on the server, and OwnTone sends audio directly to speakers on the home network.
LET THE MAILBOX SPEAK
Hear about new mail in every room.
Free, open source, and ready for your Runtipi or Docker server.