Files

T

Dermot Duffy f18e4cd4b8 refactor: Unify substream actions into substream_{on,off} (#2497 )

## Summary

- Collapse `live_substream_{on,off,select}` into a unified
`substream_{on,off}` pair, symmetric with `call_{start,end}`.
- Rename the `camera` field on the former `live_substream_select` to
`stream` (it always was a stream ID).
- Add optional `camera` field to both new actions for targeting a
non-selected base camera.
- YAML configs are migrated automatically; URL bookmarks must be updated
by hand.

## Migration

### Cycling between camera and substream (toggle button)

Before:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: live_substream_on
```

After:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: substream_on
```

### Selecting a specific substream

Before:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: live_substream_select
  camera: camera.front_door_hd
```

After:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: substream_on
  stream: camera.front_door_hd
```

### Turning the substream off

Before:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: live_substream_off
```

After:
```yaml
tap_action:
  action: custom:advanced-camera-card-action
  advanced_camera_card_action: substream_off
```

### URL querystrings (manual update required)

| Before | After |
| --- | --- |
|
`?advanced-camera-card-action.live_substream_select=camera.front_door_hd`
| `?advanced-camera-card-action.substream_on=camera.front_door_hd` |

2026-06-30 17:45:13 -07:00

configuration

refactor: Unify substream actions into substream_{on,off} (#2497 )

2026-06-30 17:45:13 -07:00

css

docs: Various docs fixes (#2208 )

2025-10-11 19:44:57 -07:00

images

feat: Add 'call' support to improve 2-way audio experience (#2486 )

2026-06-30 17:45:13 -07:00

docs: Various docs fixes (#2208 )

2025-10-11 19:44:57 -07:00

uml

feat: Add 'call' support to improve 2-way audio experience (#2486 )

2026-06-30 17:45:13 -07:00

usage

refactor: Unify substream actions into substream_{on,off} (#2497 )

2026-06-30 17:45:13 -07:00

_coverpage.md

feat: Add timeline support for folder media (#2197 )

2025-10-04 15:47:39 -07:00

_sidebar.md

Bump prettier to v3 and format all files

2024-06-10 00:29:50 -03:00

.nojekyll

Complete documentation overhaul.

2024-04-01 21:09:20 -07:00

advanced-installation.md

feat: Rename the card to advanced-camera-card (#1873 )

2025-02-06 19:32:32 -08:00

CNAME

Create CNAME

2024-04-24 22:00:23 -07:00

developing.md

docs: Various small documentation improvements (#2386 )

2026-03-01 20:23:59 -08:00

examples.md

refactor: Unify substream actions into substream_{on,off} (#2497 )

2026-06-30 17:45:13 -07:00

index.html

fix: Timeline should should show folder media even without camera support (#2216 )

2025-10-13 21:15:32 -07:00

README.md

feat: Make cameras optional (#2343 )

2026-02-13 20:21:05 -08:00

rolling-back.md

docs: Remove references to card rename process (#2076 )

2025-05-31 14:23:22 -07:00

screenshots.md

docs: Add another worked example of a folder configuration (#2089 )

2025-06-06 14:23:18 -07:00

support.md

fix: Various editor / diagnostic improvements (#2363 )

2026-02-21 09:31:10 -08:00

troubleshooting.md

feat: Auto-resolve Frigate client_id from camera entity (#2475 )

2026-06-30 17:45:12 -07:00

README.md

Getting Started

Installation

HACS is highly recommended to install the card -- it works for all Home Assistant variants. If you don't have HACS installed, start there -- then come back to these instructions.
Find the card in HACS:

Home Assistant > HACS > Frontend > "Explore & Add Integrations" > Advanced Camera Card

Click Download this repository with HACS.

See Advanced Installation for other installation resources, or Rolling Back to rollback to prior versions.

Adding your card

On a Home Assistant dashboard, choose:

[Three dots menu] > Edit dashboard

Click + Add Card shown on the bottom of the screen
Choose Custom: Advanced Camera Card from the list

Initial configuration

Minimal camera configuration

type: custom:advanced-camera-card
cameras:
  - camera_entity: camera.office

Minimal folder configuration

type: custom:advanced-camera-card
folders:
  - type: ha

Video scrubbing configuration

type: custom:advanced-camera-card
cameras:
  - camera_entity: camera.office
profiles:
  - scrubbing

Multi-camera grid configuration

type: custom:advanced-camera-card
cameras:
  - camera_entity: camera.office
  - camera_entity: camera.kitchen
live:
  display:
    mode: grid

See Configuration for full details on supported configuration options.