Dermot Duffy
cc376a8be1
Whilst the Frigate support in this card is the best among camera engines, the name incorrectly suggests that Frigate is a requirement. Instead, to broaden the appeal, change to more camera agnostic name. This does not suggest any change in priority, role or support for Frigate. This change is likely to be bug prone, due to the size of the rename -- the code contains 1500+ references to "Frigate" most of which make sense to rename, some which do not, all of which needed human assessment. - Closes #1298 BREAKING CHANGE: References to `frigate-card` in all kinds of configuration need to be updated to `advanced-camera-card`. An automated config upgrade should take care of the majority of usecases (click `Edit -> Upgrade -> Save`), though may not be perfect.
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# `profiles`
|
|
|
|
Apply pre-configured sets of defaults to ease card configuration.
|
|
|
|
```yaml
|
|
profiles:
|
|
- [profile_1]
|
|
- [profile_2]
|
|
```
|
|
|
|
?> Since the profiles change the _default_ value of options, setting a profile
|
|
on a pre-existing card could have limited effect if there are options already set by
|
|
the user.
|
|
|
|
?> Profiles are applied top to bottom. If multiple profiles change a configuration default, then the last one "wins"
|
|
|
|
| Profile name | Purpose |
|
|
| ----------------- | ---------------------------------------------- |
|
|
| `casting` | Configure the card to be casted. |
|
|
| `low-performance` | Configure the card for lower end devices. |
|
|
| `scrubbing` | Configure the card to allow "video scrubbing". |
|
|
|
|
## `casting`
|
|
|
|
To aid casting the card to Chromecast devices, the `casting` profile will adjust card defaults to better suit casting. You may wish to combine this the `low-performance` profile below, since Chromecast devices tend to lower performance. To combine, list `low-performance` first, to allow `casting` to take precedence:
|
|
|
|
```yaml
|
|
profiles:
|
|
- low-performance
|
|
- casting
|
|
```
|
|
|
|
## `low-performance`
|
|
|
|
For low end devices, the `low-performance` profile will adjust card defaults to attempt to increase performance.
|
|
|
|
Principles used in the selection of options set by `low-performance` profile mode:
|
|
|
|
- Get 'out of the box' performance similar to the basic "Home Assistant Picture Glance" card.
|
|
- Do not break the visual aesthetic of the card.
|
|
|
|
See the [source code](https://github.com/dermotduffy/advanced-camera-card/blob/main/src/config/profiles/low-performance.ts) for an exhaustive list of defaults set by this profile.
|
|
|
|
## `scrubbing`
|
|
|
|
Configures the `live` view and media viewer to allow media "scrubbing" as the timeline is dragged back and forth.
|
|
|
|
See the [source code](https://github.com/dermotduffy/advanced-camera-card/blob/main/src/config/profiles/scrubbing.ts) for an exhaustive list of options set by this profile.
|
|
|
|
## Fully expanded reference
|
|
|
|
[](common/expanded-warning.md ':include')
|
|
|
|
```yaml
|
|
profiles:
|
|
- casting
|
|
- low-performance
|
|
- scrubbing
|
|
```
|