Repository navigation
Releases
1.1.3
New in 1.1.3
A metadata-only release. The repository name in HACS now reads Lovelace Animated Background - with Optional Editor Card, surfacing this fork's main differentiator from upstream: the built-in visual editor card, which upstream does not have.
No code changes - the 1.1.2 fix for the HA 2026.11 backdrop layering (#15) is unchanged. The new HACS name appears on the next catalog refresh whether or not you update; updating just brings the console banner current.
Update
- HACS - Animated Background - Update to 1.1.3
- Hard-refresh the browser (Ctrl/Cmd+Shift+R)
The console banner reads ANIMATED-BACKGROUND v1.1.3.
1.1.2
New in 1.1.2
Fixes the animated background disappearing after updating Home Assistant to 2026.11 (#15).
What broke
Home Assistant 2026.11 changed how the frontend paints the dashboard backdrop: it now draws an opaque panel background layer (home-assistant/frontend#55485) in the stacking range where this card's background video lived (z-index: -12). The dashboard keeps working, but the animated background is hidden behind the new backdrop, with no console error.
The fix
The background video now stacks at z-index: 0 with #view at z-index: 1, so the video paints above any negative-z backdrop and below your dashboard content. The same CSS serves every Home Assistant version - verified against both the 2026.11 layering and the pre-2026.11 layering, so 1.1.2 is safe to run on 2026.10 and older too. (The same fix shipped upstream as release 2026.11.05.)
Nothing else changed.
Update
- HACS - Animated Background - Update to 1.1.2
- 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.2.
Verified against Home Assistant 2026.11 and the pre-2026.11 layering.
1.1.1
New in 1.1.1
v1.1.0 shipped incomplete. Its release merge resolved the README and dist conflicts against the v1.0.0 side of the history, silently dropping the visual editor code and its documentation from the shipped bundle. If you installed 1.1.0, you were running the 1.0 runtime with a 1.1.0 label: no editor card, and none of the beta hardening fixes.
Restored in this release
- The visual editor card ships again.
dist/animated-background.jsis restored to the v1.1.0-beta.5 build: thecustom:animated-background-editorcard with all six tabs (General, Entity & States, Views, Groups, Access, Advanced), plus every fix that shipped with it — editor dropdown support across Home Assistant select eras, runtime robustness (no foreign style deletion, hardened null paths and timers), numeric clamped opacity with per-view application on navigation, live refresh-interval changes, the background iframe built via element properties with a double-load guard, and explicit access precedence (exclusions always win over inclusions). - The README documents the editor again. The full "Configure with the visual editor" section is back: adding the editor card to an existing dashboard, setting up a brand-new dashboard, what each tab does, and the good-to-know notes.
Nothing else changed. This release restores exactly what v1.1.0 was intended to deliver.
Update
- HACS - Animated Background - Update to 1.1.1
- 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.1.
Re-tested against Home Assistant 2026.8.
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.
1.1.0 Beta 5
Fixed
Runtime robustness (crashes and leaks, no behavior change):
cleanupDOMno longer deletes Home Assistant's own stylesheets. It removed every<style>element inhui-root's shadow root, stripping HA styling and silently breaking card-mod theming after navigating between dashboards. Only the plugin's own tagged stylesheet is removed now.- A config with
entitybut nostate_urlno longer crashes the plugin. The runtime threw an uncaught TypeError on every render poll in that state - a plausible half-finished config the editor itself warns about. The default background renders instead. restart()no longer leaks its polling interval when invoked repeatedly during rapid navigation (the handle was shadowed by a hoisted local, so the clear call was a no-op).clearMemes()resets its iteration counter, so the view-background clearing window is always the full two seconds. A partially spent counter previously shortened it, causing intermittent opaque backgrounds on view switches.- Loading before Home Assistant mounts no longer throws. If the resource loads before the
home-assistantelement exists, the plugin waits via the existing poll loop instead of dying at startup.
Opacity and per-render state:
- Single-digit
opacityvalues are no longer off by a factor of ten. Values were concatenated after0., soopacity: 5produced 0.50 instead of 0.05. Now computed numerically and clamped to 1-99. - Per-view
opacitynow applies on navigation. The stylesheet was only written on the first render of a page load, so the first view's value persisted until a full reload. refresh_intervaledits restart the timer instead of waiting for a page reload.- README now documents the opacity range as 1-99, matching the runtime (0 has never applied) and the editor's validation.
Hardening:
- The background iframe is built with element properties instead of interpolating
srcdocinto an HTML attribute, where a double quote in a URL or overlay color would blank the background with no diagnostic. - Duplicate resource registration (e.g. a leftover
/local/entry plus the/hacsfiles/one) is now detected and logged instead of running two competing render loops.
Changed
-
Exclusions always win over inclusions. Previously a user in
included_userswho was also on anexcluded_deviceslist still got the background. Precedence is now explicit and documented in the README:- Any
excluded_users/excluded_devicesmatch (root or view/group config) disables the background. - An explicit
enabled: true/enabled: falseon a view or group config applies next - it can override inclusion lists, never exclusions. - Inclusion lists act as allowlists: if any is configured, the current user or device must match at least one of them. Empty inclusion lists no longer disable everything.
- Any
Update
- HACS - Animated Background - Update to 1.1.0 Beta 5 (beta versions enabled)
- 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 - that label is shared across the 1.1.0 betas.
Re-tested against Home Assistant 2026.8.
1.1.0 Beta 4
Fixed
- Editor dropdowns did not respond to selection (Views tab, Groups tab). HA 2026.2 rewrote its
ha-selectcomponent: it now emits aselectedevent (notchange) and its menu only reacts toha-dropdown-itemitems. The editor bound the wrong event and built the wrong item type, so picking a different option (for example setting a view to Disabled ('none')) snapped back to the previous value and Save stayed disabled. Selections now register on all Home Assistant versions: the dropdown updates immediately, Save enables, and round-trip saves persist.
Update
- HACS → Animated Background → Update to 1.1.0 Beta 4 (beta versions enabled)
- 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 — that label is shared across the 1.1.0 betas.
Re-tested against Home Assistant 2026.8.
1.1.0 Beta 3
Fixes the blank editor card reported in beta.2.
Fixed
- Editor card rendered blank. The internal DOM helper rejected the way most of the editor passed child elements, so the card threw an exception during its first render. It still appeared in the card picker, but the card itself (and the preview in the card editor) stayed empty. The editor now renders fully: all six tabs, Save flow, sub-forms.
- Save behavior verified end to end: an edit enables Save, a successful save clears it, and the save preserves hand-written keys the editor does not model (config is merged, not rebuilt).
Still in this beta (from beta.2)
- Overlay tinting (
color+opacity), configurable at root, group, or view level (fixes #12) - Built-in Animated Background Editor card — no extra resource
refresh_interval/refresh_on_updatenow inherit from the root for group-driven views- README leads with the visual editor, documents both existing- and new-dashboard flows
Marked as a prerelease: HACS only offers it when Show beta versions is enabled. Stable users stay on 1.0.
Update notes
After updating through HACS, hard-refresh the browser (Ctrl/Cmd+Shift+R). If the card is still blank after updating, check that no stale .gz file sits next to animated-background.js in /config/www/community/lovelace-animated-background/ and delete it if present.
v1.1.0-beta.2
Visual editor rewrite
The editor card introduced in beta.1 never rendered (a Lit integration bug) - this is a full rewrite, no longer depending on HA internals:
- Plain DOM + HA's globally-registered custom elements, with native fallbacks if those disappear
- Full config coverage: every option is now editable at the root and in group/view sub-configs, including
background, opacity, transparent panel, refresh behaviour and user/device access lists (less-common fields under "More options") - Saves merge over your existing config, so hand-written keys the editor does not know about survive a round-trip
- Group/None assignments now work on views without a
path - Save failures are reported (saveConfig is awaited), and a successful save redraws the background immediately - including overlay-only changes
- Generated YAML now includes the
animated_background:root key, ready to paste - Clear handling for non-admin users, YAML-mode dashboards, and auto-generated (strategy) dashboards
- Copy YAML works on plain-HTTP (non-secure) installs
Bug fix
refresh_intervalandrefresh_on_updateset at the root now apply to group-driven views (previously the timer silently never started for them)
Docs
- README restructured: the visual editor is now documented first, including the take-control step for brand-new dashboards; the undocumented
backgroundoption is now in the reference table
Testing: after updating, delete the sibling .gz copy of the old file in /config/www/community/lovelace-animated-background/ (HACS keeps serving the stale compressed copy otherwise), then hard-refresh your browser (Ctrl/Cmd+Shift+R).
1.1.0 Beta 1
Beta of the overlay branch. Adds background tinting and a visual configuration editor. Marked as a prerelease: HACS only offers it when Show beta versions is enabled, otherwise you get 1.0.
New in this beta
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 now 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.
Also
- README: fixed broken links, documented
overlayand the visual editor console.infoversion banner (v1.1.0-beta.1) for installed-version identification
Feedback welcome — report issues against the overlay branch.
1.0
First stable release of the refreshed fork, tested against Home Assistant 2026.x.
What's in 1.0
- Fixes for Home Assistant 2026.x compatibility
- Layout and CSS stacking-context fixes (popups no longer trapped behind the background)
- Shadow DOM targeting corrections
- Group config inheritance fixes
- All carried-over features: entity-driven state changes, per-view configuration, groups, transparent panels, card opacity, user/device include-exclude lists
console.infoversion banner so the installed version is visible in the browser console
Install
Install through HACS (Dashboard category). Beta versions of 1.1.0 (overlay tint + visual editor) are available separately as a prerelease.