diff --git a/addons/google_assistant/index.html b/addons/google_assistant/index.html index 43a16bb3be..2db5bcc7be 100644 --- a/addons/google_assistant/index.html +++ b/addons/google_assistant/index.html @@ -8,7 +8,7 @@ Google Assistant - Home Assistant - + @@ -16,12 +16,12 @@ - + - + @@ -75,15 +75,16 @@
-

Google Assistant 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 to make extended functionality.

+

Google Assistant 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 to extend its functionality.

To enable access to the Google Assistant API, do the following:

    -
  1. In the Cloud Platform Console, go to the Projects page. Select an existing project or create a new project
  2. -
  3. Enable the Google Assistant API on the project you selected
  4. -
  5. Create an OAuth Client ID as type “others” and download the json file with arrow done on the right site.
  6. +
  7. In the Cloud Platform Console, go to the Projects page. Select an existing project or create a new project
  8. +
  9. Open the project. In the top of the page search for Google Assistant API or use this link and enable it.
  10. +
  11. Create an OAuth Client ID, pick type “Other”, click “Create” and download the JSON file by clicking the Download JSON button on the right side.
-

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.

-

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:

**** List of PLAYBACK Hardware Devices ****
+

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.

+

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:

+
**** List of PLAYBACK Hardware Devices ****
 card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
   Subdevices: 8/8
   Subdevice #0: subdevice #0
@@ -97,14 +98,19 @@ card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA]
 card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI]
   Subdevices: 1/1
   Subdevice #0: subdevice #0
+card 1: Microphone [Yeti Stereo Microphone], device 0: USB Audio [USB Audio]
+  Subdevices: 1/1
+  Subdevice #0: subdevice #0
 
-

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.

-

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.

-

Now that you’ve found the microphone and speaker addresses, it’s time to configure Google Assistant and restart the add-on.

+
+

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.

+

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.

+

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.

Add-On configuration

+

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.

{
   "mic": "1,0",
-  "speaker": "1,0",
+  "speaker": "0,0",
   "client_secrets": "google_assistant.json",
 }
 
diff --git a/addons/index.html b/addons/index.html index e859fbabad..e2693234b7 100644 --- a/addons/index.html +++ b/addons/index.html @@ -76,6 +76,37 @@

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.

+

+ Check the Hass.io forums for add-on repositories managed by the community. +

+

Featured add-ons

+
    +
  • + Duck DNS
    + Automatically update your Duck DNS IP address. +
  • +
  • + Google Assistant
    + Enhance your Hass.io installation with Google Assistant. +
  • +
  • + Let's Encrypt
    + Automatically manage your SSL certificate using Let's Encrypt. +
  • +
  • + Mosquitto MQTT broker
    + Fast and reliable MQTT broker. +
  • +
  • + SSH Server
    + Allow logging in remotely to Hass.io using SSH. +
  • +
  • + Samba
    + Manage your Home Assistant and custom addons over Samba. +
  • +
+

Other add-ons

  • Bluetooth BCM43xx
    @@ -93,46 +124,19 @@ Dnsmasq
    A simple DNS server.
  • -
  • - Duck DNS
    - Automatically update your Duck DNS IP address. -
  • -
  • - Google Assistant
    - Enhance your Hass.io installation with google assistant. -
  • -
  • - Let's Encrypt
    - Automatically manage your SSL certificate using Let's Encrypt. -
  • MariaDB
    MariaDB Server is one of the most popular database servers in the world.
  • -
  • - Mosquitto MQTT broker
    - Fast and reliable MQTT broker. -
  • Nginx SSL proxy
    Nginx Home Assistant SSL proxy
  • -
  • - SSH Server
    - Allow logging in remotely to Hass.io using SSH. -
  • -
  • - Samba
    - Manage your Home Assistant and custom addons over Samba. -
  • Snips.ai
    Enhance your Hass.io installation with a local voice assistant.
-

- Check the Hass.io forums for add-on repositories managed by the community. -