-
-## Troubleshooting missing entities
-
-### Condition
-
-You are trying to add a sensor to the energy dashboard, but it does not appear in the selection list.
-
-### Resolution
-
-To find out why the sensor is not showing, check the following points:
-- The sensor must have the appropriate attributes. Check your entity attributes in {% my developer_states title="**Developer Tools** > **States**" %} to confirm the following:
- - `device_class` must be `energy` for electricity grid, solar, or battery categories. It must be `gas` for gas, or `water` for water.
- - `state_class` must be `total` or `total_increasing`.
- - The sensor must have an appropriate `unit_of_measurement`. See the help text for each category to see which units are accepted. Units containing an exponent must match superscript characters exactly as defined, e.g. `m³` is accepted, `m3` is not.
-
- If any of the attributes are not correct, please open an issue against the integration that provides your sensor, or if you are developing custom template sensors, make sure the templates have the correct settings.
-
-- The entity must be a `sensor`. If you are trying to add something from another domain (for example an `input_number`), then you must first create a template sensor from it.
-- The entity must not have any statistics errors. Go to {% my developer_statistics title="**Developer Tools** > **Statistics**" %} to check your specific entity. If your unit has a listed issue here, you must fix the issue before it can be added to the dashboard.
diff --git a/source/_docs/energy/faq.markdown b/source/_docs/energy/faq.markdown
index a7979376b48..63406273623 100644
--- a/source/_docs/energy/faq.markdown
+++ b/source/_docs/energy/faq.markdown
@@ -32,3 +32,22 @@ To accomplish such, you can use [the utility_meter integration](/integrations/ut
## The Energy panel is not visible
If you do not see the Energy panel in the sidebar, make sure you have not removed [`default_config:`](/integrations/default_config/) from your `configuration.yaml`. If you have, you will need to add the `energy:` integration manually.
+
+## Troubleshooting missing entities
+
+### Condition
+
+You are trying to add a sensor to the energy dashboard, but it does not appear in the selection list.
+
+### Resolution
+
+To find out why the sensor is not showing, check the following points:
+- The sensor must have the appropriate attributes. Check your entity attributes in {% my developer_states title="**Developer Tools** > **States**" %} to confirm the following:
+ - `device_class` must be `energy` for electricity grid, solar, or battery categories. It must be `gas` for gas, or `water` for water.
+ - `state_class` must be `total` or `total_increasing`.
+ - The sensor must have an appropriate `unit_of_measurement`. See the help text for each category to see which units are accepted. Units containing an exponent must match superscript characters exactly as defined, e.g. `m³` is accepted, `m3` is not.
+
+ If any of the attributes are not correct, please open an issue against the integration that provides your sensor, or if you are developing custom template sensors, make sure the templates have the correct settings.
+
+- The entity must be a `sensor`. If you are trying to add something from another domain (for example an `input_number`), then you must first create a template sensor from it.
+- The entity must not have any statistics errors. Go to {% my developer_statistics title="**Developer Tools** > **Statistics**" %} to check your specific entity. If your unit has a listed issue here, you must fix the issue before it can be added to the dashboard.
diff --git a/source/_docs/locked_out.md b/source/_docs/locked_out.md
index 683ddf854a6..1c656255364 100644
--- a/source/_docs/locked_out.md
+++ b/source/_docs/locked_out.md
@@ -64,13 +64,19 @@ If you are running Home Assistant in a container, you can use the command line i
#### Start a new onboarding process
-If you lose the password associated with the owner account and the steps above do not work to reset the password, the only way to resolve this is to delete *all* the authentication data. You do this by shutting down Home Assistant and deleting the following files from the `.storage/` folder in your [configuration folder](/docs/configuration/):
+If you lose the password associated with the owner account and the steps above do not work to reset the password, the only way to resolve this is to start a new onboarding process. If you have an external backup with an administrator account of which you still know the login credentials, you can restore that backup. If you do not have a backup, resetting the device will erase all data.
-- `auth`
-- `auth_provider.homeassistant`
-- `onboarding`
-- `hassio`
-- `cloud`
+- If you have a Home Assistant Green, [reset the Green](https://green.home-assistant.io/guides/reset/).
+- If you have a Home Assistant Yellow, [reset the Yellow](https://yellow.home-assistant.io/guides/factory-reset/).
+- If you have a Raspberry Pi, delete *all* the authentication data.
+ - Shut down Home Assistant.
+ - Remove your SD card and access it from your PC.
+ - Delete the following files from the `.storage/` folder in your [configuration folder](/docs/configuration/):
+ - `auth`
+ - `auth_provider.homeassistant`
+ - `onboarding`
+ - `hassio`
+ - `cloud`
## Recovering Data for Home Assistant (including Supervised)
diff --git a/source/_includes/asides/component_navigation.html b/source/_includes/asides/component_navigation.html
index 8994813de03..6109c94a186 100644
--- a/source/_includes/asides/component_navigation.html
+++ b/source/_includes/asides/component_navigation.html
@@ -3,11 +3,7 @@
{% assign percentage = 100.0 | times: active_installations | divided_by: site.data.analytics_data.reports_integrations | round: 1 %}
- {%- if page.logo -%}
- 
- {%- else -%}
- {%- endif -%}
{%- if page.ha_config_flow and domain -%}
{% my config_flow_start badge domain=domain %}
diff --git a/source/_integrations/alexa.markdown b/source/_integrations/alexa.markdown
index f2f1b501078..4759d581e5b 100644
--- a/source/_integrations/alexa.markdown
+++ b/source/_integrations/alexa.markdown
@@ -30,7 +30,7 @@ There are a few ways that you can use Amazon Alexa and Home Assistant together.
- Support for viewing and controlling devices with the Alexa mobile app.
- [Create a Custom Alexa Skill to build custom commands](/integrations/alexa.intent/)
- [Create a new Flash Briefing source](/integrations/alexa.flash_briefings/)
-- Alternative: use the [Emulated Hue integration](/integrations/emulated-hue) to trick Alexa into thinking Home Assistant is a Philips Hue hub.
+- Alternative: use the [Emulated Hue integration](/integrations/emulated_hue) to trick Alexa into thinking Home Assistant is a Philips Hue hub.
### Requirements
diff --git a/source/_integrations/blebox.markdown b/source/_integrations/blebox.markdown
index 2bf5e29769b..80d1fca6f9b 100644
--- a/source/_integrations/blebox.markdown
+++ b/source/_integrations/blebox.markdown
@@ -28,71 +28,554 @@ ha_zeroconf: true
For the best experience, make sure your BleBox devices have the most recent available firmware installed.
-Additionally, if you are configuring a gateBox, it may be useful to set the second button as "stop" in your device's settings (via website or phone app).
-## Covers
+## BleBox controllers
-This integration adds the BleBox device as a cover in Home Assistant.
+### rollerGate
-Currently, this includes support for the following product classes:
+This integration adds the Blebox device as a cover entity to Home Assistant.
-- BleBox shutterBox
-- BleBox rollerGate
-- BleBox gateBox
+#### Key supported features
-Set of features includes tilt support for shutterBox.
+- Open
+- Close
+- Position
+- Stop
-## Binary sensors
-This integration adds BleBox device as a binary_sensor in Home Assistant.
+### gateBox
-Currently, this includes support for the following product classes:
+This integration adds the Blebox device as a cover entity to Home Assistant.
-- BleBox rainSensor
-- BleBox wind&rainSensor
+#### Key supported features
-## Sensors
+- Open (trigger primary output)
+- Close (trigger primary output)
+- Stop (trigger secondary output)
+- Gate state (open, close, unknown)
-This integration adds the BleBox device as a sensor in Home Assistant.
+#### Additional features
-Currently, this includes support for the following product classes and their features:
+- "stop" requires setting your device's secondary trigger as stop (via website or phone app).
-- BleBox tempSensor (temperature only)
-- Blebox humiditySensor
-- BleBox airSensor
+### gateBox Pro
-## Switches
+This integration adds the Blebox device as a cover entity to Home Assistant.
-This integration adds the BleBox device as a switch (or multiple switches) in Home Assistant.
+#### Key supported features
-Currently, this includes support for the following product classes:
+- Open (trigger primary output)
+- Close (trigger primary output)
+- Stop (trigger secondary output)
+- Gate state (open, close, unknown)
-- BleBox switchBox
-- BleBox switchBoxD
+#### Additional features
-## Climate
+- "stop" requires setting your device's secondary trigger as stop (via website or phone app).
-This integration adds the BleBox device as a climate in Home Assistant.
+### doorBox
-Currently, this includes support for the following product classes:
+This integration adds the Blebox device as a cover entity to Home Assistant.
-- BleBox saunaBox
-- BleBox thermoBox
+#### Key supported features
+- Open
+- Door state (open, close, unknown)
-## Lights
+### saunaBox
-This integration adds the BleBox device as a light in Home Assistant.
+This integration adds the Blebox device as a climate entity to Home Assistant.
-Currently, the following product classes are supported:
+#### Key supported features
-- BleBox dimmerBox
-- BleBox wLightBoxS
-- BleBox wLightBox
+- On
+- Off
+- Setting target temperature
+- Read current temperature
-## Button
+### thermoBox
-This integration adds the BleBox device as a button in Home Assistant
+This integration adds the Blebox device as a climate entity to Home Assistant.
-Currently, this includes support for the following product classes:
+#### Key supported features
-- BleBox tvLiftBox
+- On
+- Off
+- Set target temperature
+- Read current temperature
+
+#### Additional features
+
+- Changing operation mode (cooling/heating) requires direct access to device or from wBox app
+
+### shutterBox
+
+This integration adds the Blebox device as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### shutterBoxDC
+
+This integration adds the Blebox device as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### shutterBox DIN
+
+This integration adds the Blebox device as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### switchBox
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Energy consumption measurement
+
+### switchBox DIN
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Energy consumption measurement
+
+### switchBoxD
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Energy consumption measurement
+
+### switchBoxD DIN
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Energy consumption measurement
+
+### switchBoxDC
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### switchBox LIGHT
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### switchBoxT PRO
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### dimmerBox
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Brightness
+
+### wLightBox
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+#### Additional features
+
+- Changing color mode available from direct device access or wBox app. Device needs to be reloaded from Home Assistant.
+
+### wLightBox PRO
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+#### Additional features
+
+- Changing color mode available from direct device access or wBox app. Device needs to be reloaded from Home Assistant.
+
+### wLightBoxS
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+
+### wLightBoxS PRO
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+
+### pixelBox
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### tempSensor
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of temperature
+
+### tempSensorAC
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of temperature for all probes
+
+### tempSensor PRO
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of temperature for all probes
+
+### humiditySensor
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of humidity
+- Periodic read of temperature
+
+### wind&RainSensor
+
+This integration adds the Blebox device as a sensor & binary sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of current wind speed
+- Periodic read of state of rain detection
+
+### rainSensor
+
+This integration adds the Blebox device as a binary sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of state of rain detection
+
+### airSensor
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of:
+ - pm1
+ - pm2.5
+ - pm10
+
+### windSensor PRO
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of current wind speed
+
+------
+
+## "BleBox inside" controllers
+
+### Simon 54 GO SHUTTER
+
+This integration adds the Simon 54 GO device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### Simon 54 GO SWITCH
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### Simon 54 GO SWITCH D
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### Simon 54 GO LED 230V (dimmer)
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Brightness
+
+### Simon 54 GO LED MONO
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### Simon 54 GO RGBW
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### Simon 55 GO SHUTTER
+
+This integration adds the Simon 55 GO device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### Simon 55 GO SWITCH
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### Simon 55 GO SWITCH D
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Brightness
+
+### Simon 55 GO LED 230V (dimmer)
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Brightness
+
+### Simon 55 GO LED MONO
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### Simon 55 GO RGBW
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### FAKRO FTP-V/FTU-V WiFi
+
+This integration adds the Fakro device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+
+### FAKRO ARF/ARP WiFi
+
+This integration adds the Fakro device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+
+### FAKRO ARZ/AMZ/VMZ WiFi
+
+This integration adds the Fakro device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+
+### SABAJ TV K-SMRT-4 - WIFI RJ-45
+
+This integration adds the SABAJ device ("blebox inside") as a button entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Up
+- Down
+- Fav
+
+### Wiśniowski RiCo
+
+This integration adds the Wiśniowski device ("blebox inside") as a cover entity to Home Assistant.
+
+- Open (trigger primary output)
+- Close (trigger primary output)
+- Stop (trigger secondary output)
+- Gate state (open, close, unknown) - only Pro version
+
+#### Additional features
+
+- "stop" requires setting your device's secondary trigger as stop (via website or phone app)
+
+### Polfendo smartGateControl
+
+This integration adds the Polfendo device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Stop
+
+### Plast-met SMART LIGHT BOSSPIO
+
+This integration adds the Plast-met device ("blebox inside") as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+
+### Plast-met SMART LIGHT SIMPIO
+
+This integration adds the Plast-met device ("blebox inside") as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+
+### Tedee relay module
+
+This integration adds the Tedee device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Door state (open, close, unknown)
diff --git a/source/_integrations/daikin.markdown b/source/_integrations/daikin.markdown
index 0f9abe77ffd..18f279e3054 100644
--- a/source/_integrations/daikin.markdown
+++ b/source/_integrations/daikin.markdown
@@ -45,7 +45,8 @@ There is currently support for the following device types within Home Assistant:
/python_scripts` folder. Using the above Python script as an example, the `services.yaml` file would look like:
diff --git a/source/_integrations/remote.markdown b/source/_integrations/remote.markdown
index f8d38397a68..75d0f0c453e 100644
--- a/source/_integrations/remote.markdown
+++ b/source/_integrations/remote.markdown
@@ -16,6 +16,8 @@ Keeps track which remotes are in your environment, their state and allows you to
- Maintains a state per remote and a combined state `all_remotes`.
- Registers services `remote/turn_on`, `remote/turn_off`, `remote/toggle`, and `remote/send_command` to control remotes.
+{% include integrations/building_block_integration.md %}
+
### Use the services
Go to the **Developer Tools**, then to **Call Service** in the frontend, and choose `remote/turn_on`, `remote/turn_off`, or `remote/toggle` from the list of available services (**Available services:** on the left). Enter something like the sample below into the **Service Data** field and hit **Call Service**.
diff --git a/source/_integrations/roku.markdown b/source/_integrations/roku.markdown
index 3dcd701713b..d92b31ac29c 100644
--- a/source/_integrations/roku.markdown
+++ b/source/_integrations/roku.markdown
@@ -148,49 +148,6 @@ action:
media_content_type: channel
```
-## Play on Roku
-
-The `media_player.play_media` service may be used to send media URLs (primarily videos) for direct playback on your device. This feature makes use of the built-in PlayOnRoku application.
-
-| Service data attribute | Optional | Description | Example |
-| ---------------------- | -------- | ----------- | ------- |
-| `entity_id` | no | Target a specific media player. |
-| `media_content_id` | no | A media URL. | http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4
-| `media_content_type` | no | A media type. | `url`
-| `extra.format` | no | A media format. Should be one of `mp4` (supports mov and m4v), `mp3`, `hls`, `ism` (smooth streaming), `dash` (MPEG-DASH), `mkv`, `mka`, `mks` | `mp4`
-| `extra.name` | yes | A name for the media. | Big Buck Bunny
-| `extra.thumbnail` | yes | A thumbnail URL for the media. |
-| `extra.artist_name` | yes | The name of the media artist. | Blender
-
-### Example
-
-```yaml
-action:
- - service: media_player.play_media
- target:
- entity_id: media_player.roku
- data:
- media_content_id: http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4
- media_content_type: url
- extra:
- format: mp4
- name: Big Buck Bunny
-```
-
-## Camera Stream Integration
-
-The `camera.play_stream` service may be used to send camera streams (HLS) directly to your device. This feature requires the `stream` integration and makes use of the built-in PlayOnRoku application.
-
-### Example
-```yaml
-action:
- service: camera.play_stream
- target:
- entity_id: camera.camera
- data:
- media_player: media_player.roku
-```
-
## Content Deeplinking
The `media_player.play_media` service may be used to deep link to content within an application.
diff --git a/source/_integrations/scene.markdown b/source/_integrations/scene.markdown
index 2d334127b13..a4f2b526d90 100644
--- a/source/_integrations/scene.markdown
+++ b/source/_integrations/scene.markdown
@@ -14,6 +14,8 @@ ha_integration_type: entity
A scene entity is an entity that can restore the state of a group of entities.
Scenes can be user-defined or can be provided through an integration.
+{% include integrations/building_block_integration.md %}
+
## The state of a scene
The scene entity is stateless, as in, it cannot have a state like the `on` or
diff --git a/source/_integrations/select.markdown b/source/_integrations/select.markdown
index ab9e125b9a0..1c1f0651027 100644
--- a/source/_integrations/select.markdown
+++ b/source/_integrations/select.markdown
@@ -15,6 +15,8 @@ Keeps track on `select` entities in your environment, their state, and allows
you to control them. This integration allows other integrations to offer
a limited set of selectable options for the entity.
+{% include integrations/building_block_integration.md %}
+
## Services
The select entity exposes additional services to control the entity in, for example,
diff --git a/source/_integrations/siren.markdown b/source/_integrations/siren.markdown
index 7c74ec7a537..617cf044e10 100644
--- a/source/_integrations/siren.markdown
+++ b/source/_integrations/siren.markdown
@@ -14,7 +14,7 @@ ha_integration_type: entity
The Siren integration is built for the controlling and monitoring of siren/chime devices.
-Siren entities are created automatically by integrations that support them.
+{% include integrations/building_block_integration.md %}
## Services
diff --git a/source/_integrations/stt.markdown b/source/_integrations/stt.markdown
index 5fcd4d483f1..bb6c40df04d 100644
--- a/source/_integrations/stt.markdown
+++ b/source/_integrations/stt.markdown
@@ -13,7 +13,7 @@ ha_integration_type: entity
A speech-to-text (STT) entity allows other integrations or applications to stream speech data to the STT API and get text back.
-The speech-to-text entities cannot be implemented manually, but can be provided by integrations.
+{% include integrations/building_block_integration.md %}
## The state of a speech-to-text entity
diff --git a/source/_integrations/switch.markdown b/source/_integrations/switch.markdown
index b5a847ddf31..ba6ceba41f2 100644
--- a/source/_integrations/switch.markdown
+++ b/source/_integrations/switch.markdown
@@ -18,6 +18,8 @@ Keeps track which switches are in your environment, their state and allows you t
- Maintains a state per switch and a combined state `all_switches`.
- Registers services `switch.turn_on`, `switch.turn_off`, and `switch.toggle` to control switches.
+{% include integrations/building_block_integration.md %}
+
## Device Class
The way these switches are displayed in the frontend can be modified in the [customize section](/docs/configuration/customizing-devices/). The following device classes are supported for switches:
diff --git a/source/_integrations/switchbot_cloud.markdown b/source/_integrations/switchbot_cloud.markdown
index 661224d3fea..bd5c28c4e67 100644
--- a/source/_integrations/switchbot_cloud.markdown
+++ b/source/_integrations/switchbot_cloud.markdown
@@ -21,7 +21,7 @@ The SwitchBot Cloud integration allows you to control SwitchBot [devices](https:
## Prerequisites
-In order to use this integration, you will need at least a SwitchBot Hub and a SwitchBot account to get a token and secret key from the SwitchBot mobile app in Profiles>Preferences>Developer Options.
+In order to use this integration, you will need at least a SwitchBot Hub and a SwitchBot account to get a token and secret key from the SwitchBot mobile app in **Profiles** > **Preferences** > **Developer Options**. If **Developer Options** is not present in preferences, tap the App Version (e.g. 6.24) several times (5~15 times) in succession to open the **Developer Options**.
Please note, device names configured in the SwitchBot app are transferred into Home Assistant.
@@ -31,7 +31,7 @@ Please note, device names configured in the SwitchBot app are transferred into H
- Plug (Wi-Fi only, only available in Japan)
- Plug Mini, both the original and HomeKit-enabled
-- Remotes exposed through the different hubs excepted "Others" (State is inferred from previous commands in Home Assistant and might not reflect reality if you use other ways to control the device)
+- IR appliances exposed through the different hubs excepted "Others" (State is inferred from previous commands in Home Assistant and might not reflect reality if you use other ways to control the device)
- {%- else -%}
- {%- endif -%}
{%- if page.ha_config_flow and domain -%}
{% my config_flow_start badge domain=domain %}
diff --git a/source/_integrations/alexa.markdown b/source/_integrations/alexa.markdown
index f2f1b501078..4759d581e5b 100644
--- a/source/_integrations/alexa.markdown
+++ b/source/_integrations/alexa.markdown
@@ -30,7 +30,7 @@ There are a few ways that you can use Amazon Alexa and Home Assistant together.
- Support for viewing and controlling devices with the Alexa mobile app.
- [Create a Custom Alexa Skill to build custom commands](/integrations/alexa.intent/)
- [Create a new Flash Briefing source](/integrations/alexa.flash_briefings/)
-- Alternative: use the [Emulated Hue integration](/integrations/emulated-hue) to trick Alexa into thinking Home Assistant is a Philips Hue hub.
+- Alternative: use the [Emulated Hue integration](/integrations/emulated_hue) to trick Alexa into thinking Home Assistant is a Philips Hue hub.
### Requirements
diff --git a/source/_integrations/blebox.markdown b/source/_integrations/blebox.markdown
index 2bf5e29769b..80d1fca6f9b 100644
--- a/source/_integrations/blebox.markdown
+++ b/source/_integrations/blebox.markdown
@@ -28,71 +28,554 @@ ha_zeroconf: true
For the best experience, make sure your BleBox devices have the most recent available firmware installed.
-Additionally, if you are configuring a gateBox, it may be useful to set the second button as "stop" in your device's settings (via website or phone app).
-## Covers
+## BleBox controllers
-This integration adds the BleBox device as a cover in Home Assistant.
+### rollerGate
-Currently, this includes support for the following product classes:
+This integration adds the Blebox device as a cover entity to Home Assistant.
-- BleBox shutterBox
-- BleBox rollerGate
-- BleBox gateBox
+#### Key supported features
-Set of features includes tilt support for shutterBox.
+- Open
+- Close
+- Position
+- Stop
-## Binary sensors
-This integration adds BleBox device as a binary_sensor in Home Assistant.
+### gateBox
-Currently, this includes support for the following product classes:
+This integration adds the Blebox device as a cover entity to Home Assistant.
-- BleBox rainSensor
-- BleBox wind&rainSensor
+#### Key supported features
-## Sensors
+- Open (trigger primary output)
+- Close (trigger primary output)
+- Stop (trigger secondary output)
+- Gate state (open, close, unknown)
-This integration adds the BleBox device as a sensor in Home Assistant.
+#### Additional features
-Currently, this includes support for the following product classes and their features:
+- "stop" requires setting your device's secondary trigger as stop (via website or phone app).
-- BleBox tempSensor (temperature only)
-- Blebox humiditySensor
-- BleBox airSensor
+### gateBox Pro
-## Switches
+This integration adds the Blebox device as a cover entity to Home Assistant.
-This integration adds the BleBox device as a switch (or multiple switches) in Home Assistant.
+#### Key supported features
-Currently, this includes support for the following product classes:
+- Open (trigger primary output)
+- Close (trigger primary output)
+- Stop (trigger secondary output)
+- Gate state (open, close, unknown)
-- BleBox switchBox
-- BleBox switchBoxD
+#### Additional features
-## Climate
+- "stop" requires setting your device's secondary trigger as stop (via website or phone app).
-This integration adds the BleBox device as a climate in Home Assistant.
+### doorBox
-Currently, this includes support for the following product classes:
+This integration adds the Blebox device as a cover entity to Home Assistant.
-- BleBox saunaBox
-- BleBox thermoBox
+#### Key supported features
+- Open
+- Door state (open, close, unknown)
-## Lights
+### saunaBox
-This integration adds the BleBox device as a light in Home Assistant.
+This integration adds the Blebox device as a climate entity to Home Assistant.
-Currently, the following product classes are supported:
+#### Key supported features
-- BleBox dimmerBox
-- BleBox wLightBoxS
-- BleBox wLightBox
+- On
+- Off
+- Setting target temperature
+- Read current temperature
-## Button
+### thermoBox
-This integration adds the BleBox device as a button in Home Assistant
+This integration adds the Blebox device as a climate entity to Home Assistant.
-Currently, this includes support for the following product classes:
+#### Key supported features
-- BleBox tvLiftBox
+- On
+- Off
+- Set target temperature
+- Read current temperature
+
+#### Additional features
+
+- Changing operation mode (cooling/heating) requires direct access to device or from wBox app
+
+### shutterBox
+
+This integration adds the Blebox device as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### shutterBoxDC
+
+This integration adds the Blebox device as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### shutterBox DIN
+
+This integration adds the Blebox device as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### switchBox
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Energy consumption measurement
+
+### switchBox DIN
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Energy consumption measurement
+
+### switchBoxD
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Energy consumption measurement
+
+### switchBoxD DIN
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Energy consumption measurement
+
+### switchBoxDC
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### switchBox LIGHT
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### switchBoxT PRO
+
+This integration adds the Blebox device as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### dimmerBox
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Brightness
+
+### wLightBox
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+#### Additional features
+
+- Changing color mode available from direct device access or wBox app. Device needs to be reloaded from Home Assistant.
+
+### wLightBox PRO
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+#### Additional features
+
+- Changing color mode available from direct device access or wBox app. Device needs to be reloaded from Home Assistant.
+
+### wLightBoxS
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+
+### wLightBoxS PRO
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+
+### pixelBox
+
+This integration adds the Blebox device as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### tempSensor
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of temperature
+
+### tempSensorAC
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of temperature for all probes
+
+### tempSensor PRO
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of temperature for all probes
+
+### humiditySensor
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of humidity
+- Periodic read of temperature
+
+### wind&RainSensor
+
+This integration adds the Blebox device as a sensor & binary sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of current wind speed
+- Periodic read of state of rain detection
+
+### rainSensor
+
+This integration adds the Blebox device as a binary sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of state of rain detection
+
+### airSensor
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of:
+ - pm1
+ - pm2.5
+ - pm10
+
+### windSensor PRO
+
+This integration adds the Blebox device as a sensor entity to Home Assistant.
+
+#### Key supported features
+
+- Periodic read of current wind speed
+
+------
+
+## "BleBox inside" controllers
+
+### Simon 54 GO SHUTTER
+
+This integration adds the Simon 54 GO device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### Simon 54 GO SWITCH
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### Simon 54 GO SWITCH D
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### Simon 54 GO LED 230V (dimmer)
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Brightness
+
+### Simon 54 GO LED MONO
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### Simon 54 GO RGBW
+
+This integration adds the Simon 54 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### Simon 55 GO SHUTTER
+
+This integration adds the Simon 55 GO device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Tilt regulation
+
+### Simon 55 GO SWITCH
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+
+### Simon 55 GO SWITCH D
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Brightness
+
+### Simon 55 GO LED 230V (dimmer)
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Brightness
+
+### Simon 55 GO LED MONO
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### Simon 55 GO RGBW
+
+This integration adds the Simon 55 GO device ("blebox inside") as a switch entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+- Color
+
+### FAKRO FTP-V/FTU-V WiFi
+
+This integration adds the Fakro device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+
+### FAKRO ARF/ARP WiFi
+
+This integration adds the Fakro device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+
+### FAKRO ARZ/AMZ/VMZ WiFi
+
+This integration adds the Fakro device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+
+### SABAJ TV K-SMRT-4 - WIFI RJ-45
+
+This integration adds the SABAJ device ("blebox inside") as a button entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Up
+- Down
+- Fav
+
+### Wiśniowski RiCo
+
+This integration adds the Wiśniowski device ("blebox inside") as a cover entity to Home Assistant.
+
+- Open (trigger primary output)
+- Close (trigger primary output)
+- Stop (trigger secondary output)
+- Gate state (open, close, unknown) - only Pro version
+
+#### Additional features
+
+- "stop" requires setting your device's secondary trigger as stop (via website or phone app)
+
+### Polfendo smartGateControl
+
+This integration adds the Polfendo device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Close
+- Position
+- Stop
+
+### Plast-met SMART LIGHT BOSSPIO
+
+This integration adds the Plast-met device ("blebox inside") as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+
+### Plast-met SMART LIGHT SIMPIO
+
+This integration adds the Plast-met device ("blebox inside") as a light entity to Home Assistant.
+
+#### Key supported features
+
+- On
+- Off
+- Effects
+- Brightness
+
+### Tedee relay module
+
+This integration adds the Tedee device ("blebox inside") as a cover entity to Home Assistant.
+
+#### Key supported features
+
+- Open
+- Door state (open, close, unknown)
diff --git a/source/_integrations/daikin.markdown b/source/_integrations/daikin.markdown
index 0f9abe77ffd..18f279e3054 100644
--- a/source/_integrations/daikin.markdown
+++ b/source/_integrations/daikin.markdown
@@ -45,7 +45,8 @@ There is currently support for the following device types within Home Assistant:
- The integration for BRP072Cxx and SKYFi based units need API-key / password respectively. The API-key/password can be found on a sticker under the front cover. The other models are auto detected and the API-key and password field must be left empty.
-
+- BRP084Cxx firmware update from 1.19.0 to 2.8.0 breaks local API there is however ongoing work in fixing local API support again.
+
{% include integrations/config_flow.md %}
diff --git a/source/_integrations/fully_kiosk.markdown b/source/_integrations/fully_kiosk.markdown
index 80e4a008d25..4e4f50e55e0 100644
--- a/source/_integrations/fully_kiosk.markdown
+++ b/source/_integrations/fully_kiosk.markdown
@@ -104,7 +104,6 @@ Example:
```yaml
service: fully_kiosk.set_config
data:
- config_type: "string"
key: "startURL"
value: "https://home-assistant.io"
target:
diff --git a/source/_integrations/gogogate2.markdown b/source/_integrations/gogogate2.markdown
index 6a78f841efe..deb5778a315 100644
--- a/source/_integrations/gogogate2.markdown
+++ b/source/_integrations/gogogate2.markdown
@@ -1,7 +1,6 @@
---
title: Gogogate2 and ismartgate
description: Instructions on how to integrate Gogogate2 and iSmartGate enabled garage door covers into Home Assistant.
-logo: gogogate2.png
ha_category:
- Cover
ha_release: 0.67
diff --git a/source/_integrations/humidifier.markdown b/source/_integrations/humidifier.markdown
index b191bea12bc..aad629b275c 100644
--- a/source/_integrations/humidifier.markdown
+++ b/source/_integrations/humidifier.markdown
@@ -14,6 +14,8 @@ ha_integration_type: entity
The `humidifier` integration is built for the controlling and monitoring of humidifiers, dehumidifiers, and hygrostat devices.
+{% include integrations/building_block_integration.md %}
+
## Services
### Humidifier services
diff --git a/source/_integrations/idasen_desk.markdown b/source/_integrations/idasen_desk.markdown
index 0aa5a09bd33..c39af75ff9b 100644
--- a/source/_integrations/idasen_desk.markdown
+++ b/source/_integrations/idasen_desk.markdown
@@ -17,6 +17,14 @@ ha_codeowners:
The IKEA IDÅSEN integration allows you to connect your IKEA Idåsen motorized desk to Home Assistant, making it possible to control the desk height and also monitor height changes from the physical controller.
+
+
+The recommended way to connect the desk to Home Assistant is by using an [ESPHome Bluetooth Proxy](https://esphome.io/projects/?type=bluetooth), as they provide the best experience.
+
+If you are not using an ESPHome Bluetooth Proxy, you need to keep `bluetoothctl` (or any other Bluetooth Agent) open during the integration setup, or it will fail to authenticate with the desk. The connection process is also less reliable than with ESPHome, so you may need to retry a few times until it succeeds. This is due to a limitation in the third-party Bluetooth implementation used by Home Assistant.
+
+
+
{% include integrations/config_flow.md %}
Home Assistant will display a list of addresses of the available desks, and you just need to select the one you want to add. Repeat the process to add more than one desk.
diff --git a/source/_integrations/image.markdown b/source/_integrations/image.markdown
index bdf166fc27f..7097886e32a 100644
--- a/source/_integrations/image.markdown
+++ b/source/_integrations/image.markdown
@@ -12,3 +12,5 @@ ha_integration_type: entity
---
The image integration allows other integrations to display a static image.
+
+{% include integrations/building_block_integration.md %}
diff --git a/source/_integrations/image_processing.markdown b/source/_integrations/image_processing.markdown
index bce1b363b72..fb4a055e030 100644
--- a/source/_integrations/image_processing.markdown
+++ b/source/_integrations/image_processing.markdown
@@ -13,6 +13,8 @@ ha_integration_type: entity
Image processing enables Home Assistant to process images from [cameras](/integrations/#camera). Only camera entities are supported as sources.
+{% include integrations/building_block_integration.md %}
+
## ALPR
ALPR entities have a vehicle counter attribute `vehicles` and all found plates are stored in the `plates` attribute.
diff --git a/source/_integrations/lawn_mower.markdown b/source/_integrations/lawn_mower.markdown
index bb4c531949c..3148f38b080 100644
--- a/source/_integrations/lawn_mower.markdown
+++ b/source/_integrations/lawn_mower.markdown
@@ -13,7 +13,7 @@ ha_integration_type: entity
The lawn mower integration allows the control of robotic lawn mowers to be reflected within Home Assistant.
-Please note, the lawn mower integration cannot be directly used; you cannot create your own lawn mower entities using this integration. This integration is a building block for other integrations to use, enabling them to create lawn mower entities for you.
+{% include integrations/building_block_integration.md %}
## Services
diff --git a/source/_integrations/lifx_cloud.markdown b/source/_integrations/lifx_cloud.markdown
index e7837e27444..6c137206b75 100644
--- a/source/_integrations/lifx_cloud.markdown
+++ b/source/_integrations/lifx_cloud.markdown
@@ -1,7 +1,6 @@
---
title: LIFX Cloud
description: Instructions on using native LIFX scenes with Home Assistant.
-logo: lifx.png
ha_category:
- Scene
ha_iot_class: Cloud Push
diff --git a/source/_integrations/light.markdown b/source/_integrations/light.markdown
index 9afd06bcc89..6c530a915a4 100644
--- a/source/_integrations/light.markdown
+++ b/source/_integrations/light.markdown
@@ -13,6 +13,8 @@ ha_integration_type: entity
This integration allows you to track and control various light bulbs. Read the integration documentation for your particular light hardware to learn how to enable it.
+{% include integrations/building_block_integration.md %}
+
### Default turn-on values
To set the default color, brightness and transition values when the light is turned on, create a custom `light_profiles.csv`, normally located in the default configuration folder where you find `configuration.yaml`.
diff --git a/source/_integrations/lock.markdown b/source/_integrations/lock.markdown
index 5b9178d05a6..406e67abd81 100644
--- a/source/_integrations/lock.markdown
+++ b/source/_integrations/lock.markdown
@@ -16,6 +16,8 @@ Keeps track which locks are in your environment, their state and allows you to c
- Maintains a state per lock and a combined state `all_locks`.
- Registers services `lock.lock`, `lock.unlock` and `lock.open` (unlatch) to control locks.
+{% include integrations/building_block_integration.md %}
+
### Services
A lock integration provides the following services:
diff --git a/source/_integrations/mailbox.markdown b/source/_integrations/mailbox.markdown
index 2b060fe92c0..c634d11a1be 100644
--- a/source/_integrations/mailbox.markdown
+++ b/source/_integrations/mailbox.markdown
@@ -13,3 +13,5 @@ Mailboxes provide a list of messages with short information about each. Mailbox
Home Assistant currently supports only the [Asterisk Voicemail](/integrations/asterisk_mbox/) mailbox.
Each mailbox also provides an entity to indicate the number of messages available on the main page.
+
+{% include integrations/building_block_integration.md %}
diff --git a/source/_integrations/medcom_ble.markdown b/source/_integrations/medcom_ble.markdown
index 668520810ff..4d40e870f9a 100644
--- a/source/_integrations/medcom_ble.markdown
+++ b/source/_integrations/medcom_ble.markdown
@@ -24,7 +24,7 @@ This integration supports the Medcom [Inspector BLE](https://medcom.com/product/
{% include integrations/config_flow.md %}
-The Medcom Bluetooth integration will automatically discover devices once the [Bluetooth](integrations/bluetooth) integration is enabled and working. It will list each detected Inspector using its Bluetooth MAC address as the serial number.
+The Medcom Bluetooth integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and working. It will list each detected Inspector using its Bluetooth MAC address as the serial number.
To limit the load on the Bluetooth radio on the Home Assistant side, the integration only polls for a reading every 5 minutes, which should be adequate for ongoing background monitoring. An Inspector BLE battery should last several months with continuous use before needing replacement.
@@ -34,4 +34,4 @@ To limit the load on the Bluetooth radio on the Home Assistant side, the integra
## Sensors
-This integration adds a counts-per-minute ("CPM") sensor for each detected Inspector BLE device. See the Inspector BLE manual for how to convert this CPM reading into another unit if desired, which can be done via a custom [template sensor](integrations/template)
+This integration adds a counts-per-minute ("CPM") sensor for each detected Inspector BLE device. See the Inspector BLE manual for how to convert this CPM reading into another unit if desired, which can be done via a custom [template sensor](/integrations/template)
diff --git a/source/_integrations/media_player.markdown b/source/_integrations/media_player.markdown
index e61b1d67397..26eae82ea90 100644
--- a/source/_integrations/media_player.markdown
+++ b/source/_integrations/media_player.markdown
@@ -13,6 +13,8 @@ ha_integration_type: entity
Interacts with media players on your network.
+{% include integrations/building_block_integration.md %}
+
## Services
### Media control services
diff --git a/source/_integrations/modbus.markdown b/source/_integrations/modbus.markdown
index f0efb617d77..9fd582d5481 100644
--- a/source/_integrations/modbus.markdown
+++ b/source/_integrations/modbus.markdown
@@ -22,7 +22,7 @@ ha_integration_type: integration
[modbus](http://www.modbus.org/) is a communication protocol to control PLCs (Programmable Logic Controller) and RTUs (Remote Terminal Unit).
-The integration adheres strictly to the [protocol specification](https://www.modbus.org/docs/Modbus_Application_Protocol_V1_1b3.pdf) using [pymodbus](https://github.com/pymodbus-dev/pymodbus) for the actual protocol implmentation.
+The integration adheres strictly to the [protocol specification](https://www.modbus.org/docs/Modbus_Application_Protocol_V1_1b3.pdf) using [pymodbus](https://github.com/pymodbus-dev/pymodbus) for the protocol implementation.
The modbus integration supports all devices adhering to the modbus standard. The communication to the device/devices can be serial (rs-485), TCP, or UDP connections. The modbus integration allows multiple communication channels e.g. a serial port connection combined with one or more TCP connections.
diff --git a/source/_integrations/mqtt.markdown b/source/_integrations/mqtt.markdown
index 519e7e355d9..a1fba335217 100644
--- a/source/_integrations/mqtt.markdown
+++ b/source/_integrations/mqtt.markdown
@@ -797,7 +797,7 @@ mqtt:
- [Event](/integrations/event.mqtt/)
- [Fan](/integrations/fan.mqtt/)
- [Humidifier](/integrations/humidifier.mqtt/)
-- [Image](/integrations/imahe.mqtt/)
+- [Image](/integrations/image.mqtt/)
- [Climate/HVACs](/integrations/climate.mqtt/)
- [Lawn Mower](/integrations/lawn_mower.mqtt/)
- [Light](/integrations/light.mqtt/)
diff --git a/source/_integrations/notify.markdown b/source/_integrations/notify.markdown
index 5ccc5e5436d..0564ec0a8a5 100644
--- a/source/_integrations/notify.markdown
+++ b/source/_integrations/notify.markdown
@@ -15,6 +15,8 @@ The `notify` integration makes it possible to send notifications to a wide varie
If you want to send notifications to the Home Assistant web interface, you may use the [Persistent Notification integration](/integrations/persistent_notification/). The Persistent Notification integration is also available as an automatically configured notifier. See [its documentation](/integrations/persistent_notification/) for more details.
+{% include integrations/building_block_integration.md %}
+
## Service
Once loaded, the `notify` platform will expose a service that can be called to send notifications.
diff --git a/source/_integrations/number.markdown b/source/_integrations/number.markdown
index 278025716bd..6e8aaad1a58 100644
--- a/source/_integrations/number.markdown
+++ b/source/_integrations/number.markdown
@@ -14,9 +14,9 @@ ha_integration_type: entity
Keeps track on `number` entities in your environment, their state, and allows you to control them. This integration allows other integrations to get a value input from user within a range.
-Number entities cannot be implemented manually, but can be provided by other
-integrations. If you are looking for a way to create a number entity,
-please take a look at the [Number helper](/integrations/input_number).
+{% include integrations/building_block_integration.md %}
+
+If you are looking for a way to create a number entity, please take a look at the [Number helper](/integrations/input_number).
## Device Class
diff --git a/source/_integrations/nzbget.markdown b/source/_integrations/nzbget.markdown
index f892ad62a8e..d2625a08014 100644
--- a/source/_integrations/nzbget.markdown
+++ b/source/_integrations/nzbget.markdown
@@ -3,7 +3,6 @@ title: NZBGet
description: Instructions on how to integrate NZBGet within Home Assistant.
ha_category:
- Downloading
-logo: nzbget.png
ha_iot_class: Local Polling
ha_release: 0.17
ha_config_flow: true
@@ -76,6 +75,6 @@ Available services:
### Service `nzbget/set_speed`
-| Service data attribute | Optional | Description |
-|------------------------|----------|-------------------------------------------------------------------------------------------------|
-| `speed` | yes | Sets the download speed limit, specified in Kb/s. 0 disables the speed limit. Defaults to 1000. |
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------------------------------------------------------------------------------------------- |
+| `speed` | yes | Sets the download speed limit, specified in Kb/s. 0 disables the speed limit. Defaults to 1000. |
diff --git a/source/_integrations/oem.markdown b/source/_integrations/oem.markdown
index 97b5aebfa02..30071180980 100644
--- a/source/_integrations/oem.markdown
+++ b/source/_integrations/oem.markdown
@@ -11,7 +11,7 @@ ha_platforms:
ha_integration_type: integration
---
-This platform supports the ESP8266 based "WiFi MQTT Relay / Thermostat" sold by [OpenEnergyMonitor](https://shop.openenergymonitor.com/wifi-mqtt-relay-thermostat/). The underlying [library](https://oemthermostat.readthedocs.io/) only supports this single relay variant of the [original device](https://harizanov.com/2014/12/wifi-iot-3-channel-relay-board-with-mqtt-and-http-api-using-esp8266/).
+This platform supports the ESP8266 based "WiFi MQTT Relay / Thermostat" sold by [OpenEnergyMonitor](https://web.archive.org/web/20220426080315/https://shop.openenergymonitor.com/wifi-mqtt-relay-thermostat/) (archived page, no longer for sale). The underlying [library](https://oemthermostat.readthedocs.io/) only supports this single relay variant of the [original device](https://harizanov.com/2014/12/wifi-iot-3-channel-relay-board-with-mqtt-and-http-api-using-esp8266/).
This platform controls the setpoint of the thermostat in its "manual" mode.
diff --git a/source/_integrations/oralb.markdown b/source/_integrations/oralb.markdown
index 8e6521addd2..b482724c5da 100644
--- a/source/_integrations/oralb.markdown
+++ b/source/_integrations/oralb.markdown
@@ -26,18 +26,18 @@ The integration can discover most Bluetooth-enabled Oral-B toothbrushes. Brushes
## Supported devices
-- [IO 4 Series](https://oralb.com/en-us/products/electric-toothbrushes/oralbio)
-- [IO 6 Series](https://oralb.com/en-us/products/electric-toothbrushes/io-series-6-electric-toothbrush-gray-opal/)
-- [IO 7 Series](https://oralb.com/en-us/products/electric-toothbrushes/oralbio)
-- [IO 8 Series](https://oralb.com/en-us/products/electric-toothbrushes/oralbio)
-- [IO 9 Series](https://oralb.com/en-us/products/electric-toothbrushes/oralbio)
-- Smart Series 4000
-- Smart Series 6000
+- [IO Series 4](https://oralb.com/en-us/products/electric-toothbrushes/io-series-4-rechargeable-electric-toothbrush-blue/)
+- [IO Series 6](https://oralb.com/en-us/products/electric-toothbrushes/io-series-6-electric-toothbrush-gray-opal/)
+- [IO Series 7](https://oralb.com/en-us/products/electric-toothbrushes/io-series-7-electric-toothbrush-sapphire-blue/)
+- [IO Series 8](https://oralb.com/en-us/products/electric-toothbrushes/io-series-8-electric-toothbrush-black-onyx/)
+- [IO Series 9](https://oralb.com/en-us/products/electric-toothbrushes/io-series-9-rechargeable-electric-toothbrush-in-rose-quartz/)
+- [Smart Series 4000](https://www.service.oralb.com/us/en/products/3754/)
+- [Smart Series 6000](https://www.service.oralb.com/us/en/products/3754/)
- [Smart Series 7000](https://oralb.com/en-us/products/electric-toothbrushes/smart-7000-rechargeable-electric-toothbrush/)
-- Smart Series 8000
-- [Genius Series 9000](https://oralb.com/en-us/products/electric-toothbrushes/genius-9600-rechargeable-electric-toothbrush-white/)
-- Genius Series 10000
-- Triumph V2
+- [Genius Series 8000](https://oralb.com/en-us/products/electric-toothbrushes/genius-8000-rechargeable-electric-toothbrush-pink/)
+- [Genius Series 9000](https://www.service.oralb.com/us/en/products/3765/)
+- [Genius Series 10000](https://www.service.oralb.com/us/en/products/3765/)
+- [Triumph V2](https://www.service.oralb.com/us/en/products/3745/)
- [Genius X](https://www.service.oralb.com/us/en/products/3771/)
## Sensor
diff --git a/source/_integrations/point.markdown b/source/_integrations/point.markdown
index bdf25cbd26a..b8a40163ee2 100644
--- a/source/_integrations/point.markdown
+++ b/source/_integrations/point.markdown
@@ -20,7 +20,7 @@ ha_platforms:
ha_integration_type: integration
---
-The Point hub enables integration with the [Minut Point](https://minut.com/). To connect with Point, you will have to [sign up for a developer account and have a Pro subscription](https://minut.com/community/developers/) and get a `client_id` and `client_secret` with the `callback url` configured as your Home Assistant URL + `/api/minut`, e.g., `http://localhost:8123/api/minut`. The `client_id` and `client_secret` should be used as below.
+The Point hub enables integration with the [Minut Point](https://minut.com/). To connect with Point, you will have to [sign up for a developer account and have a Pro subscription](https://minut.com/community/developers/) and get a `client_id` and `client_secret` with the `callback url` configured as your Home Assistant URL + `/api/minut`, e.g., `http://homeassistant.local:8123/api/minut`. The `client_id` and `client_secret` should be used as below.
Once Home Assistant is started, a configurator will pop up asking you to Authenticate your Point account via a link. When you follow the link and click on **Accept** you will be redirected to the `callback url` and the Point integration will be automatically configured and you can go back to the original dialog and press **Submit**.
diff --git a/source/_integrations/python_script.markdown b/source/_integrations/python_script.markdown
index 8b7de9877f9..351d5c40f21 100644
--- a/source/_integrations/python_script.markdown
+++ b/source/_integrations/python_script.markdown
@@ -128,6 +128,14 @@ The above `python_script` can be called using the following YAML as an input.
rgb_color: [255, 0, 0]
```
+Services can also respond with data. Retrieving this data in your Python script can be done by setting the `blocking` and `return_response` arguments of the `hass.services.call` function to `True`. This is shown in the example below, in this case, retrieving the weather forecast and putting it into a variable:
+
+```python
+# get_forecast.py
+service_data = {"type": "daily", "entity_id": "weather.YOUR_HOME"}
+current_forecast = hass.services.call("weather", "get_forecast", service_data, blocking=True, return_response=True)
+```
+
## Documenting your Python scripts
You can add names and descriptions for your Python scripts that will be shown in the frontend. To do so, simply create a `services.yaml` file in your `
Only the switch platform is currently supported.
diff --git a/source/_integrations/text.markdown b/source/_integrations/text.markdown
index 79c2fe94a8c..f0f1d21390f 100644
--- a/source/_integrations/text.markdown
+++ b/source/_integrations/text.markdown
@@ -13,7 +13,9 @@ ha_integration_type: entity
The Text integration is built for the controlling and monitoring of text values on devices.
-Text entities cannot be implemented manually, but can be provided by other integrations. If you are looking for a way to create a text entity, please take a look at the [Text helper](/integrations/input_text).
+{% include integrations/building_block_integration.md %}
+
+If you are looking for a way to create a text entity, please take a look at the [Text helper](/integrations/input_text).
## Services
diff --git a/source/_integrations/time.markdown b/source/_integrations/time.markdown
index 0447f3513ba..ae448329bfd 100644
--- a/source/_integrations/time.markdown
+++ b/source/_integrations/time.markdown
@@ -13,7 +13,9 @@ ha_integration_type: entity
The Time integration is built for the controlling and monitoring of times on devices.
-Time entities cannot be implemented manually, but can be provided by other integrations. If you are looking for a way to create a similar entity, please take a look at the [Date/Time helper](/integrations/input_datetime).
+{% include integrations/building_block_integration.md %}
+
+If you are looking for a way to create a similar entity, please take a look at the [Date/Time helper](/integrations/input_datetime).
## Services
diff --git a/source/_integrations/todoist.markdown b/source/_integrations/todoist.markdown
index be1bc87f931..c027d6dc0a3 100644
--- a/source/_integrations/todoist.markdown
+++ b/source/_integrations/todoist.markdown
@@ -18,7 +18,7 @@ This platform allows you to connect to your [Todoist Projects](https://todoist.c
## Prerequisites
-You need to determine your Todoist API token. This is fairly simple to do; just go [to the Integrations section on your Todoist settings page](https://todoist.com/app/settings/integrations) and find the section labeled "API token" at the bottom of the page. Copy that token and use it in your configuration file.
+You need to determine your Todoist API token. Go to the [**Integrations** > **Developer** section on your Todoist settings page](https://todoist.com/app/settings/integrations/developer) and find the section labeled **API token** at the bottom of the page. Copy that token and use it in your configuration file.
{% include integrations/config_flow.md %}
diff --git a/source/_integrations/tts.markdown b/source/_integrations/tts.markdown
index d6fc8fd75da..d8b6f33cea9 100644
--- a/source/_integrations/tts.markdown
+++ b/source/_integrations/tts.markdown
@@ -17,6 +17,8 @@ ha_integration_type: entity
Text-to-speech (TTS) enables Home Assistant to speak to you.
+{% include integrations/building_block_integration.md %}
+
## Services
### Service speak
diff --git a/source/_integrations/twitch.markdown b/source/_integrations/twitch.markdown
index f7be57a6554..2e07e18c2f4 100644
--- a/source/_integrations/twitch.markdown
+++ b/source/_integrations/twitch.markdown
@@ -18,6 +18,6 @@ The Twitch integration will allow you to monitor [Twitch](https://www.twitch.tv/
## Get Twitch application credentials
-Create a new app at "Register Your Application" in the [Twitch developer portal](https://dev.twitch.tv/console/apps). Then get the __Client ID__ and __Client secret__ for the new application.
+Create a new app at **Register Your Application** in the [Twitch developer portal](https://dev.twitch.tv/console/apps). Enter `https://my.home-assistant.io/redirect/oauth` in the **OAuth Redirect URL** field. Then, get the **Client ID** and **Client secret** from the new application.
{% include integrations/config_flow.md %}
diff --git a/source/_integrations/update.markdown b/source/_integrations/update.markdown
index 8b29b2eed39..5d243ff470d 100644
--- a/source/_integrations/update.markdown
+++ b/source/_integrations/update.markdown
@@ -26,16 +26,9 @@ made available by the integration providing the update entity, triggering
the actual update from Home Assistant. The other service exposed allows for
skipping the offered update.
-
`;
- } else {
- return '![]()
';
- }
+ return ``;
}
};
diff --git a/source/yellow/index.html b/source/yellow/index.html
index 269e11394c9..f812b27f73a 100644
--- a/source/yellow/index.html
+++ b/source/yellow/index.html
@@ -350,6 +350,21 @@ frontpage_image: /images/frontpage/yellow-frontpage.jpg
+{% include integrations/building_block_integration.md %}
-Update entities are here to be consumed and provided by other integrations and
-are are not designed to be created manually directly.
-
-This page, therefore, does not provide instructions on how to create update
-entities. Please see the ["Update" category](/integrations/#update) on the
-integrations page to find integration offering update entities.
-
-
+For a list of integrations offering update entities, on the integrations page, select the ["Update" category](/integrations/#update).
## The state of an update entity
diff --git a/source/_integrations/vacuum.markdown b/source/_integrations/vacuum.markdown
index 7e65a41f08e..82ba32360fe 100644
--- a/source/_integrations/vacuum.markdown
+++ b/source/_integrations/vacuum.markdown
@@ -13,6 +13,8 @@ ha_integration_type: entity
The `vacuum` integration enables the ability to control home cleaning robots within Home Assistant.
+{% include integrations/building_block_integration.md %}
+
## Services
Available services: `start`, `pause`, `stop`, `return_to_base`, `locate`, `clean_spot`, `set_fan_speed` and `send_command`.
diff --git a/source/_integrations/vicare.markdown b/source/_integrations/vicare.markdown
index 0934f9b2aac..d42265d72e9 100644
--- a/source/_integrations/vicare.markdown
+++ b/source/_integrations/vicare.markdown
@@ -44,6 +44,8 @@ The required Client ID can be obtained as follows:
The `heating_type` can either be `auto` to automatically find the most suitable type for your device or one of `gas`, `oil`, `pellets`, `heatpump`, `fuelcell`, `hybrid`.
+Important: the redirect URI that you configure requires that you perform the initial setup on a device that has the ViCare application installed. If your device does not know how to handle the `vicare://` URL, you will receive an **Invalid credentials** notification and the setup procedure will fail. This means: install the ViCare app on your phone and set up the integration from your phone.
+
Multiple device instances might be generated depending on the number of burners and/or circuits of your installation. If there is more than a single instance all devices are suffixed with the circuit or burner ID.
## Viessmann API limits
diff --git a/source/_integrations/wake_word.markdown b/source/_integrations/wake_word.markdown
index d10e861aa65..64c8fba04e5 100644
--- a/source/_integrations/wake_word.markdown
+++ b/source/_integrations/wake_word.markdown
@@ -15,6 +15,4 @@ A wake-word-detection entity allows other integrations or applications to detect
The wake-word-detection entities cannot be implemented manually, but can be provided by integrations such as [Wyoming](/integrations/wyoming). The API in [Assist Pipelines](https://developers.home-assistant.io/docs/voice/pipelines/) enables wake-word-detection as part of [Assist](/voice_control/).
-
-
{% include integrations/building_block_integration.md %}
diff --git a/source/_integrations/weather.markdown b/source/_integrations/weather.markdown
index 1612ea56e7a..38f14ef19de 100644
--- a/source/_integrations/weather.markdown
+++ b/source/_integrations/weather.markdown
@@ -11,7 +11,13 @@ ha_domain: weather
ha_integration_type: entity
---
-The `weather` platforms gather meteorological information from web services and display the conditions and other details about the weather at the given location. Read the integration documentation for your particular weather provider to learn how to set it up.
+The `weather` platforms gather meteorological information from web services and display the conditions and other details about the weather at the given location.
+
+{% include integrations/building_block_integration.md %}
+
+For a list of weather integrations, on the integrations page, select the [weather category](/integrations/#weather).
+
+Read the integration documentation for your particular weather provider to learn how to set it up.
Home Assistant currently supports free web services some of which require registration.
diff --git a/source/_integrations/weatherkit.markdown b/source/_integrations/weatherkit.markdown
index 21c2af5cef6..dc367039d76 100644
--- a/source/_integrations/weatherkit.markdown
+++ b/source/_integrations/weatherkit.markdown
@@ -51,4 +51,11 @@ You can add a new WeatherKit integration entry now that you have all the credent
- **Apple team ID**: `ABC123DEFG`
- This value can be found in the top-right of the Apple Developer website.
- **Private key**: `-----BEGIN PRIVATE KEY----- [...]`
- - Open the `.p8` file you downloaded earlier in a text editor and copy the contents into this field.
+ - Open the `.p8` file you downloaded earlier in a text editor and copy the _entire_ contents into this field, including the header and footer.
+
+### Troubleshooting
+
+If you are having issues setting up the integration, please make sure the following are true:
+
+- You are entering the key exactly as it appears in the `.p8` file, including the header and footer.
+- There are no leading or trailing spaces in other configuration values.
\ No newline at end of file
diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown
index 8f16bd3695f..057c665da4e 100644
--- a/source/_integrations/zha.markdown
+++ b/source/_integrations/zha.markdown
@@ -92,7 +92,8 @@ Some other Zigbee coordinator hardware may not support a firmware that is capabl
### Recommended Zigbee radio adapters and modules
- Silicon Labs EmberZNet based radios using the EZSP protocol (via the [bellows](https://github.com/zigpy/bellows) library for zigpy)
- - [Home Assistant SkyConnect](/skyconnect/)
+ - [Home Assistant SkyConnect](/skyconnect/) (EFR32MG21-based USB dongle)
+ - [Home Assistant Yellow](/yellow/) with integrated EFR32MG21 radio
- [ITead SONOFF Zigbee 3.0 USB Dongle Plus Model "ZBDongle-E" (EFR32MG21 variant)](https://itead.cc/product/zigbee-3-0-usb-dongle/)
- [Elelabs Zigbee USB Adapter](https://elelabs.com/products/elelabs-usb-adapter.html)/POPP ZB-Stick (Note! Not a must but recommend [upgrade the EmberZNet NCP application firmware](https://github.com/Elelabs/elelabs-zigbee-ezsp-utility))
- [Elelabs Zigbee Raspberry Pi Shield](https://elelabs.com/products/elelabs-zigbee-shield.html) (Note! Not a must but recommend [upgrade the EmberZNet NCP application firmware](https://github.com/Elelabs/elelabs-zigbee-ezsp-utility))
diff --git a/source/_posts/2023-10-04-release-202310.markdown b/source/_posts/2023-10-04-release-202310.markdown
index 02b77722860..55ec56afdbe 100644
--- a/source/_posts/2023-10-04-release-202310.markdown
+++ b/source/_posts/2023-10-04-release-202310.markdown
@@ -39,6 +39,7 @@ Enjoy the release!
- [Other noteworthy changes](#other-noteworthy-changes)
- [New integrations](#new-integrations)
- [Integrations now available to set up from the UI](#integrations-now-available-to-set-up-from-the-ui)
+- [Release 2023.10.1 - October 6](#release-2023101---october-6)
- [Need help? Join the community!](#need-help-join-the-community)
- [Breaking changes](#breaking-changes)
- [All changes](#all-changes)
@@ -251,6 +252,86 @@ The following integrations are now available via the Home Assistant UI:
[Twitch]: /integrations/twitch
[World Air Quality Index (WAQI)]: /integrations/waqi
+## Release 2023.10.1 - October 6
+
+- 2023.10.0 ([@frenck] - [#101386])
+- Fix ZHA device diagnostics error for unknown unsupported attributes ([@TheJulianJES] - [#101239])
+- Bump pyyardian to 1.1.1 ([@h3l1o5] - [#101363])
+- Fix Withings translations ([@joostlek] - [#101397])
+- Raise vol.Invalid for invalid mqtt device_tracker config ([@jbouwh] - [#101399])
+- Bump dbus-fast to 2.11.1 ([@bdraco] - [#101406])
+- Add translation for Tamper binary sensor ([@joostlek] - [#101416])
+- Add wake word cooldown to avoid duplicate wake-ups ([@synesthesiam] - [#101417])
+- Adjust WeatherFlow wind sensors to appropriately match native unit and library field ([@natekspencer] - [#101418])
+- Bump env_canada to v0.5.37 ([@michaeldavie] - [#101435])
+- Fix device_class.capitalize() in Point ([@fredrike] - [#101440])
+- SMA add missing entity descriptions ([@rklomp] - [#101462])
+- Fix Trafikverket Camera if no location data ([@gjohansson-ST] - [#101463])
+- Update frontend to 20231005.0 ([@piitaya] - [#101480])
+- Bump zeroconf to 0.115.2 ([@bdraco] - [#101482])
+- bump pywaze to 0.5.1 sets timeout to 60s ([@eifinger] - [#101487])
+- Fix caching of latest short term stats after insertion of external stats ([@bdraco] - [#101490])
+- Fix key error in config flow when duplicate stop names exist ([@ViViDboarder] - [#101491])
+- Fix bug in calendar state where alarms due to alarms not scheduled ([@allenporter] - [#101510])
+- Fix for rainbird unique id ([@allenporter] - [#101512])
+- Limit waze_travel_time to 0.5call/s over all entries ([@eifinger] - [#101514])
+- Use config flow in color extractor tests ([@joostlek] - [#101524])
+- Delete existing Withings cloudhook ([@joostlek] - [#101527])
+- Modbus, wrong length when reading strings ([@janiversen] - [#101529])
+- Update LoqedAPI to handle invalid transitions better ([@mikewoudenberg] - [#101534])
+- Cancel callbacks on Withings entry unload ([@joostlek] - [#101536])
+- Bump HAP-python to 4.8.0 ([@bdraco] - [#101538])
+- Add Withings webhooks after a slight delay ([@joostlek] - [#101542])
+- Only import color extractor when domain is in config ([@joostlek] - [#101522])
+
+[#101239]: https://github.com/home-assistant/core/pull/101239
+[#101363]: https://github.com/home-assistant/core/pull/101363
+[#101386]: https://github.com/home-assistant/core/pull/101386
+[#101397]: https://github.com/home-assistant/core/pull/101397
+[#101399]: https://github.com/home-assistant/core/pull/101399
+[#101406]: https://github.com/home-assistant/core/pull/101406
+[#101416]: https://github.com/home-assistant/core/pull/101416
+[#101417]: https://github.com/home-assistant/core/pull/101417
+[#101418]: https://github.com/home-assistant/core/pull/101418
+[#101435]: https://github.com/home-assistant/core/pull/101435
+[#101440]: https://github.com/home-assistant/core/pull/101440
+[#101462]: https://github.com/home-assistant/core/pull/101462
+[#101463]: https://github.com/home-assistant/core/pull/101463
+[#101480]: https://github.com/home-assistant/core/pull/101480
+[#101482]: https://github.com/home-assistant/core/pull/101482
+[#101487]: https://github.com/home-assistant/core/pull/101487
+[#101490]: https://github.com/home-assistant/core/pull/101490
+[#101491]: https://github.com/home-assistant/core/pull/101491
+[#101510]: https://github.com/home-assistant/core/pull/101510
+[#101512]: https://github.com/home-assistant/core/pull/101512
+[#101514]: https://github.com/home-assistant/core/pull/101514
+[#101522]: https://github.com/home-assistant/core/pull/101522
+[#101524]: https://github.com/home-assistant/core/pull/101524
+[#101527]: https://github.com/home-assistant/core/pull/101527
+[#101529]: https://github.com/home-assistant/core/pull/101529
+[#101534]: https://github.com/home-assistant/core/pull/101534
+[#101536]: https://github.com/home-assistant/core/pull/101536
+[#101538]: https://github.com/home-assistant/core/pull/101538
+[#101542]: https://github.com/home-assistant/core/pull/101542
+[@TheJulianJES]: https://github.com/TheJulianJES
+[@ViViDboarder]: https://github.com/ViViDboarder
+[@allenporter]: https://github.com/allenporter
+[@bdraco]: https://github.com/bdraco
+[@eifinger]: https://github.com/eifinger
+[@fredrike]: https://github.com/fredrike
+[@frenck]: https://github.com/frenck
+[@gjohansson-ST]: https://github.com/gjohansson-ST
+[@h3l1o5]: https://github.com/h3l1o5
+[@janiversen]: https://github.com/janiversen
+[@jbouwh]: https://github.com/jbouwh
+[@joostlek]: https://github.com/joostlek
+[@michaeldavie]: https://github.com/michaeldavie
+[@mikewoudenberg]: https://github.com/mikewoudenberg
+[@natekspencer]: https://github.com/natekspencer
+[@piitaya]: https://github.com/piitaya
+[@rklomp]: https://github.com/rklomp
+[@synesthesiam]: https://github.com/synesthesiam
+
## Need help? Join the community!
Home Assistant has a great community of users who are all more than willing
@@ -367,6 +448,17 @@ backup was initiated. Instead, the local date and time are used for the name.
{% enddetails %}
+{% details "Twitch" %}
+
+Any existing app you have created in the [Twitch Developer Portal](https://dev.twitch.tv/console/apps/) to work with this integration must be updated to work with Home Assistant's UI authentication flow. Update the app's configuration to include `https://my.home-assistant.io/redirect/oauth` in its list of "OAuth Redirect URLs"
+
+([@joostlek] - [issue#101414]) ([documentation](/integrations/twitch))
+
+[@joostlek]: https://github.com/joostlek
+[issue#101414]: https://github.com/home-assistant/core/issues/101414
+
+{% enddetails %}
+
{% details "Z-Wave" %}
Multiple WebSocket commands have been renamed based on [this change in Z-Wave JS](https://zwave-js.github.io/node-zwave-js/#/getting-started/migrating-to-v12?id=renamed-network-heal-to-rebuild-routes).
diff --git a/source/getting-started/onboarding.markdown b/source/getting-started/onboarding.markdown
index 84d155db9b1..ac6b4606815 100644
--- a/source/getting-started/onboarding.markdown
+++ b/source/getting-started/onboarding.markdown
@@ -5,9 +5,13 @@ description: "Instructions to get Home Assistant configured."
Alright, you made it here. The tough part is done.
-After entering the Home Assistant device's address in your browser's address bar, the welcome screen is shown. Depending on your hardware, preparation may take a while.
+- As the last step of the [installation procedure](/installation/) specific to your device, you entered the Home Assistant device's address in your browser's address bar.
+ - Typically, this is `http://homeassistant.local:8123/`
+ - If you are running an older Windows version or have a stricter network configuration, you might need to access Home Assistant at homeassistant:8123 or `http://X.X.X.X:8123` (replace X.X.X.X with your device's IP address).
-
+ - **Result**: You now see the welcome screen. Depending on your hardware, preparation may take a while.
+
+ 
With Home Assistant installed, it's time to set up the basics.
diff --git a/source/help/trivia.markdown b/source/help/trivia.markdown
index 0851d6170bb..d40374fc0a6 100644
--- a/source/help/trivia.markdown
+++ b/source/help/trivia.markdown
@@ -26,7 +26,7 @@ Home Assistant is open source software and available under the [Apache 2.0](http
- End of 2020, [Home Assistant Blue](/blue/) was launched. The first dedicated smart home hub for Home Assistant. This limited edition is based on an ODROID and known for its blue aluminum case.
- In September 2021, [Home Assistant Yellow](/yellow/) was launched. This extendable smart home hub is a custom, open-source design powered by a Raspberry Pi Compute Module 4. Home Assistant Yellow supports both Zigbee and Thread.
-- End of 2022, [Home Assistant SkyConnect](skyconnect) was launched: a USB dongle that provides Zigbee and Thread network support for hubs that do not have this built-in.
+- End of 2022, [Home Assistant SkyConnect](/skyconnect/) was launched: a USB dongle that provides Zigbee and Thread network support for hubs that do not have this built-in.
## Numbers
diff --git a/source/images/assist/android_watch.png b/source/images/assist/android_watch.png
deleted file mode 100644
index ae93b94b8e2..00000000000
Binary files a/source/images/assist/android_watch.png and /dev/null differ
diff --git a/source/images/assist/grandstream_port_config.png b/source/images/assist/grandstream_port_config.png
deleted file mode 100644
index f281434b892..00000000000
Binary files a/source/images/assist/grandstream_port_config.png and /dev/null differ
diff --git a/source/images/blog/2021-11-analytics/release-breakdown.png b/source/images/blog/2021-11-analytics/release-breakdown.png
deleted file mode 100644
index 9e1e8236e88..00000000000
Binary files a/source/images/blog/2021-11-analytics/release-breakdown.png and /dev/null differ
diff --git a/source/images/blog/2022-03/trigger-attributes.png b/source/images/blog/2022-03/trigger-attributes.png
deleted file mode 100644
index 734b04374d8..00000000000
Binary files a/source/images/blog/2022-03/trigger-attributes.png and /dev/null differ
diff --git a/source/images/blog/2022-06/scene-editor.png b/source/images/blog/2022-06/scene-editor.png
deleted file mode 100644
index b715291d618..00000000000
Binary files a/source/images/blog/2022-06/scene-editor.png and /dev/null differ
diff --git a/source/images/blog/2023-09-ha10/green-price.jpeg b/source/images/blog/2023-09-ha10/green-price.jpeg
deleted file mode 100644
index b02a121941e..00000000000
Binary files a/source/images/blog/2023-09-ha10/green-price.jpeg and /dev/null differ
diff --git a/source/images/blue/blue_narrow.jpg b/source/images/blue/blue_narrow.jpg
deleted file mode 100644
index 8d77f180a3c..00000000000
Binary files a/source/images/blue/blue_narrow.jpg and /dev/null differ
diff --git a/source/images/blueprints/selector-entity.png.png b/source/images/blueprints/selector-entity.png.png
deleted file mode 100644
index 9f124caf9c2..00000000000
Binary files a/source/images/blueprints/selector-entity.png.png and /dev/null differ
diff --git a/source/images/blueprints/selector-icon.png b/source/images/blueprints/selector-icon.png
deleted file mode 100644
index bca6f4b1f88..00000000000
Binary files a/source/images/blueprints/selector-icon.png and /dev/null differ
diff --git a/source/images/conference/frontpage-card.png b/source/images/conference/frontpage-card.png
deleted file mode 100644
index 7f0e312b2fb..00000000000
Binary files a/source/images/conference/frontpage-card.png and /dev/null differ
diff --git a/source/images/dashboards/lovelace-ui-comparison.png b/source/images/dashboards/lovelace-ui-comparison.png
deleted file mode 100644
index 83de4f20fca..00000000000
Binary files a/source/images/dashboards/lovelace-ui-comparison.png and /dev/null differ
diff --git a/source/images/events/lets-get-loud.jpg b/source/images/events/lets-get-loud.jpg
deleted file mode 100644
index 0d92de092fe..00000000000
Binary files a/source/images/events/lets-get-loud.jpg and /dev/null differ
diff --git a/source/images/frontpage/state-of-the-open-home-2022.png b/source/images/frontpage/state-of-the-open-home-2022.png
deleted file mode 100644
index 7b98c0a2807..00000000000
Binary files a/source/images/frontpage/state-of-the-open-home-2022.png and /dev/null differ
diff --git a/source/images/getting-started/onboarding_integrations_01.png b/source/images/getting-started/onboarding_integrations_01.png
deleted file mode 100644
index 4b34a9f0577..00000000000
Binary files a/source/images/getting-started/onboarding_integrations_01.png and /dev/null differ
diff --git a/source/images/installation/etcher2.png b/source/images/installation/etcher2.png
deleted file mode 100644
index de652c8517d..00000000000
Binary files a/source/images/installation/etcher2.png and /dev/null differ
diff --git a/source/images/installation/rpi-select-os.png b/source/images/installation/rpi-select-os.png
deleted file mode 100644
index fc3635d7ee8..00000000000
Binary files a/source/images/installation/rpi-select-os.png and /dev/null differ
diff --git a/source/images/integrations/almond/almond-architecture.svg b/source/images/integrations/almond/almond-architecture.svg
deleted file mode 100644
index 1d60a27fb34..00000000000
--- a/source/images/integrations/almond/almond-architecture.svg
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/source/images/integrations/homekit_controller/homekit_controller_add_03.png b/source/images/integrations/homekit_controller/homekit_controller_add_03.png
deleted file mode 100644
index 5accfe50571..00000000000
Binary files a/source/images/integrations/homekit_controller/homekit_controller_add_03.png and /dev/null differ
diff --git a/source/images/integrations/mystrom/switch-advanced.png b/source/images/integrations/mystrom/switch-advanced.png
deleted file mode 100644
index 55b7ae416f3..00000000000
Binary files a/source/images/integrations/mystrom/switch-advanced.png and /dev/null differ
diff --git a/source/images/integrations/nest/create_project.png b/source/images/integrations/nest/create_project.png
deleted file mode 100644
index b03d5d3ca47..00000000000
Binary files a/source/images/integrations/nest/create_project.png and /dev/null differ
diff --git a/source/images/integrations/nest/enable_api.png b/source/images/integrations/nest/enable_api.png
deleted file mode 100644
index 24df886fc19..00000000000
Binary files a/source/images/integrations/nest/enable_api.png and /dev/null differ
diff --git a/source/images/integrations/nest/integration_access_token.png b/source/images/integrations/nest/integration_access_token.png
deleted file mode 100644
index fdd380a370f..00000000000
Binary files a/source/images/integrations/nest/integration_access_token.png and /dev/null differ
diff --git a/source/images/integrations/nest/integration_link_account.png b/source/images/integrations/nest/integration_link_account.png
deleted file mode 100644
index 2f35188baac..00000000000
Binary files a/source/images/integrations/nest/integration_link_account.png and /dev/null differ
diff --git a/source/images/integrations/nest/integration_oauth_type.png b/source/images/integrations/nest/integration_oauth_type.png
deleted file mode 100644
index 740dec20535..00000000000
Binary files a/source/images/integrations/nest/integration_oauth_type.png and /dev/null differ
diff --git a/source/images/integrations/nest/oauth_access_token.png b/source/images/integrations/nest/oauth_access_token.png
deleted file mode 100644
index f0a6ced9b3a..00000000000
Binary files a/source/images/integrations/nest/oauth_access_token.png and /dev/null differ
diff --git a/source/images/integrations/opengarage/cover_opengarage_details.jpg b/source/images/integrations/opengarage/cover_opengarage_details.jpg
deleted file mode 100644
index 69bc608d1b6..00000000000
Binary files a/source/images/integrations/opengarage/cover_opengarage_details.jpg and /dev/null differ
diff --git a/source/images/integrations/script/script_figures.pptx b/source/images/integrations/script/script_figures.pptx
deleted file mode 100644
index 4a9925f88a4..00000000000
Binary files a/source/images/integrations/script/script_figures.pptx and /dev/null differ
diff --git a/source/images/integrations/tuya/image_002.png b/source/images/integrations/tuya/image_002.png
deleted file mode 100644
index ce1eff1ed5e..00000000000
Binary files a/source/images/integrations/tuya/image_002.png and /dev/null differ
diff --git a/source/images/screenshots/developer-tool-about-icon.png b/source/images/screenshots/developer-tool-about-icon.png
deleted file mode 100644
index 64cdb63de73..00000000000
Binary files a/source/images/screenshots/developer-tool-about-icon.png and /dev/null differ
diff --git a/source/images/screenshots/mpc-hc.png b/source/images/screenshots/mpc-hc.png
deleted file mode 100644
index 7bb356d445e..00000000000
Binary files a/source/images/screenshots/mpc-hc.png and /dev/null differ
diff --git a/source/images/screenshots/sabnzbd-configure.png b/source/images/screenshots/sabnzbd-configure.png
deleted file mode 100644
index 0a5709ea4bf..00000000000
Binary files a/source/images/screenshots/sabnzbd-configure.png and /dev/null differ
diff --git a/source/images/screenshots/wunderground_daily_forecast.png b/source/images/screenshots/wunderground_daily_forecast.png
deleted file mode 100644
index d51a9ead47e..00000000000
Binary files a/source/images/screenshots/wunderground_daily_forecast.png and /dev/null differ
diff --git a/source/images/screenshots/wunderground_weather_overview.png b/source/images/screenshots/wunderground_weather_overview.png
deleted file mode 100644
index 434b97d4a2f..00000000000
Binary files a/source/images/screenshots/wunderground_weather_overview.png and /dev/null differ
diff --git a/source/images/skyconnect/skyconnect_landing_page.jpg b/source/images/skyconnect/skyconnect_landing_page.jpg
deleted file mode 100644
index 673a5bd156b..00000000000
Binary files a/source/images/skyconnect/skyconnect_landing_page.jpg and /dev/null differ
diff --git a/source/images/supported_brands/antifurto365-ialarm.png b/source/images/supported_brands/antifurto365-ialarm.png
deleted file mode 100644
index e7ba2290cdc..00000000000
Binary files a/source/images/supported_brands/antifurto365-ialarm.png and /dev/null differ
diff --git a/source/images/supported_brands/arest.png b/source/images/supported_brands/arest.png
deleted file mode 100644
index 608d599cf68..00000000000
Binary files a/source/images/supported_brands/arest.png and /dev/null differ
diff --git a/source/images/supported_brands/arris.jpg b/source/images/supported_brands/arris.jpg
deleted file mode 100644
index 4e062ac9a60..00000000000
Binary files a/source/images/supported_brands/arris.jpg and /dev/null differ
diff --git a/source/images/supported_brands/bluesound.png b/source/images/supported_brands/bluesound.png
deleted file mode 100644
index 1ae9f1e120a..00000000000
Binary files a/source/images/supported_brands/bluesound.png and /dev/null differ
diff --git a/source/images/supported_brands/brultech.png b/source/images/supported_brands/brultech.png
deleted file mode 100644
index eb69058b748..00000000000
Binary files a/source/images/supported_brands/brultech.png and /dev/null differ
diff --git a/source/images/supported_brands/bsblan.png b/source/images/supported_brands/bsblan.png
deleted file mode 100644
index 37e0cec2789..00000000000
Binary files a/source/images/supported_brands/bsblan.png and /dev/null differ
diff --git a/source/images/supported_brands/buienradar.png b/source/images/supported_brands/buienradar.png
deleted file mode 100644
index b0c79bc50ac..00000000000
Binary files a/source/images/supported_brands/buienradar.png and /dev/null differ
diff --git a/source/images/supported_brands/cpu.png b/source/images/supported_brands/cpu.png
deleted file mode 100644
index ba181f080a7..00000000000
Binary files a/source/images/supported_brands/cpu.png and /dev/null differ
diff --git a/source/images/supported_brands/derivative.png b/source/images/supported_brands/derivative.png
deleted file mode 100644
index c964dc98162..00000000000
Binary files a/source/images/supported_brands/derivative.png and /dev/null differ
diff --git a/source/images/supported_brands/dht.png b/source/images/supported_brands/dht.png
deleted file mode 100644
index c9bd30907f6..00000000000
Binary files a/source/images/supported_brands/dht.png and /dev/null differ
diff --git a/source/images/supported_brands/diodes.png b/source/images/supported_brands/diodes.png
deleted file mode 100644
index fa03b7b8d09..00000000000
Binary files a/source/images/supported_brands/diodes.png and /dev/null differ
diff --git a/source/images/supported_brands/environment_agency.jpg b/source/images/supported_brands/environment_agency.jpg
deleted file mode 100644
index c3187a13758..00000000000
Binary files a/source/images/supported_brands/environment_agency.jpg and /dev/null differ
diff --git a/source/images/supported_brands/etherscan.png b/source/images/supported_brands/etherscan.png
deleted file mode 100644
index ae06f8b215e..00000000000
Binary files a/source/images/supported_brands/etherscan.png and /dev/null differ
diff --git a/source/images/supported_brands/everlights.png b/source/images/supported_brands/everlights.png
deleted file mode 100644
index c4ab8d6dd77..00000000000
Binary files a/source/images/supported_brands/everlights.png and /dev/null differ
diff --git a/source/images/supported_brands/forecast.png b/source/images/supported_brands/forecast.png
deleted file mode 100644
index 3051a4056a3..00000000000
Binary files a/source/images/supported_brands/forecast.png and /dev/null differ
diff --git a/source/images/supported_brands/geo_location.png b/source/images/supported_brands/geo_location.png
deleted file mode 100644
index fb24dab02fd..00000000000
Binary files a/source/images/supported_brands/geo_location.png and /dev/null differ
diff --git a/source/images/supported_brands/goalfeed.png b/source/images/supported_brands/goalfeed.png
deleted file mode 100644
index 5d19cd9a687..00000000000
Binary files a/source/images/supported_brands/goalfeed.png and /dev/null differ
diff --git a/source/images/supported_brands/graphite.png b/source/images/supported_brands/graphite.png
deleted file mode 100644
index 943aa76d4e5..00000000000
Binary files a/source/images/supported_brands/graphite.png and /dev/null differ
diff --git a/source/images/supported_brands/greenwavereality.png b/source/images/supported_brands/greenwavereality.png
deleted file mode 100644
index 8ec7f2f64d3..00000000000
Binary files a/source/images/supported_brands/greenwavereality.png and /dev/null differ
diff --git a/source/images/supported_brands/homeconnect.png b/source/images/supported_brands/homeconnect.png
deleted file mode 100644
index 7f744b03ef1..00000000000
Binary files a/source/images/supported_brands/homeconnect.png and /dev/null differ
diff --git a/source/images/supported_brands/iglo.png b/source/images/supported_brands/iglo.png
deleted file mode 100644
index 59c3233fbf2..00000000000
Binary files a/source/images/supported_brands/iglo.png and /dev/null differ
diff --git a/source/images/supported_brands/interlogix.png b/source/images/supported_brands/interlogix.png
deleted file mode 100644
index 158c0361ab8..00000000000
Binary files a/source/images/supported_brands/interlogix.png and /dev/null differ
diff --git a/source/images/supported_brands/intesishome.png b/source/images/supported_brands/intesishome.png
deleted file mode 100644
index 79c61265409..00000000000
Binary files a/source/images/supported_brands/intesishome.png and /dev/null differ
diff --git a/source/images/supported_brands/lagute.png b/source/images/supported_brands/lagute.png
deleted file mode 100644
index 9669a196361..00000000000
Binary files a/source/images/supported_brands/lagute.png and /dev/null differ
diff --git a/source/images/supported_brands/limitlessled_logo.png b/source/images/supported_brands/limitlessled_logo.png
deleted file mode 100644
index 81b1e99acd8..00000000000
Binary files a/source/images/supported_brands/limitlessled_logo.png and /dev/null differ
diff --git a/source/images/supported_brands/mythic_beasts.png b/source/images/supported_brands/mythic_beasts.png
deleted file mode 100644
index 6249811fcdf..00000000000
Binary files a/source/images/supported_brands/mythic_beasts.png and /dev/null differ
diff --git a/source/images/supported_brands/netbeheernederland.jpg b/source/images/supported_brands/netbeheernederland.jpg
deleted file mode 100644
index d99ac44f774..00000000000
Binary files a/source/images/supported_brands/netbeheernederland.jpg and /dev/null differ
diff --git a/source/images/supported_brands/numato.png b/source/images/supported_brands/numato.png
deleted file mode 100644
index 4477eb511e4..00000000000
Binary files a/source/images/supported_brands/numato.png and /dev/null differ
diff --git a/source/images/supported_brands/obitalk.png b/source/images/supported_brands/obitalk.png
deleted file mode 100644
index 51d13fecbaa..00000000000
Binary files a/source/images/supported_brands/obitalk.png and /dev/null differ
diff --git a/source/images/supported_brands/openwebif.png b/source/images/supported_brands/openwebif.png
deleted file mode 100644
index c53a60ada11..00000000000
Binary files a/source/images/supported_brands/openwebif.png and /dev/null differ
diff --git a/source/images/supported_brands/p5.png b/source/images/supported_brands/p5.png
deleted file mode 100644
index 1b4aefc0aad..00000000000
Binary files a/source/images/supported_brands/p5.png and /dev/null differ
diff --git a/source/images/supported_brands/pencom.png b/source/images/supported_brands/pencom.png
deleted file mode 100644
index 0955754efa1..00000000000
Binary files a/source/images/supported_brands/pencom.png and /dev/null differ
diff --git a/source/images/supported_brands/rest.png b/source/images/supported_brands/rest.png
deleted file mode 100644
index 1111957e859..00000000000
Binary files a/source/images/supported_brands/rest.png and /dev/null differ
diff --git a/source/images/supported_brands/rflink.png b/source/images/supported_brands/rflink.png
deleted file mode 100644
index 736da752d5a..00000000000
Binary files a/source/images/supported_brands/rflink.png and /dev/null differ
diff --git a/source/images/supported_brands/unitymedia.png b/source/images/supported_brands/unitymedia.png
deleted file mode 100644
index e76d4e2118c..00000000000
Binary files a/source/images/supported_brands/unitymedia.png and /dev/null differ
diff --git a/source/images/supported_brands/wiffi.png b/source/images/supported_brands/wiffi.png
deleted file mode 100644
index faa585b62f7..00000000000
Binary files a/source/images/supported_brands/wiffi.png and /dev/null differ
diff --git a/source/integrations/index.html b/source/integrations/index.html
index 431a8d40952..f4269102722 100644
--- a/source/integrations/index.html
+++ b/source/integrations/index.html
@@ -160,11 +160,7 @@ allComponents.pop(); // remove placeholder element at the end
var data = {
components: [],
image: function () {
- if (this.logo === '') {
- return `
';
- }
+ return `