Один subprocess на колонку
Bridge использует многопроцессный рантайм: главный процесс ведёт Bluetooth, API и UI, а каждая колонка работает в собственном Sendspin-daemon subprocess с отдельной аудио-маршрутизацией.
Sendspin Bluetooth Bridge
Превратите Bluetooth-колонки в плееры Music Assistant — локально, headless и с поддержкой мультирума
Что это такое
Заголовок раздела «Что это такое»Sendspin Bluetooth Bridge превращает Bluetooth-колонки и наушники в нативные плееры Music Assistant, подключая их к протоколу Sendspin в MA.
Каждое настроенное Bluetooth-устройство появляется в Music Assistant как отдельный плеер. Можно оставить всё внутри локальной сети, объединять комнаты в группы, управлять Bluetooth через веб-интерфейс и запускать мост в Home Assistant, Docker, на Raspberry Pi, Proxmox VE или OpenWrt.
Что важно в текущей релизной линии
Заголовок раздела «Что важно в текущей релизной линии»Гибкое планирование портов
Глобальные override-параметры WEB_PORT и BASE_LISTEN_PORT упрощают запуск нескольких bridge-инстансов или параллельных треков аддона HA на одном хосте.
Переопределения на уровне устройства
Для сложных сетевых схем можно закрепить плеер за собственным listen_port и задать рекламируемый адрес через listen_host.
Треки аддона HA
Stable, RC и beta аддоны используют разные ingress-порты и диапазоны player-port, поэтому их проще различать и безопаснее тестировать параллельно.
Переподключение и диагностика
D-Bus-детекция отключений, резервный polling, runtime diagnostics и SSE-обновления упрощают headless-развёртывания.
Веб-интерфейс и API
Через панель можно выполнять pairing, смотреть диагностику и логи, проверять обновления, делать backup/restore конфига и связывать bridge с Music Assistant; всё это доступно и через REST API.
Варианты развёртывания
Заголовок раздела «Варианты развёртывания»| Home Assistant Addon | Docker / Raspberry Pi | Proxmox / OpenWrt LXC | |
|---|---|---|---|
| Установка | Магазин аддонов | docker compose up -d | Скрипт на хосте |
| Веб-интерфейс | HA Ingress (порт назначается Supervisor динамически); поле web_port в аддоне игнорируется | Прямой WEB_PORT listener (по умолчанию 8080) | Прямой WEB_PORT listener (по умолчанию 8080) |
| Порты плееров | Channel default BASE_LISTEN_PORT (8928+, 9028+, 9128+) | BASE_LISTEN_PORT (по умолчанию 8928+) | BASE_LISTEN_PORT (по умолчанию 8928+) |
| Bluetooth stack | bluetoothd хоста через Supervisor/runtime mounts | bluetoothd хоста через D-Bus | bluetoothd хоста через D-Bus bridge |
| Аудио | Аудиомост HA | PulseAudio / PipeWire хоста | PulseAudio внутри контейнера |
| Для кого | Пользователи HAOS / Supervised | Обычные Linux-хосты и Raspberry Pi | Proxmox VE, роутеры, appliance-сценарии |
Развёртывание нескольких bridge
Заголовок раздела «Развёртывание нескольких bridge»Запустите несколько bridge-инстансов против одного сервера Music Assistant, чтобы покрыть все комнаты — каждый bridge обслуживает колонки в своей Bluetooth-зоне.
С чего начать
Заголовок раздела «С чего начать» Установить в Home Assistant Stable, RC и beta tracks, поведение ingress и direct listener
Установить через Docker Универсальная установка на Linux-хост с override-параметрами WEB_PORT и BASE_LISTEN_PORT
Установить на Raspberry Pi Docker-гайд для Pi, pre-flight check и one-liner installer
Установить в Proxmox / OpenWrt LXC Нативное LXC-развёртывание с использованием Bluetooth-стека хоста через D-Bus
Конфигурация Настройки bridge, поля устройств, адаптеры, auth и логика обновлений
Архитектура Модель процессов, IPC, маршрутизация аудио, lifecycle Bluetooth и HA ingress
API Reference REST-эндпоинты для статуса, диагностики, Bluetooth, Music Assistant и обновлений
История релизов Актуальные release notes, включая изменения v2.40.5 по портам и HA-track