State Timeline Card for Home Assistant

Share your Projects! Dashboards & Frontend
,
1

State Timeline Card for Home Assistant

A Lovelace card that queries the HA recorder and walks step-by-step through state transitions for a set of selected entities over a time range. Each step shows every selected entity's current state, previous state, and how long it had been there. The entity whose change triggered the step is highlighted.

Functions:

  • Select any combination of entities (by device or individually)
  • Set a time range — presets (10m, 15m, 20m, 24h) or arbitrary
  • Step forward/backward through every state change in the window
  • Expand any row to view the full attribute JSON at that step
  • Mark a start and end step, export the slice as JSON
  • Load a previous export into a side-by-side twin stepper for visual comparison

Use cases:

Derived-state sensors. When the state you care about isn't a single entity but a combination — "dishwasher actually finished," "vacuum stuck mid-run," "garage open with no car." Capture a known instance, read the multi-entity signature off the export, build a template or trigger-based binary_sensor.

Integration porting. Capture canonical events on a known device, side-by-side against a new device via the twin stepper, map analog entities to a canonical event grammar.

Sample signature — Eufy vacuum clean-completion:

  • binary_sensor.alfred_charging off → on (dock contact)
  • +2002ms vacuum.alfred returning → docked
  • +2003ms sensor.alfred_task_status Returning → Completed
  • +2003ms sensor.alfred_work_mode Room → unknown
  • +2032ms binary_sensor.alfred_active_run_has_error on → off

Install: HACS custom repository: kingchddg901/ha-state-timeline-card
Repo + docs: GitHub - kingchddg901/ha-state-timeline-card: Developer-focused Lovelace card for stepping through HA recorder state transitions across multiple entities · GitHub

Limitations:

  • Desktop only
  • Bound by recorder retention (purge_keep_days); warns before searches that exceed it
  • No automated diff between live and reference timelines; comparison is visual by design
1 Like