Skip to content

Releases

1.1.3

Choose a tag to compare

@imonlinux imonlinux released this 07 Nov 19:03

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

  1. HACS - Animated Background - Update to 1.1.3
  2. Hard-refresh the browser (Ctrl/Cmd+Shift+R)

The console banner reads ANIMATED-BACKGROUND v1.1.3.

1.1.2

Choose a tag to compare

@imonlinux imonlinux released this 07 Nov 18:17

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

  1. HACS - Animated Background - Update to 1.1.2
  2. Hard-refresh the browser (Ctrl/Cmd+Shift+R)
  3. If updating manually, replace dist/animated-background.js and delete the sibling .gz so 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

Choose a tag to compare

@imonlinux imonlinux released this 16 Sep 04:08

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.js is restored to the v1.1.0-beta.5 build: the custom:animated-background-editor card 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

  1. HACS - Animated Background - Update to 1.1.1
  2. Hard-refresh the browser (Ctrl/Cmd+Shift+R)
  3. If updating manually, replace dist/animated-background.js and delete the sibling .gz so 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

Choose a tag to compare

@imonlinux imonlinux released this 11 Sep 20:40
ffeddc5

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.3

overlay 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 (emits selected with detail.value, menu requires ha-dropdown-item); the editor now binds the right event and item element per era, with a native-input fallback covering the ha-textfield removal.
  • 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_update set 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: cleanupDOM no longer deletes Home Assistant's own stylesheets; configs with entity but no state_url no longer crash the render poll; restart() no longer leaks its polling interval during rapid navigation; clearMemes() resets its iteration counter; early loading before the home-assistant element 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 opacity now 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 enabled applies next; inclusion lists act as allowlists (empty lists no longer disable everything).

Update

  1. HACS - Animated Background - Update to 1.1.0
  2. Hard-refresh the browser (Ctrl/Cmd+Shift+R)
  3. If updating manually, replace dist/animated-background.js and delete the sibling .gz so 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

1.1.0 Beta 5 Pre-release
Pre-release

Choose a tag to compare

@imonlinux imonlinux released this 03 Sep 20:13

Fixed

Runtime robustness (crashes and leaks, no behavior change):

  • cleanupDOM no longer deletes Home Assistant's own stylesheets. It removed every <style> element in hui-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 entity but no state_url no 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-assistant element exists, the plugin waits via the existing poll loop instead of dying at startup.

Opacity and per-render state:

  • Single-digit opacity values are no longer off by a factor of ten. Values were concatenated after 0., so opacity: 5 produced 0.50 instead of 0.05. Now computed numerically and clamped to 1-99.
  • Per-view opacity now 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_interval edits 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 srcdoc into 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_users who was also on an excluded_devices list still got the background. Precedence is now explicit and documented in the README:

    1. Any excluded_users / excluded_devices match (root or view/group config) disables the background.
    2. An explicit enabled: true / enabled: false on a view or group config applies next - it can override inclusion lists, never exclusions.
    3. 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.

Update

  1. HACS - Animated Background - Update to 1.1.0 Beta 5 (beta versions enabled)
  2. Hard-refresh the browser (Ctrl/Cmd+Shift+R)
  3. If updating manually, replace dist/animated-background.js and delete the sibling .gz so 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

1.1.0 Beta 4 Pre-release
Pre-release

Choose a tag to compare

@imonlinux imonlinux released this 03 Sep 18:40

Fixed

  • Editor dropdowns did not respond to selection (Views tab, Groups tab). HA 2026.2 rewrote its ha-select component: it now emits a selected event (not change) and its menu only reacts to ha-dropdown-item items. 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

  1. HACS → Animated Background → Update to 1.1.0 Beta 4 (beta versions enabled)
  2. Hard-refresh the browser (Ctrl/Cmd+Shift+R)
  3. If updating manually, replace dist/animated-background.js and delete the sibling .gz so 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

1.1.0 Beta 3 Pre-release
Pre-release

Choose a tag to compare

@imonlinux imonlinux released this 03 Sep 05:51

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_update now 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

v1.1.0-beta.2 Pre-release
Pre-release

Choose a tag to compare

@imonlinux imonlinux released this 03 Sep 01:01

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_interval and refresh_on_update set 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 background option 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

1.1.0 Beta 1 Pre-release
Pre-release

Choose a tag to compare

@imonlinux imonlinux released this 02 Sep 21:09

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.3

overlay 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 overlay and the visual editor
  • console.info version banner (v1.1.0-beta.1) for installed-version identification

Feedback welcome — report issues against the overlay branch.

1.0

1.0

Choose a tag to compare

@imonlinux imonlinux released this 02 Sep 21:09

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.info version 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.