github Patafoin/ha-my-music-library v4.8.2
v4.8.2 — My Music Library 4 (breaking: own Music Assistant connection)

latest releases: v4.15.1, v4.15.0, v4.14.0...
one month ago

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_player entities. 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: use my_music_library.play_media and my_music_library.transfer_queue.
  • Card. The device picker becomes an output panel offering only Music Assistant players (show_other_players: true to 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_player entities for automations, plus the my_music_library.play_media and my_music_library.transfer_queue actions ("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.yaml are respected.

Full details: Changelog.

Don't miss a new ha-my-music-library release

NewReleases is sending notifications on new releases.