feat: Make cameras optional (#2343)

This commit is contained in:
Dermot Duffy
2026-02-13 20:21:05 -08:00
committed by GitHub
parent 21f9469784
commit 93f1f08e51
61 changed files with 1312 additions and 557 deletions
+19 -3
View File
@@ -2,7 +2,13 @@
The card supports a myriad of configuration options for simple or complex setups.
### Minimal configuration
### Absolute minimum configuration
```yaml
type: custom:advanced-camera-card
```
### Minimal camera configuration
```yaml
type: custom:advanced-camera-card
@@ -10,20 +16,30 @@ cameras:
- camera_entity: camera.office
```
### Minimal folder configuration
```yaml
type: custom:advanced-camera-card
folders:
- type: ha
```
### Configuration blocks
#### Top-level configuration blocks
Only the `cameras` option is required, all other parameters are optional.
No top-level option is required. If `cameras` is omitted the card will still
render and can operate in `image` or `folders` views depending on configuration.
| Option | Description |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`automations`](automations.md) | Take action when conditions are met. |
| [`cameras`](cameras/README.md) | Configures the cameras to be used in the card. At least one camera must be specified. |
| [`cameras`](cameras/README.md) | Configures the cameras to be used in the card. Optional. If present, the first listed camera is the default. |
| [`cameras_global`](cameras/README.md) | Global defaults that apply to all cameras from the `cameras` section. |
| `card_id` | An optional ID to uniquely identify this card. For use when actions are being sent to card(s) via [URL actions](../usage/url-actions.md). Must exclusively consist of these characters: `[a-zA-Z0-9_]`. |
| [`dimensions`](dimensions.md) | Configures the overall card dimensions. |
| [`elements`](elements/README.md) | Add custom elements to the card. |
| [`folders`](folders.md) | Configures folders to be used in the card. Optional. If present, the first listed camera is the default. |
| [`image`](image.md) | Configures the `image` view. |
| [`live`](live.md) | Configures the `live` view. |
| [`media_gallery`](media-gallery.md) | Configures the media gallery. |