r11a/homeii-music-flow v5.5.0

5.5.0

on GitHub

HOMEii Flow 5.5.0

Version 5.5.0 is a major experience and polish release for HOMEii Flow. The focus is making the card feel less like a fixed dashboard widget and more like a real music app inside Home Assistant: adaptive, touch-friendly, smart-home aware, and much more resilient across phones, tablets, kiosk panels, and desktop dashboards.

Highlights

• Commercial-grade responsive layout engine: the card now measures the real dashboard/container size instead of relying only on window.innerWidth, so it reacts correctly inside Lovelace grids, narrow columns, sidebars, kiosk pages, visual-editor previews, and rotated mobile/tablet screens.
• Height-aware auto-fit behavior: the old fixed 850 default height is no longer part of the stub config. The optional height setting still works as a fallback/manual override, but HOMEii Flow now prefers the actual space Home Assistant allocates to the card.
• Phone, tablet, kiosk, and desktop fit improvements: artwork, metadata, progress, actions, transport controls, volume, footer buttons, Up Next, and Night mode now use width/height/aspect-aware spacing budgets to reduce overlap, clipping, and accidental scrolling.
• Artwork containment fixes: mobile artwork now stays inside its visual frame, preserves a stronger visual presence when space allows, and no longer escapes the stack/container in tight portrait and kiosk layouts.
• Layout recovery after editor/sidebar changes: ResizeObserver-driven recovery helps the card rebuild itself after Home Assistant sidebar changes, visual-editor open/close cycles, dashboard column changes, mobile rotation, and other host layout transitions.

Smart Home Listening

• Ambient light sync: selected light.* entities can follow the current artwork palette with brightness, transition, and cooldown controls.
• Per-player light mapping: optional mappings let different Music Assistant players drive different light groups.
• Artwork screensaver: optional idle display with current cover, digital or analog clock, date, track metadata, configurable message, clock size, and clock position controls.
• Screensaver idle timing fix: the idle timer now starts when the card page becomes visible, instead of inheriting old idle time from a previous dashboard page.
• POWER button: optional player-control button that can stop the active player or call toggle, turn_on, turn_off, scene, or script actions on a selected Home Assistant entity.

Music Discovery And Player UX

• Discovery mode: a fullscreen recommendation experience with cover-orb browsing, provider-backed mood/genre selectors, fresh/random playlist discovery, recent music, albums, and radio sections.
• Up Next row: optional inline next-track display tuned for tighter mobile layouts.
• Night mode controls: refined so they can participate in the compact player experience without forcing content to overlap.
• Visual editor cleanup: ambient-light player mappings now use friendly labels instead of internal helper names.

Localization Foundation

• Added a shared localization system under src/localization/ and packaged release dictionaries under dist/localization/.
• Ships with English and Hebrew UI dictionaries in 5.5.0.
• Hebrew/RTL support remains a first-class path.
• Added TRANSLATING.md with a full translation glossary.
• Added HOW_TO_ADD_A_LANGUAGE.md with the language-addition workflow: copy the English dictionary, translate values only, register the language, add RTL metadata when needed, then run tests/build/release sync.

Packaging And Validation

• Updated package.json, runtime version constants, README cache-busting examples, local deployment docs, and publishing checklist to 5.5.0.
• scripts/release.mjs now syncs src/localization/ into dist/localization/.
• Added/updated tests for config validation, mobile settings, responsive layout behavior, and localization.

Validation completed locally:

• vitest run: 15 files, 72 tests passed.
• vite build: passed and synced release artifacts.
• node --check: passed for source and dist runtime files.
• eslint .: 0 errors; existing warnings remain.

Upgrade Notes

• HACS users: update/redownload HOMEii Flow after this release appears, then perform a hard refresh in Home Assistant.
• Manual install users: copy the full contents of dist/ into /config/www/community/homeii-music-flow/, including the new localization/ folder.
• Manual resource cache-bust path:

/local/community/homeii-music-flow/homeii-music-flow.js?v=5.5.0

• If you previously set a manual height, it still works. Removing it lets 5.5.0 use the new auto-fit behavior more naturally.