Warning
Breaking update for 3.x users — read before updating.
- Token required. My Music Library now connects to Music Assistant by itself. After updating and restarting, Home Assistant asks you to re-authenticate with your Music Assistant URL and a long-lived API token (Music Assistant: Settings > your user > API tokens). Until then the card shows a "reconnection needed" banner.
- Home Assistant 2026.2 or later required (3.x ran on 2025.1); Music Assistant server able to issue API tokens (tested with 2.10).
- New
media_playerentities. If the official Music Assistant integration is still installed, the new entities get a suffix (media_player.kitchen_2); a fixable issue in Settings > Repairs swaps the IDs so automations, scripts and dashboards follow. - Actions.
music_assistant.play_media& co. don't work on My Music Library players: usemy_music_library.play_mediaandmy_music_library.transfer_queue. - Card. The device picker becomes an output panel offering only Music Assistant players (
show_other_players: trueto bring others back); the Library tab always shows your favorites.
Step-by-step guide: Upgrading from 3.x.
First public release of the 4.x line (4.0.0 to 4.8.1 were never published). Highlights since 3.14.0:
✨ New
- Output panel — the row under the player shows where the music plays and opens a panel with three modes:
- Switch: move the music to one or more outputs — same track, same position;
- Group: add or remove outputs, volume per output and for the whole group;
- Control: see what plays where and pick the output the card controls.
Outputs are tiles with icons and short names (card alias, Home Assistant area or cleaned-up name, full name in an "i" bubble); favorite groups, power on from the card, a default output per device, and outputs that can't be grouped together greyed out with the reason.
- Own Music Assistant connection and players — no dependency on the official integration; live
media_playerentities for automations, plus themy_music_library.play_mediaandmy_music_library.transfer_queueactions ("the music follows me"). - Instant queue — pushed by Music Assistant as soon as it changes, no more fixed delays.
- Artist page — your favorites and the full catalog, split into albums, EPs, singles and live albums; new Artist button on the player.
- Discovery tab — Music Assistant's recommendation folders.
- Setup and reliability — connection test, re-authentication prompt, "reconnection needed" banner instead of a blank card, Repairs flow for duplicate players, styled nav buttons for any tab.
🐛 Fixed
- Albums and playlists that stopped after the first track (a Music Assistant bug, reported in music-assistant/support#6562): My Music Library now resumes them automatically.
- Browsing sub-folders of the filesystem provider (#17) and Deezer's "Made For You" folders.
- "Start a mix" gives immediate feedback and reports failures; failed playback shows the reason.
- Logging levels from
configuration.yamlare respected.
Full details: Changelog.