v2.6.0

Music Assistant Player Card v2.6.0

Breaking Changes

A few different configuration options for hidden elements have been changed with this release. This should not effect most users but the fix should be relatively painless:

• player.hide:
  • group_volume changed to group_selector
  • power changed to power_button
  • repeat changed to repeat_button
  • shuffle changed to shuffle_button
  • favorite changed to favorite_button
  • mute changed to mute_button
• media_browser.hide:
  • search changed to search_button

queue.limit_before and queue.limit_after are no longer used. This is not a breaking change, however - these options will just be ignored. Thanks to the change below, there is no need to limit the number of items returned. If you still have a use for these options, please submit an issue and we can discuss re-adding them or creating alternate solutions.

What's new:

No more limits

A virtualizer has been added for the player queue and collections views! What this means for you is that the card no longer needs to limit the track lists to just a handful of items at a time. All collection items will now always be available while the queue will always pull up to 500 items! No changes are required on your end to make this work.

Now you see me...

More items can now be hidden:

• Music Player
  • Player name
  • Track title
  • Track artist
  • Progress time
  • Progress bar
• Media Browser
  • Filter button

Additionally, every section can now have their header and header title removed.

Other changes:

• Players can now be grouped with players from other providers if supported
• Misc styling tweaks, improvements, and standardizations
• Various bug fixes from the HA 2026.4.0 update

🐛 Bug fixes

• HA 2026.4 styling changes @droans (#605, #620, #623, #628, #638, #646)
• Fix: default_enqueue_option broken in UI editor @droans (#610)
• Fix: Play/pause button display issue when toggling @droans (#639)

🚀 Enhancements

• Pad menu button for collection row; ignore misclicks @droans (#624)
• Remove elevation from collection row menu button, use outline instead @droans (#626)
• Allow hiding player name, track title, artist, and progress @droans (#629)
• Allow hiding filter button for media browser @droans (#630)
• Allow hiding section titles @droans (#631)
• Allow hiding section headers @droans (#632)
• Automatically hide volume bar, mute button, and power button if unsupported by player @droans (#637)
• Use virtualizer for queue, collections to allow for scrolling entirety of items instead of just subset @droans (#640)
• Allow sections to fill behind navbar @droans (#648)

🧰 Maintenance

• Ensure large artwork uses full card @droans (#636)
• Ensure consistent styles @droans (#612, #625, #642, #645, #649)
• use can_group_with property to determine group eligibility @droans (#658)

📚 Documentation

• Update readme @droans (#611)
• Rename config options for hidden elements. @droans (#634)

⬆️ Dependency updates

• Bump typescript-eslint from 8.55.0 to 8.57.1 @droans (#606)
• Bump custom-card-helpers from 1.9.0 to 2.0.0 @dependabot[bot] (#573)
• Use custom eslint-plugin-github with support for eslint 10 @droans (#607)
• Bump eslint/js from 9.39.2 to 10.0.1 @droans (#608)
• Bump eslint from 9.39.2 to 10.0.3 @droans (#609)
• Build(deps-dev): Bump eslint-plugin-unicorn from 62.0.0 to 63.0.0 @dependabot[bot] (#598)
• Build(deps): Bump flatted from 3.3.3 to 3.4.2 @dependabot[bot] (#602)
• Build(deps): Bump picomatch from 4.0.3 to 4.0.4 @dependabot[bot] (#604)
• Build(deps-dev): Bump @typescript-eslint/eslint-plugin from 8.56.1 to 8.57.2 @dependabot[bot] (#619)
• Build(deps-dev): Bump typescript from 5.9.3 to 6.0.2 @dependabot[bot] (#618)
• Build(deps-dev): Bump @rollup/plugin-terser from 0.4.4 to 1.0.0 @dependabot[bot] (#617)
• Build(deps-dev): Bump rollup from 4.59.0 to 4.60.0 @dependabot[bot] (#616)