Перейти к содержимому

Sendspin Bluetooth Bridge

Превратите Bluetooth-колонки в плееры Music Assistant — локально, headless и с поддержкой мультирума

import { Aside } from ‘@astrojs/starlight/components’;

Инфографика Sendspin Bluetooth Bridge — возможности, архитектура и варианты развёртывания

Sendspin Bluetooth Bridge превращает Bluetooth-колонки и наушники в нативные плееры Music Assistant, подключая их к протоколу Sendspin в MA.

Каждое настроенное Bluetooth-устройство появляется в Music Assistant как отдельный плеер. Можно оставить всё внутри локальной сети, объединять комнаты в группы, управлять Bluetooth через веб-интерфейс и запускать мост в Home Assistant, Docker, на Raspberry Pi, Proxmox VE или OpenWrt.

Веб-панель управления с несколькими Bluetooth-колонками и живыми статусами воспроизведения

Bridge использует многопроцессный рантайм: главный процесс ведёт Bluetooth, API и UI, а каждая колонка работает в собственном Sendspin-daemon subprocess с отдельной аудио-маршрутизацией. Глобальные override-параметры WEB_PORT и BASE_LISTEN_PORT упрощают запуск нескольких bridge-инстансов или параллельных треков аддона HA на одном хосте. Для сложных сетевых схем можно закрепить плеер за собственным listen_port и задать рекламируемый адрес через listen_host. Stable, RC и beta аддоны используют разные ingress-порты и диапазоны player-port, поэтому их проще различать и безопаснее тестировать параллельно. D-Bus-детекция отключений, резервный polling, runtime diagnostics и SSE-обновления упрощают headless-развёртывания. Через панель можно выполнять pairing, смотреть диагностику и логи, проверять обновления, делать backup/restore конфига и связывать bridge с Music Assistant; всё это доступно и через REST API.
Home Assistant AddonDocker / Raspberry PiProxmox / OpenWrt LXC
УстановкаМагазин аддоновdocker compose up -dСкрипт на хосте
Веб-интерфейсHA Ingress (8080 / 8081 / 8082) + опциональный прямой WEB_PORT listenerПрямой 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 stackbluetoothd хоста через Supervisor/runtime mountsbluetoothd хоста через D-Busbluetoothd хоста через D-Bus bridge
АудиоАудиомост HAPulseAudio / PipeWire хостаPulseAudio внутри контейнера
Для когоПользователи HAOS / SupervisedОбычные Linux-хосты и Raspberry PiProxmox VE, роутеры, appliance-сценарии

Запустите несколько bridge-инстансов против одного сервера Music Assistant, чтобы покрыть все комнаты — каждый bridge обслуживает колонки в своей Bluetooth-зоне.

Схема развёртывания: план этажа с зонами и адаптерами