tomkainz/sonos-bridge

Sonos Bridge turns an ordinary Linux computer into a Bluetooth speaker that plays sound through a Sonos speaker. The setup works like this: your phone connects over Bluetooth to a Linux machine, that machine turns the audio into a network stream, and a Sonos speaker pulls that stream and plays it. You control everything from a self hosted web dashboard that shows both the Sonos player and the Bluetooth pairing status, and it works even with older Sonos models that have no Bluetooth or AirPlay built in. The Linux machine can be almost anything you already own and leave running: a home server, a NAS, a mini PC, an old laptop or desktop, a virtual machine, or a small board like a Raspberry Pi. It just needs a Bluetooth adapter that supports receiving audio, and a network connection to the same Wi-Fi as your Sonos speaker. Windows PCs and phones can still use the dashboard fine since that part is just a website, but the bridge software itself has to run on Linux. Getting started is meant to be simple: you clone the project and run a single guided install script that asks a few questions, like which Sonos room to use, and sets everything up. Once done, the installer prints a web address you open on your phone to reach the dashboard, and on Android it can be added to the home screen so it behaves like an app. Under the hood, the audio path runs through several small services managed by systemd: one that receives the Bluetooth stream, one that converts it into an MP3 stream using ffmpeg, one that keeps the phone's volume in sync with the Sonos speaker, one that handles secure pairing with a confirmation code, and the web dashboard itself, written in Python. Configuration such as the host's IP address, the Sonos room name, and network ports is stored in environment variables that the installer sets up automatically. Bluetooth audio streaming works today, and the project has AirPlay support and possible Google Cast support planned for the future.