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.
52 lines
2.1 KiB
Markdown
52 lines
2.1 KiB
Markdown
# Advanced Installation
|
|
|
|
For most users, the installation instructions in the [Getting Started](README.md) section will install the card successfully. In some rarer situations, additional steps may need to be taken.
|
|
|
|
### Manual resource management
|
|
|
|
For most users, HACS should automatically add the necessary resources. Should this auto-registration not work you will need to complete one additional step.
|
|
|
|
#### Lovelace in "Storage Mode" (default)
|
|
|
|
- Navigate:
|
|
|
|
```
|
|
Three dots menu -> "Edit Dashboard" -> Three dots menu -> "Manage resources" -> "Add Resource"
|
|
```
|
|
|
|
- URL: `/hacsfiles/advanced-camera-card/advanced-camera-card.js`
|
|
- Resource type: `JavaScript Module`
|
|
|
|
#### Lovelace in "YAML mode" (rare)
|
|
|
|
You would see`mode: yaml` under `lovelace:` in your `configuration.yaml` if this applies to you.
|
|
|
|
- Add the following to `configuration.yaml`:
|
|
|
|
```yaml
|
|
lovelace:
|
|
resources:
|
|
- url: /hacsfiles/advanced-camera-card/advanced-camera-card.js
|
|
type: module
|
|
```
|
|
|
|
- Restart Home Assistant.
|
|
|
|
### Manual installation
|
|
|
|
- Download the `advanced-camera-card.zip` attachment of the desired [release](https://github.com/dermotduffy/advanced-camera-card/releases) to a location accessible by Home Assistant. Note that the release will have a series of `.js` files (for HACS users) **and** a `advanced-camera-card.zip` for the convenience of manual installers.
|
|
- Unzip the file and move the contents of the `dist/` folder to any subfolder name you'd like, e.g. `advanced-camera-card` is used in the below example.
|
|
- Add the location as a Lovelace resource via the UI, or via [YAML configuration](https://www.home-assistant.io/lovelace/dashboards/#resources) such as:
|
|
|
|
```yaml
|
|
lovelace:
|
|
mode: yaml
|
|
resources:
|
|
- url: /local/advanced-camera-card/advanced-camera-card.js
|
|
type: module
|
|
```
|
|
|
|
### Unreleased versions
|
|
|
|
You can install any unreleased version of the card by leveraging the GitHub Actions artifacts that are generated on every revision. See a [video walkthrough](https://user-images.githubusercontent.com/29582865/228320074-6a2607f5-c637-48d5-b833-a553f8df8f4f.mp4) installing the latest revision of the `release-4.1.0` branch.
|