eddwills95/protect-sonos-doorbell

This project turns a Raspberry Pi Zero into a smart doorbell and gate opener that connects two separate home systems: UniFi Protect (a security camera and doorbell platform) and Sonos wireless speakers. The setup does two main things. First, a physical push button wired to the Raspberry Pi can unlock a gate. When pressed, the Pi sends a signal to UniFi Protect's automation system, which triggers the gate lock. Second, when someone rings a UniFi Protect video doorbell, that event triggers a notification to the Pi, which then pauses any music playing on your Sonos speakers, plays a doorbell chime sound, and restores the music exactly where it left off, at the same volume and playback position. A small web interface lets you control the system from a browser on your local network. You can pick which Sonos speakers should play the chime, adjust the volume and number of repeats, set quiet hours when the chime stays silent, and upload a custom chime sound. There is also a button to open the gate remotely. A live log page shows what the service is doing in real time. The setup requires a UniFi Protect console with its Alarm Manager feature configured, at least one Sonos speaker on the same network, and a momentary push button wired to the Pi's GPIO pins. The code communicates with Sonos speakers directly using their built-in network protocol, avoiding external libraries that are slow or difficult to install on the Pi Zero's limited hardware. Configuration is done through a simple environment file where you specify the webhook URLs, API keys, speaker IP addresses, and chime settings. The project runs as two background services on the Pi: one watches the physical button, the other handles the web server that receives doorbell notifications and serves the settings page. One practical note from the documentation: if the settings page or doorbell feels slow or stuck, a configured Sonos speaker is probably offline, and the system has to wait for the connection to time out before continuing.