Sendspin Bluetooth Bridge — multi-device, multiroom, 4 deployment options

[trudenboy]

🔊 Sendspin Bluetooth Bridge

Turn any Bluetooth speaker into a Music Assistant player — no new hardware, no cloud.

This is a community companion project based on loryanstrant's sendspin-client. It started as a Docker wrapper and has grown into a full-featured multi-device bridge with a web dashboard, multiroom sync, and four deployment options.

Repository: https://github.com/trudenboy/sendspin-bt-bridge
Documentation: https://trudenboy.github.io/sendspin-bt-bridge/

What it does

Each Bluetooth speaker appears as a regular player in Music Assistant — just like Sonos or Chromecast. You can play music, control volume, group speakers for multiroom, and manage everything from the MA UI or a dedicated web dashboard.

Key features

• Multi-device — bridge multiple Bluetooth speakers simultaneously, each as its own MA player
• Multiroom sync — group speakers across multiple bridge instances with MA sync groups
• 4 deployment options — HA addon, Docker Compose, Proxmox LXC, OpenWrt LXC
• Web dashboard — real-time SSE updates, HA-aligned dark/light theme, transport controls, group volume
• Auto-reconnect — instant D-Bus disconnect detection, exponential backoff
• Per-device latency compensation — static_delay_ms for A2DP buffer sync
• MA API integration — now-playing metadata, transport controls, volume sync
• 28-endpoint REST API — full programmatic control
• Security — password protection, HA 2FA login, brute-force lockout
• Lazy startup — daemon starts only when BT actually connects (no phantom players)

Deployment

Run multiple bridge instances against the same MA server — each handles the speakers within its Bluetooth range:

Tested on

Platform	Host	Speakers
HA Addon	Proxmox VM (HAOS)	IKEA ENEBY20, Yandex Station mini, Lenco LS-500
Proxmox LXC	HP MicroServer Gen8, Ubuntu 24.04	IKEA ENEBY Portable
OpenWrt LXC	Turris Omnia (ARMv7)	AfterShokz

All 5 speakers run multiroom-synced from 3 bridge instances with CSR8510 USB adapters.

Install

HA Addon (one click):

1. Add the addon repository to Home Assistant:

Or manually: Settings → Add-ons → Add-on store → ⋮ → Repositories → add https://github.com/trudenboy/sendspin-bt-bridge

2. Find Sendspin Bluetooth Bridge in the store and click Install.

Docker / LXC: see installation docs.

---

Built on top of the excellent sendspin-client by @loryanstrant and the Sendspin protocol in Music Assistant. Thanks for making this possible! 🙏

[devedsmith]

This sounds really cool! I can't wait to try it.

[trudenboy]

A lot has happened since the initial post — here's a summary of the key improvements:

● Update: v2.13.1 → v2.16.2 (March 8–10)

🔗 Multiroom & Groups

• Cross-bridge group fix (v2.13.1) — group badge now correctly resolves MA syncgroup IDs, shows group name, works on single-device bridges
• Local devices no longer shown as external (v2.13.2) — multi-device bridges correctly merge group entries sharing the same MA syncgroup
• MA WebSocket reuse (v2.14.0) — player/queue commands use persistent MA monitor connection instead of a new one per command (halves latency)

🔊 Audio

• Auto-unmute BT sink on connect (v2.15.6) — PulseAudio sometimes silently mutes BT sinks on reconnect; bridge now ensures unmute before restoring volume
• Re-anchor loop fix (v2.15.3) — upgraded sendspin-cli to fix rapid back-to-back re-anchors causing audio dropouts
• ARMv7l audio fix (v2.16.1) — fixed silent playback on 32-bit ARM (PyAV
  12.x compatibility)

📱 Platform Support

• Multi-arch Docker (v2.15.2) — builds for linux/amd64, linux/arm64, linux/arm/v7 with parallel CI
• Raspberry Pi guide (v2.16.2) — dedicated docs (en/ru) with model-specific instructions (Pi 3/4/5, Zero 2W)
• Pre-flight script (v2.16.2) — curl -sSL .../scripts/rpi-check.sh | bash checks Docker, BT, audio, UID before first run
• Startup diagnostics (v2.16.2) — docker logs shows structured status table (platform, audio, BT, D-Bus)

🏠 HA Addon

• AppArmor fixes (v2.15.4–2.15.5) — resolved Python startup failures on HAOS
• websockets v15 compatibility (v2.15.7–2.15.8)

🔒 Security (v2.16.0)

SSRF prevention in HA auth, SSE connection limits (4 max / 30 min TTL), volume clamping 0–100, MAC validation, error response sanitization, set_log_level allowlist, path
traversal fix

🔋 Other

• Battery level indicator (v2.13.3) — shows % for BT devices with org.bluez.Battery1
• Diagnostics enrichment (v2.15.0) — per-member state, volume, now-playing in sync groups
• /api/preflight (v2.16.2) — auth-free JSON endpoint for setup verification
• 107 unit tests (was ~18 on March 7)
• Config fsync() — power-failure safe writes on RPi

Full changelog: https://github.com/trudenboy/sendspin-bt-bridge/blob/main/CHANGELOG.md

[trudenboy]

What's new since v2.16.3 → v2.22.2:

🔑 Automatic MA integration — no more manually copying tokens. Sign in with your Music Assistant or Home Assistant credentials right from the web UI, and the bridge obtains a
long-lived API token automatically. In HA addon mode, it's completely passwordless — the token is created via Ingress with zero setup.

🔐 Web UI login — protect the dashboard with a password. Optionally authenticate using MA or HA credentials.

🎵 MA auto-discovery — the bridge finds your Music Assistant server automatically via mDNS. No need to enter the server URL manually.

🔇 Faster mute — mute/unmute responds instantly. A separate MUTE_VIA_MA toggle lets you route mute through MA independently from volume.

🔄 Smarter restart — Save & Restart now shows a live progress indicator with per-device status for Bluetooth, PulseAudio, Sendspin, and MA. Click to expand details.

🎨 Redesigned Configuration UI — cleaner layout, advanced settings integrated into main sections, better device list with collapsible entries, static Save button,
context-aware empty state that guides you through initial setup.

🧹 Legacy cleanup — old BLUETOOTH_MAC config deprecated, dead config keys removed automatically on upgrade.

🐛 Lots of bug fixes — MA beta 2.8+ compatibility, HA OAuth token exchange, phantom player cards, mute sync with PulseAudio, and many UI polish improvements.

[trudenboy]

What's New (v2.22.3 → v2.28.2)

🛡 Security Hardening — session variable leak fixed (cross-user MFA prevention), MAC address validation against command injection, broad except Exception narrowed to specific types across 6 modules,
atomic config writes via tempfile+rename. AppArmor enforce mode for the HA addon.

⚙ Two-Tier Device Control — new global enabled checkbox fully removes a device from BT/PA/MA stack (player unregistered); separate BT Release/Reclaim stays for Bluetooth-only hot toggle. Release
state now persists across restarts.

🎧 TWS Earbuds Support — SSP passkey auto-confirm enables pairing TWS devices (HUAWEI FreeClip, etc.) that require confirmation prompts; D-Bus resilience for stale BlueZ objects when earbuds are in
charging case; auto-reconnect on external BT reconnect.

⚡ Smooth Restart — PA sinks muted before restart, auto-unmuted after audio stabilises (1.5 s settling window, 60 s safety timeout). Cached sink names (LAST_SINKS) skip the 3 s A2DP retry loop on
restart. Sequential progress indicator in the header with CSS spinner/checkmark/warning SVGs.

🎵 Sink Routing Fix — each subprocess verifies and corrects its sink-input routing after audio starts; fixes silent speakers when PulseAudio ignores PULSE_SINK with multiple BT speakers.

🔑 HA Login Improvements — actual HA username displayed (reads Ingress X-Remote-User-Display-Name header); login handler split into 4 per-flow handlers; auto-detects MA_AUTH_PROVIDER=ha when MA is
an HA addon.

🐛 Bug Report Button — one-click diagnostics collection: system info, device states, last errors — auto-masks sensitive data and opens a pre-filled GitHub issue. Redesigned modal with SVG icons,
inline validation, and dark-themed diagnostic preview.

⬆️ One-Click Updates — header shows update badge when a new version is available. Update modal with release notes preview: "Update Now" for LXC (one-click apply), "Update in HA" for addon mode,
Docker instructions. Optional AUTO_UPDATE for LXC auto-applies new versions hourly.

🎨 Dashboard Redesign — compact connection column (85px, dots-only with tooltips); identity column with ellipsis player names + inline badges; progress time inline with progress bar; volume slider
aligned with playback bar; shuffle/repeat always visible; delay always visible; column labels removed. Smart health indicators exclude released devices from totals.

🎮 Demo Mode — full UI demo with emulated BT devices and MA playback without hardware. Set DEMO_MODE=true or try the live demo.

🔧 S6 + AppArmor — proper PID 1 process supervision (S6 overlay v3.2.0.2) with zombie reaping and signal forwarding. AppArmor in enforce mode matching the Music Assistant addon pattern.

🧪 187 Tests across 15 files — config, volume routing, device status, auth, API endpoints, daemon process, MA token exchange, PulseAudio, BT manager, MA discovery, HA config translation.

[trudenboy]

What's New (v2.28.2 → v2.30.5)

📋 BT Diagnostics — ℹ️ BT Info modal on each paired device shows full bluetoothctl info (paired, trusted, connected, UUIDs) with Copy button — no SSH needed. Adapter ↻ Reboot button power-cycles
stuck USB dongles. Bug reports now auto-collect BT device info for every configured speaker.

⬇️ Config Backup & Restore — Download and Upload buttons in the Configuration section. Download filename includes bridge name and timestamp (MyBridge_SBB_Config_20260313.json). Upload validates JSON
structure and preserves sensitive keys (passwords, tokens).

⛔ Quick Disable from Dashboard — ⛔ Disable button directly on each device card to fully remove a speaker from the BT/PA/MA stack without navigating to Configuration.

🔄 Smooth Restart — PA sinks are muted before restart and auto-unmuted after audio stabilises (1.5 s settling window); 6-step progress bar in the header shows each phase. Non-smooth mode still
available with a 5-step bar.

⏳ Buffering Indicator — when MA reports a group is playing but the bridge hasn't received audio yet, the card shows ▶ Buffering with a pulsing orange dot instead of a misleading ⏸ Stopped.

🔇 Mute Indicator Fix — startup unmute now correctly propagates status to the UI (was stuck showing 🔇 even though the sink was unmuted). Timeout reduced from 60 s to 15 s for faster feedback.

🔍 Scan UX — Scan button shows a live countdown during cooldown (Scan (28s) → Scan (27s) → …). Buttons reordered: Add before Add & Pair in scan results.

🎨 Dashboard Layout — device cards now arrange in up to 3 columns on wide screens. Card redesign: status dots with colour classes, chip-style sync display, ±Nms delay format, shuffle/repeat always
visible.

⚠️ Report Indicator — Report link in the header turns yellow when recent logs contain ERROR or CRITICAL messages.

🐛 Stability — released → disabled persistence bug fixed (devices no longer incorrectly skipped on reboot); MA group matching uses stable player_id instead of fuzzy name comparison; bluetoothctl
output stripped of ANSI codes; equalizer bars no longer stuck after re-anchor.

[trudenboy]

What's New (v2.30.6 → v2.31.7)

🎨 Major UI Redesign — device cards, header, and toolbar were fully rebuilt to better match Home Assistant / Music Assistant design language. Added grid/list view, adapter and status filters, group
actions, SVG icons instead of emoji, a new card layout, and a shared chip/badge system across the dashboard.

🧩 UI Consistency & Configuration Cleanup — the Configuration area was refactored into a proper card-based settings surface with a cleaner hierarchy across General / Security / Bluetooth / Devices /
Music Assistant. Added a real Cancel action to discard unsaved changes, improved section structure, and made list view the default for larger device fleets while remembering the user’s choice.

🔗 Faster Navigation & Device Management — adapter badges now jump directly to Configuration → Bluetooth, custom adapter names are editable, and Music Assistant sync-group badges open the correct MA
settings page in a new tab.

📊 Better Runtime Visibility — device delay is now shown consistently in both card and list views, list rows expose the same key runtime context as cards, and adapter/status badges are visually
unified between both layouts.

🛡 Security Hardening — added CSRF protection on login, CSP and X-Content-Type-Options headers, adapter input validation against command injection, config upload size limits, sanitized API error
responses, and fixes for XSS, thread-safety, and race-condition issues.

🔐 Home Assistant Login / MFA Improvements — auth flows were improved overall, and v2.31.7 fixes a regression in direct HA login with MFA/TOTP: the second-step authenticator form now preserves a
valid CSRF token, so entering the code no longer fails with Invalid session. Please try again.

🧪 Tests & CI — the test suite was expanded and current validation now passes with 223 tests. CI was also fixed to install libdbus-1-dev, allowing dbus-python to build correctly in GitHub Actions.

✨ Smaller UX Improvements — the version badge now links to GitHub release notes, the username links to the HA/MA profile when available, empty states span the full grid width, card hover no longer
affects neighboring cards, and album-art popups are no longer clipped by overflow: hidden.

[trudenboy]

What changed since v2.31.8

Since v2.31.8, Sendspin Bluetooth Bridge has gone through a major stabilization and polish cycle.

On the runtime / ops side, updates for native LXC installs became much safer with archive-based sync, detached upgrade execution, smoke checks, and rollback logic. Config handling, diagnostics,
adapter resolution, duplicate-device protection, and recovery from broken runtime states were all hardened.

On the Music Assistant integration side, album-art delivery was fixed through a safe same-origin proxy, queue metadata and progress handling became more reliable, and the latest releases moved
MA transport/shuffle/repeat synchronization toward a backend-authoritative model with structured command responses, pending-state tracking, reconnect-state retention, and a monitor-first control
path.

On the UI side, the dashboard moved much closer to a real Music Assistant-style experience: cleaner card/list parity, tighter expanded-list playback layout, more truthful control availability,
larger artwork, better queue context, and more polished bulk actions.

[trudenboy]

What’s New (v2.31.9 → v2.40.6)

🎛️ A much better Music Assistant playback UI — the dashboard got a lot more polished across both card and list views. Playback controls, queue previews, progress display, badges, warnings, and live
status all feel cleaner and more consistent now.

🖼️ Better now-playing and artwork handling — album art is more reliable again, playback progress is less jumpy, and the UI does a much better job showing what is actually playing right now.

🔁 Music Assistant controls are much more reliable — a lot of work went into fixing next / previous / shuffle / repeat, especially for solo players and mixed MA versions. In practice, transport
controls now behave much better for both single speakers and MA sync groups.

⚡ Faster, calmer UI behavior — queue actions and MA state sync were improved so the interface reacts faster, shows more useful pending/confirmed state, and recovers more gracefully from short
disconnects instead of feeling “stuck” or confusing.

🩺 Far better status, startup, and diagnostics — the bridge now exposes startup progress, richer health/status snapshots, better diagnostics, and clearer onboarding hints. That makes it much easier
to understand what the bridge is doing and why something is not ready yet.

🧩 Home Assistant addon experience improved a lot — stable, RC, and beta tracks are now much clearer and safer to use. Parallel addon channels were improved, ingress behavior is cleaner, and the UI
now better reflects what is fixed by the installed HA addon track versus what is user-configurable.

⬆️ Updates are safer and clearer — update channels are now first-class, standalone/LXC updates are more predictable, and the release flow is cleaner: stable builds use GitHub Releases, while
prerelease tracks use tags.

🎨 General UI polish everywhere — lots of smaller improvements landed across warnings, spacing, helper text, header actions, onboarding, and config screens.

🎮 Want to see the UI almost live before updating? Try the demo stand here:
https://sendspin-demo.onrender.com

🙏 And thank you all for the interest in the project, the testing, the feedback, the bug reports, and the ideas. It really helps move the bridge forward much faster