## 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` |
40 lines
1.4 KiB
Markdown
40 lines
1.4 KiB
Markdown
# `automations`
|
|
|
|
Automatically take [actions](actions/README.md) based on [conditions](conditions.md) being met.
|
|
|
|
> [!TIP]
|
|
> To change configuration conditionally use [overrides](overrides.md).
|
|
|
|
```yaml
|
|
automations:
|
|
- conditions:
|
|
- [condition]
|
|
actions:
|
|
- [action]
|
|
actions_not:
|
|
- [action]
|
|
```
|
|
|
|
| Option | Default | Description |
|
|
| ------------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
|
|
| `conditions` | | A list of [conditions](conditions.md) that must evaluate to `true` in order to trigger the automation. |
|
|
| `actions` | | An optional list of [actions](actions/README.md) that will be run when the [conditions](conditions.md) evaluate `true`. |
|
|
| `actions_not` | | An optional list of [actions](actions/README.md) that will be run when the [conditions](conditions.md) evaluate `false`. |
|
|
|
|
# Fully expanded reference
|
|
|
|
[](common/expanded-warning.md ':include')
|
|
|
|
```yaml
|
|
automations:
|
|
- conditions:
|
|
- condition: fullscreen
|
|
fullscreen: true
|
|
actions:
|
|
- action: custom:advanced-camera-card-action
|
|
advanced_camera_card_action: substream_on
|
|
actions_not:
|
|
- action: custom:advanced-camera-card-action
|
|
advanced_camera_card_action: substream_off
|
|
```
|