SBoom (LAN) — Home Assistant Integration

Полностью локальное управление умными колонками класса SberBoom из Home Assistant. Никаких облачных токенов, никаких логинов в Sber-аккаунт. Связь с колонкой идёт по локальной сети (WSS на порту 20000), однократная авторизация — нажатием + на корпусе колонки.

Поддерживаемые устройства

SberBoom Home
Прочие колонки SberDevices, анонсирующие сервис _staros._tcp в локальной сети

Возможности

Media Player (`media_player.<name>`)

🎵 Музыка, волна, подкаст, радио и Bluetooth-аудио — все режимы. У радио станция → media_channel, песня → media_title; у BT — title/исполнитель/альбом. На паузе радио остаётся PAUSED со станцией (не «пусто»)
📻 Контекст трека в атрибутах: playlist (название станции/плейлиста, напр. «Персональная волна»), playlist_type (endless/album/user), media_source (MUSIC/RADIO/BLUETOOTH), provider, buffering, child_mode
▶️ Play / ⏸ Pause / ⏭ Next / ⏮ Previous
🔊 Volume / 🔇 Mute / Volume Up/Down
⏩ Seek по позиции трека
🔀 Shuffle / 🔁 Repeat (off/playlist/track)
❤️ Like / 💔 Dislike (через service-вызовы)
🎵 Метаданные трека: title, artist, album, position, duration, cover
📡 Push-обновления — никакого поллинга для смены трека
⚡ Optimistic-обновления: громкость/mute/play-pause отражаются в UI мгновенно, повторные нажатия Volume Up/Down аккумулируются

Панель управления (боковое меню «SberBoom»)

Встроенная премиум-панель плеера — immersive-карточка с обложкой во весь фон и фрост-стеклом; оформление на нативных токенах темы Home Assistant (адаптируется к светлой/тёмной/кастомной теме):

🎨 Ambient-свечение из цвета обложки — интерфейс «носит» цвет того, что играет (эхо LED-кольца колонки); на простое схлопывается, уважает prefers-reduced-motion
🎛 Транспорт (play/pause/next/prev/shuffle/repeat), лайк/дизлайк, скорость воспроизведения (0.5×–2.0×), найти пульт, громкость с mute
🧭 Единый drill-down браузер без табов: очередь → поиск → артист (аватар, топ-треки, дискография) → альбом (треклист) → трек. Кнопка «назад», персистентный поиск
🔎 Богатый поиск Sber Звук — секции Исполнители / Альбомы / Треки / Плейлисты с обложками; клик запускает воспроизведение на колонке
🔊 Несколько колонок — селектор устройства в шапке карточки
🏷 Отображение версии интеграции; адаптив до мобильного
⚙️ Отключается в опциях: Settings → Integrations → SBoom → Configure → «Показывать панель плеера в боковом меню»

🃏 Та же панель как карточка дашборда — ha-sboom-card: standalone immersive Lovelace-карточка (тот же вид: обложка-фон, фрост-стекло, ambient-glow, idle-сворачивание, drill-down каталог). Ставится через HACS, переиспользует компоненты этой интеграции. Работает даже при выключенной боковой панели.

Сервис `sboom_ha.play_music`

Запуск контента на колонке по:

ссылке zvuk.com (напр. https://zvuk.com/track/84279897),
поисковому запросу (query: "Егор Летов"),
паре id + kind (track / artist / release / playlist / podcast / abook).

Camera Entity (`camera.<name>_lyrics_na_tv`) — отключена по умолчанию

MJPEG-стрим с синхронизированными lyrics в стиле Яндекс.Музыки:

🎤 Караоке-заливка (опция, по умолчанию off): текущая строка подсвечивается акцентным цветом по мере пропевания (~5 FPS), посимвольно в порядке чтения. Включается в настройках интеграции. Рассчитана на LTR (для арабского/иврита направление пока не инвертируется)
🌫 Blur-обложка фоном с затемнением (кэшируется — CPU щадит)
✨ Текущая строка lyrics + следующая (помельче, серая)
🎵 Footer с title и artist
⏱ Прогресс-бар + время MM:SS / MM:SS — обновляются каждую секунду, в том числе между строками
📺 Можно отправить на ТВ как изображение через media_player.play_media
🖼 Snapshot камеры показывает актуальный lyrics-кадр (уважает запрошенный размер)
🎧 Текст ищется и для Bluetooth (напрямую из провайдеров, без диск-кэша — у него нет каталожного track_id), синхронизируется по позиции. Радио караоке не поддерживает: колонка отдаёт позицию эфира, а не песни — синхронизировать нечем
🖼 Обложка для Bluetooth и радио ищется по исполнителю+треку (iTunes → Deezer, без ключей) — появляется и на карточке media_player, и blur-фоном караоке
🌈 Если обложки нет — вместо чёрного экрана красивый свободный (CC0) градиент, стабильно-случайный по треку
📻 Плашка источника вверху кадра: «Персональная волна · Sber Звук» (название станции/плейлиста + провайдер)

Sensors

sensor.<name>_lyrics_current_line — текущая строка lyrics; тик планируется на границу следующей строки (без запаздывания). Для треков без текста — unknown, а не unavailable
sensor.<name>_lyrics (диагностический, enum) — статус текста, полный текст в attributes
sensor.<name>_playback_mode — тип воспроизведения: music / wave / podcast / radio / bluetooth (работает даже когда media_player пуст)
Подсистемы колонки из GET_STATE: яркость дисплея, будильники, таймеры, активное приложение, персона ассистента, multiroom (с каналом/партнёром стереопары в атрибутах), тип подключения, спаренные BT-устройства
Диагностические (выкл. по умолчанию): IP-адрес, часовой пояс, возрастной режим профиля, рассинхрон часов колонки с HA, sensor.<name>_device_links — межустройственная связка (SberCast / группировка / саундбар); 0 на одиночной колонке, наполняется при объединении с SberBox/ТВ/другой колонкой
device_tracker.<name>_location (выкл. по умолчанию) — колонка сама себя позиционирует по Wi-Fi-геолокации; удобно для зон и карты
sensor.<name>_coordinates (диагностический, выкл. по умолчанию) — сырые координаты строкой + lat/lon/accuracy/source в атрибутах (в отличие от device_tracker, где state = имя зоны)
sensor.<name>_next_alarm / _next_timer — время ближайшего будильника/таймера (timestamp)
Только на моделях с соответствующим железом (напр. R2) и с проверкой доступности: sensor.<name>_illuminance (освещённость в комнате, lux — датчик колонки), sensor.<name>_soc_temperature (температура чипа), sensor.<name>_zigbee_inventory / _matter_inventory (инвентарь умного дома колонки, только чтение). Если модель не умеет — сущности не создаются.
binary_sensor.*: дисплей, активность, стереопара, подписка, домашняя безопасность, утреннее шоу, будильник звонит (триггер сценариев пробуждения), у трека есть текст, автогромкость и проактивное уведомление ассистента

Calendar (`calendar.<name>_schedule`)

Будильники, таймеры и напоминания колонки одним календарём — читаются из GET_STATE, синхронизируются с приложением «Салют»:

Будильники с корректным раскрытием повторов (iCalendar RRULE: каждый день / будни / выбранные дни).
Таймеры — событие до момента окончания (timeLeftSec).
Напоминания — по времени срабатывания, с заголовком и подзаголовком. Категория события (Будильник/Таймер/Напоминание) — в его описании. Read-only.

Buttons / Switch / Number / Select

button.<name>_play_pause / next_track / previous_track
button.<name>_like / dislike / remove_like / remove_dislike
button.<name>_bt_pairing (режим Bluetooth-сопряжения) / find_remote (поиск пульта)
switch.<name>_shuffle / mute
number.<name>_volume
select.<name>_repeat (off/playlist/track), select.<name>_playback_speed (0.5×–2.0×)

Автоматизации

События в HA bus: смена трека / воспроизведения / громкости / связи (см. События для автоматизаций).
Device-триггеры и device-действия — те же события и команды колонки в UI-конструкторе без YAML (см. Управление из автоматизаций).

Auto-discovery

Колонка находится автоматически через Zeroconf (_staros._tcp.local.) — если mDNS в сети работает. Если в Wi-Fi включена клиентская изоляция (см. Troubleshooting) — IP вводится вручную в один экран.

Установка

Через HACS (рекомендуется)

HACS → Integrations → ⋮ (правый верхний) → Custom repositories
Добавить:
- Repository: https://github.com/dzerik/sboom_ha
- Category: Integration
HACS → Integrations → искать "SBoom (LAN)" → Install
Перезагрузить Home Assistant

Вручную

Скачать репо
Скопировать custom_components/sboom_ha/ в <config>/custom_components/
Перезагрузить Home Assistant

Настройка

Settings → Devices & Services → Add Integration → искать "SBoom (LAN)"
- Если колонка в той же подсети — будет найдена через Zeroconf, появится баннер
- Иначе — введи IP-адрес вручную
После Submit интеграция попросит нажать + на корпусе колонки (там где обычно показывается громкость)
Готово

PIN-токен сохраняется в HA storage. Колонка работает дальше без вашего участия.

Примеры Lovelace

🃏 Готовая immersive-карточка: ha-sboom-card — тот же вид, что и боковая панель (обложка-фон, фрост-стекло, транспорт, drill-down каталог Звука), ставится через HACS. Ниже — примеры на штатных картах HA.

Полная карточка плеера

type: vertical-stack
cards:
  - type: media-control
    entity: media_player.sberboom_home

  # Karaoke-стрим (если включена camera entity)
  - type: picture-entity
    entity: camera.sberboom_home_lyrics_na_tv
    camera_view: live
    aspect_ratio: 16:9
    show_state: false
    show_name: false
    tap_action:
      action: none

Текущая строка lyrics в markdown-карте

type: markdown
content: >
  ### {{ state_attr('media_player.sberboom_home', 'media_title') }}

  *{{ state_attr('media_player.sberboom_home', 'media_artist') }}*

  **{{ states('sensor.sberboom_home_lyrics_current_line') }}**

Отправить lyrics-стрим на ТВ

service: media_player.play_media
target:
  entity_id: media_player.living_room_tv
data:
  media_content_id: >-
    /api/camera_proxy_stream/camera.sberboom_home_lyrics_na_tv?token={{ state_attr('camera.sberboom_home_lyrics_na_tv', 'access_token') }}
  media_content_type: image/jpeg

Автоматизация — приглушать музыку при звонке

trigger:
  - platform: state
    entity_id: binary_sensor.doorbell
    to: "on"
action:
  - service: media_player.volume_set
    target:
      entity_id: media_player.sberboom_home
    data:
      volume_level: 0.1

Управление из автоматизаций

Все сущности интеграции — стандартные HA-сущности и управляются обычными действиями (actions) в автоматизациях и скриптах:

Сущность	Действия
`media_player.<name>`	`media_player.volume_set`, `volume_mute`, `media_play` / `media_pause`, `media_next_track` / `media_previous_track`, `media_seek`, `shuffle_set`, `repeat_set`
`switch.<name>_shuffle` / `_mute`	`switch.turn_on` / `turn_off` / `toggle`
`number.<name>_volume`	`number.set_value`
`select.<name>_repeat` / `_playback_speed`	`select.select_option`
`button.<name>_*` (next, like, BT-пейринг, поиск пульта, …)	`button.press`

Плюс кастомные сервисы sboom_ha.* (см. ниже) с таргетингом по device_id. Команды применяются optimistic — состояние в UI обновляется сразу, подтверждение приходит push'ем/поллингом.

В UI-конструкторе автоматизаций (без YAML) доступны триггеры устройства — «SberBoom → Сменился трек / Изменилась громкость / Изменилась связь» — и действия устройства — «SberBoom → Пауза / Следующий трек / Найти пульт / Bluetooth-сопряжение / Обновить метаданные».

# Пример: ночью замедлять воспроизведение и приглушать громкость
trigger:
  - platform: time
    at: "22:30:00"
action:
  - service: select.select_option
    target: { entity_id: select.sberboom_home_playback_speed }
    data: { option: "0.75" }
  - service: number.set_value
    target: { entity_id: number.sberboom_home_volume }
    data: { value: 20 }

События для автоматизаций

Интеграция выпускает три типа событий в HA bus при изменениях на колонке. Триггерить можно через platform: event.

Событие	Когда	Поля
`sboom_track_changed`	сменился `track_id` (новый трек начал играть)	`track_id`, `title`, `artists`, `album`, `provider`, `previous_track_id`, `entry_id`, `device_id`, `host`
`sboom_playback_changed`	тот же track_id, но изменилось `playing` / `shuffle` / `repeat`	`track_id`, `playing`, `shuffle`, `repeat`, `entry_id`, `device_id`, `host`
`sboom_volume_changed`	сменилась громкость или mute	`volume_percent`, `muted`, `entry_id`, `device_id`, `host`
`sboom_connection_changed`	колонка стала недоступна (3 неудачные reconnect-попытки) или вернулась online	`connected` (bool), `entry_id`, `device_id`, `host`

# Логировать каждый новый трек
trigger:
  - platform: event
    event_type: sboom_track_changed
action:
  - service: logbook.log
    data:
      name: SberBoom
      message: "{{ trigger.event.data.artists | join(', ') }} — {{ trigger.event.data.title }}"

# Подсветить лампу красным когда колонка замьючена
trigger:
  - platform: event
    event_type: sboom_volume_changed
condition:
  - "{{ trigger.event.data.muted }}"
action:
  - service: light.turn_on
    target: { entity_id: light.studio }
    data: { rgb_color: [255, 0, 0] }

Настройки (Options Flow)

Settings → Integrations → SBoom → Configure:

Параметр	Default	Описание
`volume_poll_interval`	15 s	Как часто опрашивать громкость/mute
`keepalive_interval`	25 s	WebSocket KeepAlive интервал
`availability_threshold`	3	После скольки подряд неудачных reconnect entity становятся `Unavailable`
`lyrics_enabled`	true	Загружать synced lyrics с Lrclib.net
`lyrics_netease_fallback`	true	Резервный источник текстов NetEase, когда Lrclib не нашёл synced-текст
`lyrics_offset`	0.0 s	Сдвиг синхронизации текста (+ раньше / − позже), на media_position не влияет

Изменения применяются мгновенно (auto-reload).

Сервисы

Service	Что делает
`sboom_ha.refresh_metadata`	Force-fetch текущего трека/состояния (без ожидания poll-цикла)
`sboom_ha.reauth`	Запустить переавторизацию (нужно нажать `+` на колонке после вызова)
`sboom_ha.bluetooth_device`	Подключить / отключить / удалить спаренное BT-устройство по MAC
`sboom_ha.play_music`	Запустить контент на колонке по ссылке `zvuk.com`, поисковому запросу (`query`), либо паре `id` + `kind` (`track` / `artist` / `release` / `playlist` / `podcast` / `abook`)

Все сервисы поддерживают target.device_id; невалидные вызовы и вызовы без загруженных колонок падают с понятной ошибкой (ServiceValidationError), а не игнорируются молча.

Изменение IP / переавторизация

Автоматически: если mDNS в сети работает, смена IP лечится сама — discovery обновит адрес и перезагрузит интеграцию (в т.ч. для колонок, добавленных вручную: их entry «долечивается» до device-id при первом же discovery).
Из Repairs: если колонка недоступна > 5 минут, в Settings → System → Repairs появляется issue с формой нового IP — соединение проверяется до применения, pair-токен сохраняется.
Вручную: Settings → Integrations → SBoom → ⋮ → Reconfigure. PIN-токен сохраняется.
PIN-токен умер (factory reset, переустановка) — service sboom_ha.reauth, затем нажать + на колонке. Автоматического reauth-триггера нет: локальный протокол не отличает отзыв токена от недоступности.

Удаление интеграции

Settings → Devices & Services → SBoom (LAN) → меню entry (⋮) → Delete.
Если интеграция ставилась через HACS и больше не нужна: HACS → SBoom (LAN) → ⋮ → Remove, затем перезапустить Home Assistant.
На колонке ничего чистить не нужно: pair-токен, выданный при нажатии «+», хранится только в Home Assistant и умирает вместе с config entry. Кэш текстов песен (.storage/sboom_ha_lyrics_*) удаляется автоматически вместе с entry.

Включение опциональных entity

Camera и диагностические sensors отключены по умолчанию (это тяжеловесные сущности). Чтобы их включить:

Settings → Devices & Services → найти ваш SberBoom → N entities
Включить нужные (они помечены как disabled by default)

Иконка интеграции в HA UI

Brand-ассеты лежат прямо внутри интеграции: custom_components/sboom_ha/brand/{icon,icon@2x}.png (256×256 + 512×512, заимствованы из custom_integrations/sberdevices репо home-assistant/brands). Никаких PR в сторонние репозитории не требуется — это новый механизм HA 2026.3+ через Brands Proxy API: локальные иконки автоматически обслуживаются HA по /api/brands/integration/sboom_ha/icon.png и имеют приоритет над CDN.

Note: HACS dashboard может временно показывать пустую иконку для интеграции — это известная проблема HACS. В самом Home Assistant (Settings → Integrations, карточка устройства) иконка отображается корректно.

Зависимости

Устанавливаются Home Assistant'ом автоматически:

websockets >= 13.0 — WebSocket-клиент
Pillow >= 10.0 — рендер lyrics-кадров для camera entity (≈10 MB)
httpx >= 0.27 — HTTP-клиент для lyrics-провайдеров (Lrclib.net + NetEase) и Zvuk-каталога

Внешние источники данных

Интеграция полностью локальна в части управления колонкой, но подтягивает метаданные из открытых источников (все — без авторизации, без ключей, без регистрации; вызываются HA-сервером, не колонкой):

Источник	Что берётся	Когда
Lrclib.net	synced lyrics (`.lrc`)	primary lyrics для музыки с известным `track_id` и Bluetooth
NetEase Cloud Music (`music.163.com`)	synced lyrics (`.lrc`)	fallback lyrics, если Lrclib не нашёл; отключается в Options
iTunes Search API	обложка альбома	Bluetooth / радио (когда нет `track_id` из каталога Zvuk)
Deezer public API	обложка альбома	fallback после iTunes, тот же кейс
Zvuk каталог + CDN (`zvuk.com`, `cdn-image.zvuk.com`)	треки/альбомы/артисты/плейлисты для панели-браузера и сервиса `play_music`; обложки каталожных треков	drill-down браузер боковой панели + сервис `sboom_ha.play_music` + обложка для media_player, когда колонка играет из Zvuk

Если ни один источник обложки не отдал результат — выводится свободный (CC0) градиент, стабильно-случайный по треку (см. image_render.fallback_cover).

Известные ограничения

Lyrics доступны не для всех треков — даже цепочка Lrclib → NetEase не покрывает 100% каталога. Для редких/новых треков sensor будет not_found.
Громкость / mute, изменённые физическими кнопками или голосом, доезжают до HA с задержкой до volume_poll_interval (15 с по умолчанию). Команды из HA отражаются мгновенно (optimistic). Пушит ли колонка изменения громкости — вопрос открытый (research-доки противоречат друг другу); включите DEBUG-лог и поищите state-push получен: volume= — если появляется, откройте issue, поллинг можно будет ослабить.
Автоматического reauth нет — протокол не отдаёт различимого признака «токен отвергнут» (см. раздел про переавторизацию).

Troubleshooting

Колонка не находится автоматически (mDNS / Wi-Fi AP isolation)

В разделе Add Integration колонка не появляется в списке "Discovered", и при попытке поиска через _staros._tcp тоже пусто? Скорее всего, ваш роутер блокирует multicast между клиентами.

Типичные причины:

На Wi-Fi включена AP/client isolation (изоляция клиентов) — устройства не видят друг друга, mDNS-пакеты не доходят
HA и колонка в разных VLAN/SSID (например, IoT-сеть отдельно от основной)
Mesh-роутер режет multicast между нодами (часто бывает у TP-Link Deco, Asus AiMesh при некоторых настройках)
HA в Docker без host-network — контейнеру не виден multicast-трафик

Как проверить с HA-хоста:

# Должно показать колонку. Если timeout — mDNS заблокирован
avahi-browse -rt _staros._tcp

# Прямой ping multicast-адреса. Колонка должна ответить
ping -c 3 224.0.0.251

# IP-скан если знаете подсеть. Открытый :20000 = ваша колонка
nmap -p 20000 --open 192.168.1.0/24

Решения (в порядке предпочтения):

Ввести IP вручную. Settings → Devices & Services → Add Integration → SBoom (LAN) → нет Zeroconf-баннера → форма попросит host. Узнайте IP колонки в роутере (DHCP-leases, обычно по имени SberBoom-...) и введите. Дальше — обычный pair-flow с нажатием +.
Зафиксировать IP колонки в DHCP-резерве — чтобы при смене не пришлось переконфигурировать. Если IP всё-таки сменится, у интеграции есть Reconfigure flow (см. ниже).
Выключить AP/client isolation на роутере (если для вашего use-case это безопасно) — тогда автообнаружение заработает и для будущих устройств тоже.
HA в Docker — запускать с --network=host или включить homeassistant_zeroconf репликатор.

После того как колонка добавлена по IP, push-обновления и WSS-связь работают без mDNS — он нужен только для discovery и автоматического реагирования на смену IP.

Спиннер при добавлении колонки

Проверьте что:

Колонка в той же подсети, что HA (или маршрутизация между подсетями работает)
Порт 20000 открыт (nc -zv <colonka-ip> 20000)
HA имеет доступ к интернету (для DNS, если используете hostname)

Включите DEBUG-логи:

logger:
  logs:
    custom_components.sboom_ha: debug

"pair_timeout" — кнопка `+` не была нажата

Таймаут — 120 секунд. Просто запустите ещё раз и нажмите быстрее.

Lyrics не подгружаются

Lrclib не покрывает все треки. Проверьте через curl: curl 'https://lrclib.net/api/get?track_name=Sledgehammer&artist_name=Peter+Gabriel'
Камера показывает заглушку — значит для текущего трека нет synced lyrics

Архитектура

flowchart LR
    subgraph HA["Home Assistant"]
        CF[config_flow.py]
        CO["coordinator<br/>push + poll fallback"]
        LM["lyrics_manager<br/>кэш + персист"]
        ENT["media_player • camera • sensor •<br/>binary_sensor • button • switch •<br/>number • select • device_tracker • calendar"]
        CF --> CO
        CO --> ENT
        CO --> LM
        ENT -.commands.-> CO
    end
    SPK[(SberBoom<br/>wss :20000<br/>TLS + бинарный TLV<br/>KeepAlive 25s)]
    LRC[(Lrclib.net → NetEase<br/>public API, без ключей)]
    CO <--> SPK
    LM --> LRC

Файлы:

custom_components/sboom_ha/
├── manifest.json          — метаданные интеграции
├── __init__.py            — entry point, lifecycle, async_setup_entry/unload
├── const.py               — константы протокола и enum'ы команд
├── config_flow.py         — UI добавления (user + zeroconf + reconfigure + reauth)
├── coordinator.py         — DataUpdateCoordinator + supervisor task
├── lyrics_manager.py      — кэш/загрузка/персист текстов песен (выделен из координатора)
├── _entity_base.py        — базовый класс с DeviceInfo
├── helpers.py             — общие утилиты (track_position, lyrics_position, cover_url)
│
│   # Транспорт и парсинг
├── api.py                 — публичный WebSocket-клиент
├── _tlv.py                — бинарный TLV-кодек (varint + length-delimited)
├── _parsers.py            — JSON-парсеры payload'ов трека/состояния
├── _models.py             — dataclasses TrackInfo / SpeakerState
│
│   # Сущности
├── media_player.py        — MediaPlayerEntity (device_class: speaker)
├── camera.py              — Camera с MJPEG караоке-стримом (~5 FPS)
├── sensor.py              — lyrics-сенсоры + декларативные сенсоры подсистем
├── binary_sensor.py       — декларативные бинарные сенсоры подсистем
├── device_tracker.py      — GPS-трекер колонки по Wi-Fi-геолокации
├── calendar.py            — будильники/таймеры/напоминания колонки
├── _schedule.py           — разбор расписания (iCalendar RRULE, таймеры, напоминания)
├── device_trigger.py      — device-триггеры (события колонки в конструкторе)
├── device_action.py       — device-действия (команды колонки в конструкторе)
├── button.py              — Button entities (next/prev/play_pause/like/BT/...)
├── number.py              — Number entity (volume)
├── switch.py              — Switch entities (shuffle, mute)
├── select.py              — Select entities (repeat, playback_speed)
│
│   # Платформы HA-lifecycle
├── diagnostics.py         — Download diagnostics (с redaction токена/host)
├── repairs.py             — Issue speaker_unreachable + flow исправления
├── services.py            — Custom services (refresh_metadata, reauth, bluetooth_device)
├── services.yaml          — структура полей services (тексты — в translations)
├── system_health.py       — Метрики в Settings → System → System Information
├── quality_scale.yaml     — HA Quality Scale: Bronze (done/todo/exempt)
│
│   # Lyrics и рендер
├── lyrics_client.py       — цепочка lyrics-источников (Lrclib → NetEase) с retry
├── iio_client.py          — libiio (:30431): датчики платы (освещённость, темп SoC)
├── cli4242.py             — debug-CLI (:4242): инвентарь Zigbee/Matter
├── image_render.py        — PIL-рендер lyrics-кадров + idle-обложки
│
│   # Ассеты
├── strings.json           — UI-тексты (default)
├── translations/
│   ├── en.json
│   └── ru.json
├── brand/                 — иконка интеграции для HA UI (Brands Proxy API)
│   ├── icon.png           (256×256)
│   └── icon@2x.png        (512×512)
└── fonts/
    └── DejaVuSans.ttf     — шрифт для PIL-рендера

Изменения

См. CHANGELOG.md.

Contributions

Issues и PR приветствуются. Перед PR:

Code в Python 3.11+ (CI гоняет 3.11–3.13)
pip install -r requirements-test.txt, затем python -m pytest tests/ -q (все тесты зелёные) и ruff check custom_components/ tests/
Новая логика — с осмысленными тестами (каждый тест должен ловить реальную регрессию)
Описать изменения в CHANGELOG.md

Лицензия

MIT, см. LICENSE.

Disclaimer

Этот проект:

не аффилирован с ПАО Сбербанк, SberDevices или любыми их дочерними структурами
работает только с теми колонками, которыми владеет конечный пользователь — авторизация требует физического нажатия кнопки + на корпусе устройства
предоставляется AS-IS, без гарантий: SberDevices может в любой момент изменить протокол в новом firmware, и интеграция перестанет работать до обновления адаптера
не обходит никаких технических средств защиты, не использует cloud-токены и не выдаёт себя за официальное приложение

Если вы считаете что этот проект нарушает чьи-то права — откройте issue или напишите автору. Мы обязательно прислушаемся.

Полезные ссылки

Telegram c обсуждением этой и других интеграций

Атрибуция внешних источников данных

Lyrics: Lrclib.net (primary) — open-source community-проект — и NetEase Cloud Music public search/lyric API (fallback). Оба сервиса не аффилированы с Sber.
Обложки Bluetooth/радио: iTunes Search API → fallback Deezer public API. Без авторизации.
Zvuk-каталог и обложки для боковой панели-браузера и сервиса sboom_ha.play_music: публичное HTTP API zvuk.com + CDN cdn-image.zvuk.com. Аналогично тому, как их использует веб-плеер zvuk.com в браузере.

Ни один источник не требует авторизации, ключей или регистрации.

Name		Name	Last commit message	Last commit date
.github		.github
custom_components/sboom_ha		custom_components/sboom_ha
research		research
tests		tests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LEGAL.md		LEGAL.md
LICENSE		LICENSE
README.md		README.md
hacs.json		hacs.json
pyproject.toml		pyproject.toml
requirements-test.txt		requirements-test.txt
requirements.txt		requirements.txt

Latest commit

History

Folders and files

Repository files navigation