|
| 1 | +# HOMEii Music Flow 5.9.0 |
| 2 | + |
| 3 | +Release date: 2026-06-03 |
| 4 | + |
| 5 | +HOMEii Music Flow 5.9.0 is a major mobile, diagnostics, settings, and community release. It promotes the 5.8.2 beta stabilization work into a stable release, adds the new Library Wheel browsing experience, improves phone edge-to-edge behavior, expands Diagnostics v3, and incorporates several community PR ideas into the main card. |
| 6 | + |
| 7 | +## Release Highlights |
| 8 | + |
| 9 | +- **New Library Wheel experience:** the Queue Wheel-style vertical browser is now available across the library: playlists, artists, albums, tracks, liked items, radio stations, and artist albums. |
| 10 | +- **Artist album wheel as a full-screen page:** artist albums now open in a clean Queue Flow-style full page with its own close button. The caption shows the album title and release year. |
| 11 | +- **Radio wheel polish:** Radio uses one stable wheel stage instead of stacking multiple sections. The caption shows the station name. |
| 12 | +- **Diagnostics v3 is now a headline support tool:** diagnostics can be run from the in-card settings and the Home Assistant visual editor, with clearer checks for Music Assistant, queue/library providers, Direct API, Sendspin, browser context, artwork paths, and privacy-safe URLs. |
| 13 | +- **Phone edge-to-edge mode:** phones can use a true full-screen card experience while menus open as frontmost full-screen layers instead of overlapping controls. |
| 14 | +- **Reusable dashboard support:** `card_id` isolates per-card state, and query-string player overrides such as `?player=kitchen_sonos` make reusable dashboard includes much easier. |
| 15 | +- **Settings and performance work:** visual settings are organized into accordion sections, frequent toggles refresh without rebuilding the whole card, and artwork cache behavior adapts better to the selected performance profile. |
| 16 | +- **Danish localization:** Danish is now included, with follow-up placeholder fixes so translated runtime variables render correctly. |
| 17 | + |
| 18 | +## New: Library Wheel |
| 19 | + |
| 20 | +The Queue Wheel proved useful for fast queue navigation, so 5.9.0 extends the same interaction model into the music library. |
| 21 | + |
| 22 | +Available wheel pages: |
| 23 | + |
| 24 | +- Playlists |
| 25 | +- Artists |
| 26 | +- Albums |
| 27 | +- Tracks |
| 28 | +- Liked items |
| 29 | +- Radio stations |
| 30 | +- Artist albums |
| 31 | + |
| 32 | +The goal is fast browsing on phones and touchscreens without turning library pages into cramped grids. The normal grid/list views remain available; the wheel is an additional browsing mode. |
| 33 | + |
| 34 | +Artist albums and radio received extra polish after local testing: |
| 35 | + |
| 36 | +- Artist album wheel opens as a dedicated full-screen page, not inside the artist detail section. |
| 37 | +- Artist album captions show album title and year. |
| 38 | +- Radio wheel renders one scroll stage only, avoiding long stacked pages. |
| 39 | +- Radio captions show the station name. |
| 40 | + |
| 41 | +## Diagnostics v3 |
| 42 | + |
| 43 | +Diagnostics v3 is designed to reduce support loops and make Music Assistant setup issues easier to understand. |
| 44 | + |
| 45 | +It reports: |
| 46 | + |
| 47 | +- HOMEii runtime version and diagnostics version. |
| 48 | +- Browser, platform, viewport, DPR, touch support, and language. |
| 49 | +- Home Assistant URL details with privacy-safe redaction. |
| 50 | +- Music Assistant service availability. |
| 51 | +- Music Assistant config entry state. |
| 52 | +- Strict Music Assistant players and fallback media players. |
| 53 | +- Selected-player markers such as `app_id`, `mass_player_type`, `active_queue`, and registry platform. |
| 54 | +- Direct Music Assistant API and WebSocket state when configured. |
| 55 | +- Sendspin browser support and endpoint readiness. |
| 56 | +- Queue identity, queue providers, queue snapshot status, and queue artwork sample. |
| 57 | +- Library providers, library coverage, and library artwork sample. |
| 58 | + |
| 59 | +External and private hostnames are redacted by default in visible and copied reports. |
| 60 | + |
| 61 | +## Mobile And Layout |
| 62 | + |
| 63 | +5.9.0 includes several phone-focused fixes and improvements: |
| 64 | + |
| 65 | +- Edge-to-edge mode is part of the phone layout mode choice. |
| 66 | +- Compact-card expansion opens into a frontmost full-screen experience. |
| 67 | +- Full-screen menus no longer layer controls on top of each other. |
| 68 | +- The Actions screen behaves like a full-screen mobile page. |
| 69 | +- Player-selection controls were moved higher in the phone layout for better spacing. |
| 70 | +- The library toolbar keeps the wheel button compact so it does not overlap search, sort, player focus, or quick action buttons. |
| 71 | +- The Players screen action hub is clearer, with four icon-and-text actions: This device, Queue, Groups, and Clear all. |
| 72 | + |
| 73 | +## Settings, State, And Reusable Dashboards |
| 74 | + |
| 75 | +This release includes the community-driven `card_id` direction and reusable-dashboard work: |
| 76 | + |
| 77 | +- Optional `card_id` YAML key scopes browser/local storage per card instance. |
| 78 | +- Multiple cards in the same browser can keep different selected players, pinned/excluded players, themes, layout choices, screensaver settings, and other in-card customizations. |
| 79 | +- Query-string player overrides are supported: |
| 80 | + |
| 81 | +```text |
| 82 | +?player=kitchen_sonos |
| 83 | +?homeii_player=kitchen_sonos |
| 84 | +?homeii_player_<card_id>=kitchen_sonos |
| 85 | +``` |
| 86 | + |
| 87 | +This makes it easier to reuse the same dashboard/card definition across rooms and tablets. |
| 88 | + |
| 89 | +Migration note: |
| 90 | + |
| 91 | +Adding `card_id` to a card that previously had no `card_id` will appear to reset that card's in-card customizations once. The old global values remain in browser storage; the card simply starts reading from card-scoped keys. |
| 92 | + |
| 93 | +## Music Assistant Compatibility |
| 94 | + |
| 95 | +5.9.0 includes the full 5.8.2 beta stabilization series: |
| 96 | + |
| 97 | +- Integration-first behavior so core card features can run through the Home Assistant Music Assistant integration. |
| 98 | +- Clearer handling when Direct API browser access is blocked by CORS or mixed-content rules. |
| 99 | +- Better fallback behavior when Music Assistant services exist but strict player markers are missing. |
| 100 | +- More useful queue and library diagnostics. |
| 101 | +- Correct `config_entry_id` handling for Home Assistant `music_assistant` service calls that require it. |
| 102 | +- Cleaner `music_assistant.get_queue` diagnostic calls. |
| 103 | +- Reduced retry noise for invalid direct Music Assistant URLs. |
| 104 | +- Queue snapshot protection so an initial partial or empty Home Assistant response does not replace a complete queue. |
| 105 | + |
| 106 | +Issue #28 remains a special compatibility case for setups where the selected player is exposed as a generic Home Assistant player without Music Assistant queue identity. Diagnostics v3 now gives enough context to keep investigating without blocking the stable release. |
| 107 | + |
| 108 | +## Fixes |
| 109 | + |
| 110 | +- Fixes the beta 8 regression where starting a playlist could leave only one or two queue items visible. |
| 111 | +- Fixes mobile visual-editor diagnostics fallback when clipboard access is blocked by the HA Companion app or browser. |
| 112 | +- Fixes visual-editor diagnostic contrast in themes that made text too light. |
| 113 | +- Keeps visual-editor player settings focused on strict Music Assistant players instead of every generic `media_player`. |
| 114 | +- Fixes Danish interpolation placeholders such as `{player}`, `{title}`, `{count}`, and `{remaining}`. |
| 115 | +- Keeps Direct API failures non-fatal when the Home Assistant Music Assistant integration is available. |
| 116 | +- Improves radio and artist-album wheel scrolling so they behave like the Queue Wheel. |
| 117 | + |
| 118 | +## Community Credits |
| 119 | + |
| 120 | +Huge thanks to **@tocDK** for taking an active role in this release cycle. |
| 121 | + |
| 122 | +His PRs and proposals helped shape: |
| 123 | + |
| 124 | +- `card_id` / per-card state isolation. |
| 125 | +- Settings structure and refresh performance. |
| 126 | +- Artwork cache behavior by performance profile. |
| 127 | +- Danish localization. |
| 128 | +- Danish placeholder fixes. |
| 129 | +- Several practical performance and maintainability discussions. |
| 130 | + |
| 131 | +Some PRs were not merged verbatim because this release needed to stabilize the current code path, but the ideas and fixes were incorporated into 5.9.0 with release credit. |
| 132 | + |
| 133 | +Thank you also to everyone who opened issues, posted screenshots, ran beta builds, copied diagnostics reports, and helped find real-world mobile and Music Assistant edge cases. The 5.9.0 release is very much shaped by that feedback. |
| 134 | + |
| 135 | +## Validation |
| 136 | + |
| 137 | +Before release, the following checks passed: |
| 138 | + |
| 139 | +- Full ESLint. |
| 140 | +- Full Vitest suite: 192 tests passed. |
| 141 | +- Vite production build. |
| 142 | +- Release artifact sync into `dist/`. |
| 143 | + |
| 144 | +## Install / Cache Refresh |
| 145 | + |
| 146 | +HACS users can update normally once the GitHub release is available. |
| 147 | + |
| 148 | +Manual installs should replace the contents of: |
| 149 | + |
| 150 | +```text |
| 151 | +/config/www/community/homeii-music-flow/ |
| 152 | +``` |
| 153 | + |
| 154 | +Then refresh the Dashboard resource with: |
| 155 | + |
| 156 | +```text |
| 157 | +/local/community/homeii-music-flow/homeii-music-flow.js?v=5.9.0 |
| 158 | +``` |
| 159 | + |
| 160 | +After updating, hard refresh the Home Assistant dashboard or restart the HA Companion app if the old frontend bundle remains cached. |
0 commit comments