Установка — Home Assistant Addon

Какой аддон выбрать?

Аддон	Для чего подходит	Ingress-порт	Базовый player-port	Поведение при старте
Stable	Обычное ежедневное использование	`8080`	`8928`	Auto
RC	Тестирование release candidate	`8081`	`9028`	Manual
Beta	Самые ранние prerelease-сборки	`8082`	`9128`	Manual

Требования

Home Assistant OS или Supervised
Bluetooth-адаптер, доступный хосту HA
Запущенный Music Assistant в вашей сети

Установка

Добавьте репозиторий аддонов

Используйте кнопку для автоматического добавления:

Или вручную: Настройки → Аддоны → Магазин аддонов → ⋮ → Репозитории и добавьте:
```
https://github.com/trudenboy/sendspin-bt-bridge
```
Выберите вариант аддона

Для стабильного трека установите Sendspin Bluetooth Bridge. Варианты RC и Beta ставьте только если вам действительно нужны prerelease-сборки.

Настройте аддон

На вкладке Configuration:

sendspin_server: auto
sendspin_port: 9000
base_listen_port: 8928         # опционально: базовый порт для плееров без listen_port
update_channel: stable         # влияет только на проверку обновлений, а не на смену варианта аддона
bluetooth_devices:
  - mac: "AA:BB:CC:DD:EE:FF"
    player_name: "Колонка в гостиной"
  - mac: "11:22:33:44:55:66"
    player_name: "Колонка на кухне"
    adapter: hci1
    static_delay_ms: 0
    listen_port: 8935          # опционально: переопределение Sendspin-порта для устройства
    listen_host: 192.168.1.50  # опционально: рекламируемый host/IP в отображаемом URL

Запустите аддон

Запустите аддон. Stable по умолчанию стартует автоматически; RC и beta по умолчанию запускаются вручную, чтобы prerelease-установки было проще держать отдельно.
Подключите функции Music Assistant

Откройте веб-интерфейс → Configuration → Music Assistant и нажмите 🏠 Sign in with Home Assistant, если хотите получить метаданные MA, транспортные кнопки, queue actions и group-volume sync.

Как работают порты в режиме аддона

Ingress-порт назначается Home Assistant Supervisor динамически. У всех трёх треков аддона (stable / RC / beta) в манифесте стоит ingress_port: 0, и Supervisor выбирает свободный порт на лету — это позволяет аддонам уживаться с Matter / Thread и другими сервисами host-network без ручного планирования портов. Bridge при старте читает реальный порт из /addons/self/info.
web_port читается, но не применяется. Поле остаётся в схеме ради совместимости, однако bridge сейчас не открывает параллельный прямой listener в режиме аддона. Оставляйте пустым.
base_listen_port задаёт базовый диапазон Sendspin player-port для устройств без явного listen_port. Per-channel дефолты разные, чтобы варианты аддона не пересекались: stable 8928, RC 9028, beta 9128.
Поле listen_port у устройства имеет приоритет. Используйте его, если конкретной колонке нужен фиксированный порт.
Поле listen_host меняет только рекламируемый host/IP. Внутри плеер всё равно bind’ится на 0.0.0.0.

Как открыть веб-интерфейс

Используйте кнопку Open Web UI на странице аддона или ссылку в боковой панели HA. Оба маршрута идут через HA Ingress на динамически назначенный Supervisor порт — отдельного прямого URL запоминать не нужно.

Семантика канала обновлений

Установленный вариант аддона определяет, на каком кодовом треке вы реально находитесь: stable, RC или beta.
Опция update_channel лишь задаёт, какие релизы должен проверять встроенный updater (stable, rc или beta).
Изменение update_channel не переключает установленный трек аддона.
Чтобы перейти со stable на RC/beta, установите соответствующий вариант аддона из Add-on Store.

Аудио-маршрутизация на HA OS

Аддон запрашивает audio: true, поэтому Home Assistant автоматически прокидывает аудиомост. Ручной монтировки сокетов PulseAudio/PipeWire не требуется.

Применение изменений конфигурации

Изменения устройств, адаптеров, web_port, base_listen_port и настроек подключения к Music Assistant применяются после перезапуска. Используйте Restart на странице аддона или Save & Restart в веб-интерфейсе.