Skip to content

1.1.0

Choose a tag to compare

@imonlinux imonlinux released this 11 Sep 20:40
· 7 commits to master since this release
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.