Skip to content

Commit e464238

Browse files
balloobballoob
committed
Hass.io tweaks
1 parent f5bc651 commit e464238

9 files changed

+50
-22
lines changed

‎source/_addons/duckdns.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
[Duck DNS](https://duckdns.org/) is a free service which will point a DNS (sub domains of duckdns.org) to an IP of your choice.

‎source/_addons/google_assistant.markdown

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,28 @@
11
---
22
layout: page
33
title: "Google Assistant"
4-
description: "Enhance your Hass.io installation with google assistant."
4+
description: "Enhance your Hass.io installation with Google Assistant."
55
date: 2017-04-30 13:28
66
sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

12-
[Google Assistant][GoogleAssistant] is an AI-powered voice assistant that runs on the Raspberry Pi and x86 platforms and interact over [api.ai] with Home-Assistant. You can also use [Google Actions][GoogleActions] to make extended functionality.
13+
[Google Assistant][GoogleAssistant] is an AI-powered voice assistant that runs on the Raspberry Pi and x86 platforms and interact over [api.ai] with Home-Assistant. You can also use [Google Actions][GoogleActions] to extend its functionality.
1314

1415
To enable access to the Google Assistant API, do the following:
15-
1. In the Cloud Platform Console, go to the Projects page. Select an existing project or create a new [project]
16-
2. Enable the Google Assistant [API] on the project you selected
17-
3. Create an [OAuth Client ID][oauthclient] as type "others" and download the json file with arrow done on the right site.
1816

19-
Now install and activate the [Samba] add-on so you can upload your credential file. Connect to the "share" Samba share and copy your training data over. Name the file `google_assistant.json`.
17+
1. In the [Cloud Platform Console][project], go to the Projects page. Select an existing project or create a new project
18+
2. Open the project. In the top of the page search for Google Assistant API or use [this link][API] and enable it.
19+
3. Create an [OAuth Client ID][oauthclient], pick type "Other", click "Create" and download the JSON file by clicking the Download JSON button on the right side.
2020

21-
Now it's time to start Google Assistant for the first time. When the Google Assistant add-on starts, it will output your audio devices:
21+
Now install and activate the [Samba] add-on so you can upload your credential file. Connect to the "share" Samba share and copy your credentials over. Name the file `google_assistant.json`.
2222

23-
```plain
23+
Now it's time to start Google Assistant for the first time. When the Google Assistant add-on starts, it will output your audio devices in the "Logs" card. You might have to hit "refresh" to get the latest logs:
24+
25+
```text
2426
**** List of PLAYBACK Hardware Devices ****
2527
card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
2628
Subdevices: 8/8
@@ -35,20 +37,25 @@ card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
3537
card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
3638
Subdevices: 1/1
3739
Subdevice #0: subdevice #0
40+
card 1: Microphone [Yeti Stereo Microphone], device 0: USB Audio [USB Audio]
41+
Subdevices: 1/1
42+
Subdevice #0: subdevice #0
3843
```
3944

40-
You need to use this information to configure the `mic` and `speaker` configuration options. The format is `<card #>,<device #>`. On a Raspberry Pi 3, `0,0` is the built-in headset port, `0,1` is the HDMI port.
45+
You need to use this information to point the add-on at the right speakers and microphone. The information describes different cards and devices. On a Raspberry Pi 3, card 0 - device 0 is the built-in headset port, card 0 - device 1 is the HDMI port. In the example above, the USB microphone showed up as card 1 - device 0.
4146

42-
We need also connect our Google Assistant with google account. Try open the oauth2 interface with http://hassio.local:9324 and follow the steps on that page.
47+
Find the microphone and speakers that you want to use and note down their device and card number. We will need that to configure the add-on options `mic` (microphone to use) and `speaker` (speaker to use). The format for these options is `<card #>,<device #>`. Change the configuration options and click save.
4348

44-
Now that you've found the microphone and speaker addresses, it's time to configure Google Assistant and restart the add-on.
49+
The next step is to authenticate your Google account with Google Assistant. Start the add-on and click on the "OPEN WEB UI" button to start authentication.
4550

4651
### Add-On configuration
4752

53+
Configuration example that uses the USB microphone and use the built-in headset audio output on the Raspberry Pi. Note that card and device numbers can differ on your device.
54+
4855
```json
4956
{
5057
"mic": "1,0",
51-
"speaker": "1,0",
58+
"speaker": "0,0",
5259
"client_secrets": "google_assistant.json",
5360
}
5461
```

‎source/_addons/lets_encrypt.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
Setup and manage a [Let's Encrypt](https://letsencrypt.org/) certificate. This will create a certificate on the first run and renew it if the certificate is expiring in the next 30 days.

‎source/_addons/mosquitto.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
Set up a [mosquitto](https://mosquitto.org/) MQTT broker.

‎source/_addons/samba.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
This allows you to set up a [Samba](https://samba.org/) server to access hass.io folders using Windows network shares.

‎source/_addons/snips.markdown

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Now install and activate the [Samba] add-on so you can upload your training data
1717

1818
Now it's time to start Snips for the first time. When the Snips add-on starts, it will output your audio devices:
1919

20-
```plain
20+
```text
2121
**** List of PLAYBACK Hardware Devices ****
2222
card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
2323
Subdevices: 8/8
@@ -34,9 +34,11 @@ card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
3434
Subdevice #0: subdevice #0
3535
```
3636

37-
You need to use this information to configure the `mic` and `speaker` configuration options. The format is `<card #>,<device #>`. On a Raspberry Pi 3, `0,0` is the built-in headset port, `0,1` is the HDMI port.
37+
You need to use this information to point the add-on at the right speakers and microphone. The information describes different cards and devices. On a Raspberry Pi 3, card 0 - device 0 is the built-in headset port, card 0 - device 1 is the HDMI port. In the example above, the USB microphone showed up as card 1 - device 0.
3838

39-
Now that you've found the microphone and speaker addresses, it's time to configure Snips and restart the add-on.
39+
Find the microphone and speakers that you want to use and note down their device and card number. We will need that to configure the add-on options `mic` (microphone to use) and `speaker` (speaker to use). The format for these options is `<card #>,<device #>`. Change the configuration options and click save.
40+
41+
Now start the add-on.
4042

4143
### Add-On configuration
4244

‎source/_addons/ssh.markdown

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ sidebar: true
77
comments: false
88
sharing: true
99
footer: true
10+
featured: true
1011
---
1112

1213
Setting up an [SSH](https://openssh.org/) server allows access to your Hass.io folders with any SSH client. It include also a cli to access into Hass.IO api. Try it out:

‎source/addons/index.html

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,17 +12,30 @@
1212

1313
<p>Add-ons for Hass.io allows the user to extend the functionality around Home Assistant. This can be running an application that Home Assistant can integrate with (like an MQTT broker) or to share the configuration via Samba for easy editing from other computers. Add-ons can be configured via the Hass.io panel in Home Assistant.</p>
1414

15+
<p>
16+
Check the Hass.io forums for <a href='https://community.home-assistant.io/tags/hassio-repository'>add-on repositories managed by the community</a>.
17+
</p>
18+
1519
{% assign addons = site.addons | sort: 'title' %}
1620

21+
<h3>{% linkable_title Featured add-ons %}</h3>
22+
1723
<ul>
18-
{% for addon in addons %}
24+
{% for addon in addons %}{% if addon.featured %}
1925
<li>
2026
<a href='{{ addon.url }}'>{{ addon.title }}</a><br>
2127
{{ addon.description }}
2228
</li>
23-
{% endfor %}
29+
{% endif %}{% endfor %}
2430
</ul>
2531

26-
<p>
27-
Check the Hass.io forums for <a href='https://community.home-assistant.io/tags/hassio-repository'>add-on repositories managed by the community</a>.
28-
</p>
32+
<h3>{% linkable_title Other add-ons %}</h3>
33+
34+
<ul>
35+
{% for addon in addons %}{% if addon.featured != true %}
36+
<li>
37+
<a href='{{ addon.url }}'>{{ addon.title }}</a><br>
38+
{{ addon.description }}
39+
</li>
40+
{% endif %}{% endfor %}
41+
</ul>

‎source/hassio/index.markdown

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,14 +21,15 @@ The advantages of using Hass.io:
2121
- Easy installation and updates (powered by [ResinOS] and [Docker])
2222
- Management user interface integrated into Home Assistant
2323
- Easily create and restore full backups of your whole configuration.
24-
- One click install of many popular add-ons including voice assistant via [Snips.ai], encryption via [Let's Encrypt] and dynamic DNS via [Duck DNS].<br><br>[Browse available add-ons &raquo;][all]
25-
- Active community that is helpful and sharing add-ons including AppDaemon, Homebridge and InfluxDB.<br><br>[Browse the forums &raquo;][forums]<br>[Join the Hass.io chat &raquo;][chat]<br>[Browse community add-on repositories &raquo;][comm-add-ons]
24+
- Easily install many popular add-ons including [Google Assistant], encryption via [Let's Encrypt] and dynamic DNS via [Duck DNS].<br><br>[Browse available add-ons &raquo;][all]<br><br>
25+
- Active community that is helpful and sharing add-ons including AppDaemon, Homebridge and InfluxDB.<br><br>[Browse the forums &raquo;][forums]<br>[Join the Hass.io chat &raquo;][chat]<br>[Browse community add-on repositories &raquo;][comm-add-ons]<br><br>
2626

2727
<p class='img'>
2828
<img src='/images/hassio/screenshots/dashboard.png'>
2929
Hass.io dashboard
3030
</p>
3131

32+
[Google Assistant]: /addons/google_assistant/
3233
[Snips.ai]: /addons/snips/
3334
[Let's Encrypt]: /addons/lets_encrypt/
3435
[Duck DNS]: /addons/duckdns/

0 commit comments

Comments
 (0)