63 lines
6.2 KiB
Markdown
63 lines
6.2 KiB
Markdown
# Configuration
|
|
|
|
The card supports a myriad of configuration options for simple or complex setups.
|
|
|
|
### Absolute minimum configuration
|
|
|
|
```yaml
|
|
type: custom:advanced-camera-card
|
|
```
|
|
|
|
### Minimal camera configuration
|
|
|
|
```yaml
|
|
type: custom:advanced-camera-card
|
|
cameras:
|
|
- camera_entity: camera.office
|
|
```
|
|
|
|
### Minimal folder configuration
|
|
|
|
```yaml
|
|
type: custom:advanced-camera-card
|
|
folders:
|
|
- type: ha
|
|
```
|
|
|
|
### Configuration blocks
|
|
|
|
#### Top-level configuration blocks
|
|
|
|
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. 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. |
|
|
| [`editor`](editor.md) | Configures the visual card editor. |
|
|
| [`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 folder 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. |
|
|
| [`media_viewer`](media-viewer.md) | Configures the media viewer. |
|
|
| [`menu`](menu.md) | Configures the card menu. |
|
|
| [`overrides`](overrides.md) | Override card configuration when conditions are met. |
|
|
| [`performance`](performance.md) | Configures the card performance. |
|
|
| [`profiles`](profiles.md) | Apply pre-configured sets of defaults to ease card configuration. |
|
|
| [`remote_control`](remote-control.md) | Configures how a card instance can be remotely controlled. |
|
|
| [`status_bar`](status-bar.md) | Configures the card status bar. |
|
|
| [`timeline`](timeline.md) | Configures the `timeline` view. |
|
|
| [`view`](view.md) | Configures the default view and behavior of the card. |
|
|
|
|
#### Common configuration blocks
|
|
|
|
| Option | Description |
|
|
| -------------------------------------- | --------------------- |
|
|
| [`actions`](actions/README.md) | Configure actions. |
|
|
| [`conditions`](conditions-triggers.md) | Configure conditions. |
|