You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CHANGELOG.md
+31Lines changed: 31 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,36 @@
1
1
# Changelog
2
2
3
+
## 5.9.3 - 2026-06-20
4
+
5
+
Focused stability release for queue, search, configured-player selection, Radio favorites, progress timing, and Diagnostics.
6
+
7
+
Fixed:
8
+
9
+
- Detects partial Music Assistant queue snapshots instead of treating them as a clean OK state.
10
+
- Keeps fuller rendered queue data when a new queue API response only contains a partial window.
11
+
- Makes configured `entity` work as a stable default player while preserving query-string overrides and currently active playback priority.
12
+
- Shows entity ids in player-selection surfaces to help users distinguish duplicate friendly names.
13
+
- Continues provider/direct Music Assistant search after fast library results, then merges provider results back into the UI.
14
+
- Uses Direct Music Assistant `music/search` for provider search when direct access is available.
15
+
- Fixes RadioBrowser/external radio favorite handling so selected stations do not depend on the currently playing item.
16
+
- Keeps LTR search input alignment scoped to non-RTL layouts.
17
+
- Improves progress calculation by preferring trusted player timing when queue timing drifts.
18
+
19
+
Diagnostics:
20
+
21
+
- Adds Diagnostics v7.
22
+
- Adds a Configured entity check that explains whether the configured entity exists, is visible, is excluded, is a Music Assistant player, or was overridden by another selection source.
23
+
- Adds Search providers checks that report HA search, Direct `music/search`, active query, result counts, and timing for fast/library search versus provider search.
24
+
- Improves Queue UI state and Queue snapshot wording when only a partial queue window is available.
25
+
26
+
Validation:
27
+
28
+
-`node --check src/homeii-music-flow.js`
29
+
-`node --check src/core/base-music-card.js`
30
+
-`npm.cmd run build`
31
+
-`npm.cmd test`
32
+
- Full Vitest suite passed locally: 231 tests.
33
+
3
34
## 5.9.2 - 2026-06-16
4
35
5
36
Focused hotfix for in-card Settings and Diagnostics access.
@@ -74,22 +74,22 @@ HOMEii Flow is a custom Home Assistant Dashboard card for Music Assistant. It tu
74
74
75
75
HOMEii Flow started from my own daily use of Home Assistant and Music Assistant. I wanted it to feel less like a technical dashboard widget and more like a real music app inside Home Assistant, so a lot of thought went into the flow, touch interactions, Hebrew/RTL comfort, wall-tablet behavior, mobile details, and the small moments that make choosing music feel natural at home.
76
76
77
-
## 5.9.2 Hotfix
77
+
## 5.9.3 Stability Release
78
78
79
-
HOMEii Flow 5.9.2 is a focused hotfix on top of 5.9.1. It restores the in-card Settings screen and Diagnostics access after a missing Announcements settings method caused Settings to fail for some users.
79
+
HOMEii Flow 5.9.3 is a focused stability release on top of 5.9.2. It improves queue handling, configured-player selection, provider search, Radio favorites, progress timing, and Diagnostics while keeping the release scoped to bug fixes and supportability.
80
80
81
81
Release focus:
82
82
83
-
-**Settings hotfix:**fixes `this._settingsSectionAnnouncements is not a function`.
84
-
-**Diagnostics access:**restores the path to in-card Music Assistant Diagnostics.
85
-
-**Announcements settings:**restores the Announcements settings section.
86
-
-**Configuration clarity:**explains that `ma_url` / `ma_token` are for Direct/Sendspin access and do not replace the Home Assistant Music Assistant integration.
87
-
-**No queue logic change:**empty Queue reports should now be diagnosed with the restored Diagnostics screen.
83
+
-**Queue stability:**detects partial Music Assistant queue snapshots and avoids treating them as clean OK states.
84
+
-**Player selection clarity:**configured `entity` works as a stable default, and player selection surfaces expose entity ids when friendly names are ambiguous.
85
+
-**Search improvements:**fast library results can appear immediately while provider/direct Music Assistant search continues and merges in later.
86
+
-**Radio favorites:**external/RadioBrowser station favorites no longer depend on the currently playing item.
87
+
-**Diagnostics v7:**adds configured-entity and search-provider checks for cleaner support reports.
HOMEii Music Flow 5.9.3 is a focused stability release for the open 5.9.x support reports. It improves queue handling, player selection clarity, search behavior, Radio favorites, progress timing, and Diagnostics without adding new experimental features.
6
+
7
+
## Why This Release Exists
8
+
9
+
The 5.9.2 hotfix restored Settings and Diagnostics access. After users could share better reports, the remaining issues were clearer:
10
+
11
+
- some queues were shown as empty or partial even when Music Assistant had a larger queue
12
+
-`entity:` did not always behave like the expected default player
13
+
- provider search could stop after library results or feel like it never searched Spotify/Music Assistant providers
14
+
- Radio favorite actions could still target the current item instead of the selected station
15
+
- users with duplicate player names needed to see the real entity id while pinning/selecting players
16
+
- progress could drift from Music Assistant timing in some setups
17
+
18
+
## Fixed And Improved
19
+
20
+
- Improved queue snapshot handling so partial Music Assistant queue windows are detected instead of being treated as a clean success.
21
+
- Keeps fuller rendered queue data when a new queue API response is only a partial window.
22
+
- Improves Diagnostics wording for partial Queue snapshots so reports now show when Home Assistant/Music Assistant only returned part of the queue.
23
+
- Makes the configured `entity` act as a stable default player while still allowing query-string player overrides and currently playing players to take priority.
24
+
- Adds clearer player labels with entity ids in player-selection surfaces, helping users distinguish duplicate friendly names.
25
+
- Fixes provider search flow so HOMEii can show fast library results first and still continue provider/direct Music Assistant search in the background.
26
+
- Adds Direct Music Assistant `music/search` provider search support using the current Music Assistant search command shape.
27
+
- Fixes search result replacement so provider results can merge in after library results instead of being discarded.
28
+
- Fixes RadioBrowser/external radio favorites so they use local item favorites instead of the Music Assistant current-media favorite path.
29
+
- Keeps English/LTR search input alignment from leaking into RTL layouts and vice versa.
30
+
- Improves progress calculation so the player position remains closer to Music Assistant by preferring trusted player timing when queue timing drifts.
31
+
32
+
## Diagnostics v7
33
+
34
+
Diagnostics now adds two focused checks:
35
+
36
+
-**Configured entity:** reports whether the configured card `entity` exists, whether it looks like a Music Assistant player, whether it is hidden by pinned/excluded filters, and why HOMEii selected another player if it did.
37
+
-**Search providers:** when run after a search, reports HA search availability, Direct `music/search` availability, result counts, and timing for fast/library search versus provider search.
38
+
39
+
Queue Diagnostics also reports partial queue windows more clearly, including cases where the rendered queue count is lower than the queue state count.
40
+
41
+
## Important Notes
42
+
43
+
This release improves queue handling and diagnostics, but it does not claim that every empty Queue report is caused by HOMEii.
44
+
45
+
If Home Assistant or Music Assistant only returns a partial queue and no fuller Mass/Direct queue path is available, HOMEii cannot invent missing queue items. In that case, 5.9.3 should at least report the exact limitation clearly instead of showing a misleading OK state.
46
+
47
+
Spotify/provider search can still be slow when Music Assistant itself is waiting on a cold provider search. HOMEii now avoids stopping early after library results, but provider latency is still controlled by Music Assistant and the provider.
48
+
49
+
## Validation
50
+
51
+
-`node --check src/homeii-music-flow.js`
52
+
-`node --check src/core/base-music-card.js`
53
+
-`npm.cmd run build`
54
+
-`npm.cmd test`
55
+
- Full Vitest suite passed locally: 231 tests.
56
+
- Production build and release artifact sync passed locally for `5.9.3`.
57
+
58
+
## Manual Resource Refresh
59
+
60
+
After updating, use a hard refresh or update the resource cache-buster:
0 commit comments