Skip to content

Commit d7c5161

Browse files
Update hacsintall.md for newer HACS versions
Made changes to reflect updates in Home Assistant and HACS since this guide was written. The main difference is that HACS will now automatically add the location of the js module to the resources, so this doesn't need to be done manually. I've left in the instructions of how to do this manually in a troubleshooting section, in case people are still using older versions. I have no idea when this change was made. There have also been some Home Assistant UI changes that are reflected in this section. Configuration is now called Settings, and Lovelace Dashboards is now simply Dashboards. Based on the initial documentation, I think Resources used to be a tab on this page, but it's now hidden behind a 3 dot menu in the top right. I've tried to cover all bases by leaving the initial instructions as written, while also including instructions for the updated UI.
1 parent c601463 commit d7c5161

File tree

1 file changed

+27
-22
lines changed

1 file changed

+27
-22
lines changed

hacsinstall.md

+27-22
Original file line numberDiff line numberDiff line change
@@ -5,30 +5,17 @@
55
These notes are provided to help with a HACS install if you use the GUI rather than edit yaml.
66

77
1. Install "HACS" as per their documentation [![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg?style=for-the-badge)](https://github.com/custom-components/hacs)
8-
2. Let the HACS addon download its data - this takes at least an hour to fetch data initial due to rate limiting - see HACS documentation
9-
3. Choose HACS from the Sidebar
10-
4. For installation of this card select the HACS ```Frontend``` option
11-
5. Click + and search for "Lovelace Hass Arlo"
12-
6. Choose ```Install this repository in HACS```
8+
2. Let the HACS addon download its data - this takes at least an hour to fetch data initially due to rate limiting - see HACS documentation.
9+
3. Choose HACS from the Sidebar.
10+
4. For installation of this card select the HACS ```Frontend``` option.
11+
5. Click ```+ Explore & Download Repositories``` and search for "Lovelace Hass Arlo".
12+
6. Choose ```Install this repository in HACS```.
1313
7. Choose ```Install```. This completes the installation of the repository.
14-
8. Now enable/install the module in Home Assistant by choosing the Configuration panel
15-
9. Choose ```Lovelace Dashboards``` from the configuration panel
16-
10. Click into the ```Resource``` tab
17-
11. Click ```+``` button to add a new resource and enter:
14+
8. You will be asked to refresh your browser to allow for the updated resources to be used. Click ```Reload``` to do this automatically.
15+
9. Now you should edit your dashboard as usual to add the new card - one for each camera. When adding the aarlo-glance card you will need to choose the ```Manual``` option (bottom of the GUI list of available cards). Editing manually to insert some configuration.
16+
code to match your camera.
1817

19-
```
20-
Url
21-
/hacsfiles/lovelace-hass-aarlo/hass-aarlo.js
22-
23-
Resource Type:
24-
JavaScript Module
25-
```
26-
27-
12. Now you should edit your dashboard as usual to add the new card. One for each camea. When adding the aarlo-glance card you will need to choose the ```Manual``` option (bottom of the GUI list of available cards). Editing manually to insert some configuration
28-
code to match your camera.
29-
30-
Here is a working config for a camera known to Arlo as ```kitchen``` and to Home Assistant as ```camera.aarlo_kitchen```
31-
18+
Here is a working config for a camera known to Arlo as ```kitchen``` and to Home Assistant as ```camera.aarlo_kitchen```:
3219

3320
```
3421
type: 'custom:aarlo-glance'
@@ -48,3 +35,21 @@ Here is a working config for a camera known to Arlo as ```kitchen``` and to Home
4835
image_click: play
4936
```
5037
The options of ```top_title```, ```top_status``` and ```top_date``` can be set to ```true``` if you prefer the indicated information at the top of the card.
38+
39+
### Troubleshooting
40+
Older versions of HACS and/or Home Assistant may not automatically load the resource as required, leading to a ```Custom element doesn't exist: aarlo-glance``` error message when trying to create the card. In that case, you can do it manually:
41+
42+
1. Select ```Settings``` or ```Configuration``` (depending on Home Assistant version) from the Sidebar.
43+
2. Choose ```Dashboards``` or ```Lovelace Dashboards``` from the Settings panel.
44+
3. Select ```Resources``` from the menu in the top right or click into the ```Resource``` tab.
45+
4. Click ```+``` button to add a new resource and enter:
46+
47+
```
48+
Url
49+
/hacsfiles/lovelace-hass-aarlo/hass-aarlo.js
50+
51+
Resource Type:
52+
JavaScript Module
53+
```
54+
55+
You should then be able to add the aarlo-glance element as shown above.

0 commit comments

Comments
 (0)