Repository navigation
1.1.0
New in 1.1.0
Overlay tinting (fixes #12)
Optional tint layer drawn over the background media. Darkens or tints busy backgrounds so cards and text stay readable. Configurable at the root, group, or view level:
animated_background:
overlay:
color: "#000000" # any CSS color, default #000000
opacity: 0.3 # 0-1, default 0.3overlay tints the media itself, while opacity makes dashboard cards semi-transparent. They are independent.
Visual editor
The plugin ships an Animated Background Editor card in the same file (no extra resource). Add it from the card picker as custom:animated-background-editor and configure across tabs: General, Entity & States, Views, Groups, Access, and Advanced. On storage-mode dashboards it saves directly and the background redraws immediately; on YAML-mode dashboards use Copy YAML.
Saves merge over your existing config, so hand-written keys the editor does not model survive a round-trip.
Fixed since 1.0
- Editor dropdowns respond on all Home Assistant versions. HA 2026.2 rewrote
ha-select(emitsselectedwithdetail.value, menu requiresha-dropdown-item); the editor now binds the right event and item element per era, with a native-input fallback covering theha-textfieldremoval. - Editor card renders fully (all six tabs, Save flow, sub-forms) after the plain-DOM rewrite, and save failures are reported.
refresh_interval/refresh_on_updateset at the root now apply to group-driven views, and edits to the interval restart the timer live instead of waiting for a reload.- Runtime robustness:
cleanupDOMno longer deletes Home Assistant's own stylesheets; configs withentitybut nostate_urlno longer crash the render poll;restart()no longer leaks its polling interval during rapid navigation;clearMemes()resets its iteration counter; early loading before thehome-assistantelement mounts no longer throws. - Opacity is numeric and clamped to 1-99 (single-digit values were off by a factor of ten) and per-view
opacitynow applies on navigation, not just first render. - Hardening: the background iframe is built with element properties instead of interpolated
srcdoc; duplicate resource registration is detected and logged instead of running two competing render loops. - Access precedence is explicit: exclusions always win over inclusions; explicit
enabledapplies next; inclusion lists act as allowlists (empty lists no longer disable everything).
Update
- HACS - Animated Background - Update to 1.1.0
- Hard-refresh the browser (Ctrl/Cmd+Shift+R)
- If updating manually, replace
dist/animated-background.jsand delete the sibling.gzso HACS does not serve the stale compressed copy
The console banner reads ANIMATED-BACKGROUND v1.1.0.
Re-tested against Home Assistant 2026.8.