v1.12.0-rc.1 — Per-Source Grouping & Custom Group Names (pre-release)

Pre-release. Enable "Show beta versions" in HACS to install this build.

Addresses #15.

New Features

• Per-source grouping config. Each source entry can now declare its own grouping block that overrides the card-level grouping for its events. When any source opts in, that source's events are grouped in isolation (events from other sources won't mix into the same group), then merged into the global timeline by timestamp. Sources without an override fall through to a single shared pass using the card-level config — so existing setups are unchanged.
• Custom group summary names. grouping.group_name (card-level or per-source) replaces the auto-generated "N X events" text. Supports {count}, {label}, {source}, and {entity} placeholders.

Bug Fix

• group_by: entity now actually names groups by entity. Previously when all events in an entity-grouped bucket shared a category (commonly default), the summary would render as "5 default events" instead of the entity name. The summary now respects the chosen grouping dimension before falling back to label-agreement.

Editor

YAML-only for this RC. Editor UI for per-source grouping and group_name will land in the stable 1.12.0 release.

Example

type: custom:chronicle-card
sources:
  - type: rest
    name: Frigate
    ws_params:
      type: frigate/events/get
      limit: 30
    grouping:
      window_seconds: 60
      min_group_size: 2
      group_by: category
      group_name: "{count} {label} detections"

  - type: history
    name: Doors
    entities: [binary_sensor.front_door, binary_sensor.back_door]
    grouping:
      group_by: entity
      group_name: "{entity} — {count} events"

grouping:
  window_seconds: 120
  min_group_size: 3
  group_by: category