From 071298ff1bc54b26e82f701458f02418d99c78cf Mon Sep 17 00:00:00 2001 From: Philip Allgaier Date: Mon, 7 Sep 2020 00:23:59 +0200 Subject: [PATCH 1/5] Clarifications for the Spotify integration (#14416) --- source/_integrations/spotify.markdown | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/source/_integrations/spotify.markdown b/source/_integrations/spotify.markdown index 824b8625ebd..5f6e0ba50e7 100644 --- a/source/_integrations/spotify.markdown +++ b/source/_integrations/spotify.markdown @@ -30,11 +30,15 @@ To create the required Spotify application: - Visit the [My Applications](https://developer.spotify.com/my-applications/#!/applications) page. - Select **Create An App**. Enter any name and description. - Once your application is created, view it and copy your **Client ID** and **Client Secret**, which are used in the Home Assistant configuration file. -- Add a **Redirect URI** in one of the following forms: +- On the Spotify page, enter the **Edit Settings** dialog of your newly created application and add a **Redirect URI**: - If you are not using SSL: `http://:/auth/external/callback` - If you are using SSL: `https://:/auth/external/callback` - Click **Save** after adding the URI. +
+ Your Home Assitant instance does not need to be exposed to the internet. It works just fine with local IP addresses. +
+ ## Configuration To add Spotify to your installation, add the following to your `configuration.yaml` file: @@ -61,18 +65,18 @@ client_secret: After you have set up the above: -- Go to the integrations page in the Home Assistant frontend -- Go to **Integrations** +- Go to the **Configurations** page in the Home Assistant frontend. +- Go to **Integrations**. - Add a new **Spotify** integration. - Follow the steps shown to authenticate Home Assistant with your Spotify account.
- If you receive an `INVALID_CLIENT: Invalid redirect URI` error while trying to authenticate with your Spotify account, make sure to check the Redirect URI in the address bar after adding the new integration. Compare this value with the Redirect URL defined in the Spotify Developer Portal. + If you receive an `INVALID_CLIENT: Invalid redirect URI` error while trying to authenticate with your Spotify account, make sure to check the Redirect URI in the address bar after adding the new integration. Compare this value with the Redirect URI defined in the Spotify Developer Portal.
-## URI Links For Playlists +## URI Links for Playlists You can send playlists to Spotify using the `"media_content_type": "playlist"`, which are part of the [media_player.play_media](/integrations/media_player/#service-media_playerplay_media) service. From 117a28a2e3b95496554881a6e5910cfa89c2142e Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 7 Sep 2020 08:53:07 +0200 Subject: [PATCH 2/5] Bump sinatra from 2.0.8.1 to 2.1.0 (#14419) Bumps [sinatra](https://github.com/sinatra/sinatra) from 2.0.8.1 to 2.1.0. - [Release notes](https://github.com/sinatra/sinatra/releases) - [Changelog](https://github.com/sinatra/sinatra/blob/master/CHANGELOG.md) - [Commits](https://github.com/sinatra/sinatra/compare/v2.0.8.1...v2.1.0) Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- Gemfile | 2 +- Gemfile.lock | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/Gemfile b/Gemfile index bda3f75098c..e08d61455ce 100644 --- a/Gemfile +++ b/Gemfile @@ -18,7 +18,7 @@ group :jekyll_plugins do gem 'jekyll-commonmark', '1.3.1' end -gem 'sinatra', '2.0.8.1' +gem 'sinatra', '2.1.0' gem 'nokogiri', '1.10.10' # Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem diff --git a/Gemfile.lock b/Gemfile.lock index 3111dee22e0..b3f27a004e3 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -81,7 +81,7 @@ GEM forwardable-extended (~> 2.6) public_suffix (4.0.6) rack (2.2.3) - rack-protection (2.0.8.1) + rack-protection (2.1.0) rack rake (13.0.1) rb-fsevent (0.10.4) @@ -100,10 +100,10 @@ GEM ffi (~> 1.9) sassc (2.4.0-x64-mingw32) ffi (~> 1.9) - sinatra (2.0.8.1) + sinatra (2.1.0) mustermann (~> 1.0) - rack (~> 2.0) - rack-protection (= 2.0.8.1) + rack (~> 2.2) + rack-protection (= 2.1.0) tilt (~> 2.0) stringex (2.8.5) terminal-table (1.8.0) @@ -130,7 +130,7 @@ DEPENDENCIES nokogiri (= 1.10.10) rake (= 13.0.1) sass-globbing (= 1.1.5) - sinatra (= 2.0.8.1) + sinatra (= 2.1.0) stringex (= 2.8.5) tzinfo (~> 2.0) tzinfo-data From d8f8f06ac35cdc513157214b2d785befbd0b89ae Mon Sep 17 00:00:00 2001 From: Evan Bruhn Date: Mon, 7 Sep 2020 16:54:03 +1000 Subject: [PATCH 3/5] Update Logi Circle docs (#14417) Logitech have updated their form to specify that requests are only processed once per month. --- source/_integrations/logi_circle.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/logi_circle.markdown b/source/_integrations/logi_circle.markdown index 66cced5bff2..f5778bcb0a6 100644 --- a/source/_integrations/logi_circle.markdown +++ b/source/_integrations/logi_circle.markdown @@ -32,7 +32,7 @@ The `logi_circle` implementation allows you to integrate your [Logi Circle](http * At the time you submit your request to Logitech, you need to demonstrate that you have exclusive control of the fully qualified domain name in your redirect URI. An active Home Assistant instance at the redirect URI will suffice. If you don't want to expose your Home Assistant instance publicly, you may also place a static page at the redirect URI with a short message that you will manage redirection of the authorization token to your local Home Assistant instance. Free static hosts that issue subdomains for hosting (e.g., Netlify) are permitted. * As the redirect URI must be public facing, no local/reserved TLDs are permitted (eg. .local, .localhost, .example, etc. are not allowed). -Please note that the turn-around time for API access takes a few business days after which you will be contacted by Logitech using the email address you provided in the form. +Please note that the turn-around time for API access takes up to a month after which you will be contacted by Logitech using the email address you provided in the form. ## Configuration From 1f408c36f0c547dc5407b8480da3ede678b7fe57 Mon Sep 17 00:00:00 2001 From: Bas Nijholt Date: Mon, 7 Sep 2020 19:24:43 +0200 Subject: [PATCH 4/5] add MENU as button option to webos.button service (#14420) --- source/_integrations/webostv.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/webostv.markdown b/source/_integrations/webostv.markdown index d79981272c3..c01d64f4e71 100644 --- a/source/_integrations/webostv.markdown +++ b/source/_integrations/webostv.markdown @@ -184,7 +184,7 @@ Available services: `button`, `command` | Service data attribute | Optional | Description | | ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `entity_id` | no | Target a specific webostv media player. | -| `button` | no | Name of the button. Known possible values are `LEFT`, `RIGHT`, `DOWN`, `UP`, `HOME`, `BACK`, `ENTER`, `DASH`, `INFO`, `ASTERISK`, `CC`, `EXIT`, `MUTE`, `RED`, `GREEN`, `BLUE`, `VOLUMEUP`, `VOLUMEDOWN`, `CHANNELUP`, `CHANNELDOWN`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9` | +| `button` | no | Name of the button. Known possible values are `LEFT`, `RIGHT`, `DOWN`, `UP`, `HOME`, `MENU`, `BACK`, `ENTER`, `DASH`, `INFO`, `ASTERISK`, `CC`, `EXIT`, `MUTE`, `RED`, `GREEN`, `BLUE`, `VOLUMEUP`, `VOLUMEDOWN`, `CHANNELUP`, `CHANNELDOWN`, `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9` | ### Service `webostv.command` From 6e962dc4b9dbf4407c8e3d827038393d0d5f162d Mon Sep 17 00:00:00 2001 From: Johnny Walker Date: Mon, 7 Sep 2020 16:04:12 -0400 Subject: [PATCH 5/5] Clarify preload stream option (#14426) While initially looking at the docs for this, it was not clear what option this paragraph was referencing. This makes it a little more clear what the option is and what it does. --- source/_integrations/camera.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/camera.markdown b/source/_integrations/camera.markdown index c60d11ec573..50530d7e4cd 100644 --- a/source/_integrations/camera.markdown +++ b/source/_integrations/camera.markdown @@ -14,7 +14,7 @@ The camera integration allows you to use IP cameras with Home Assistant. If your camera supports it, and the [`stream`](/integrations/stream) integration is setup, you will be able to stream your cameras in the frontend and on supported media players. -This option will keep the stream alive, and preload the feed on Home Assistant startup. This will result in reduced latency when opening the stream in the frontend, as well as when using the `play_stream` service or Google Assistant integration. It does, however, utilize more resources on your machine, so it is recommended to check CPU usage if you plan to use this feature. +The `Preload stream` option will start the camera feed on Home Assistant startup and continue to keep the stream alive. This will result in reduced latency when opening the stream in the frontend, as well as when using the `play_stream` service or Google Assistant integration. It does, however, utilize more resources on your machine, so it is recommended to check CPU usage if you plan to use this feature.

Screenshot showing Preload Stream option in Home Assistant front end.