2024.5

CODEOWNERS

@@ -38,6 +38,7 @@ source/_integrations/alert.markdown @home-assistant/core @frenck
 source/_integrations/alexa.markdown @home-assistant/cloud @ochlocracy @jbouwh
 source/_integrations/alexa.smart_home.markdown @home-assistant/cloud @ochlocracy @jbouwh
 source/_integrations/amberelectric.markdown @madpilot
+source/_integrations/ambient_network.markdown @thomaskistler
 source/_integrations/ambient_station.markdown @bachya
 source/_integrations/amcrest.markdown @flacjacket
 source/_integrations/amp_motorization.markdown @starkillerOG
@@ -125,7 +126,6 @@ source/_integrations/camera.markdown @home-assistant/core
 source/_integrations/cast.markdown @emontnemery
 source/_integrations/ccm15.markdown @ocalvo
 source/_integrations/cert_expiry.markdown @jjlawren
-source/_integrations/circuit.markdown @braam
 source/_integrations/cisco_ios.markdown @fbradyirl
 source/_integrations/cisco_mobility_express.markdown @fbradyirl
 source/_integrations/cisco_webex_teams.markdown @fbradyirl
@@ -182,7 +182,7 @@ source/_integrations/discogs.markdown @thibmaek
 source/_integrations/discord.markdown @tkdrob
 source/_integrations/discovergy.markdown @jpbede
 source/_integrations/dlink.markdown @tkdrob
-source/_integrations/dlna_dmr.markdown @StevenLooman @chishm
+source/_integrations/dlna_dmr.markdown @chishm
 source/_integrations/dlna_dms.markdown @chishm
 source/_integrations/dnsip.markdown @gjohansson-ST
 source/_integrations/doorbird.markdown @oblogic7 @bdraco @flacjacket
@@ -227,9 +227,10 @@ source/_integrations/enphase_envoy.markdown @bdraco @cgarwood @dgomes @joostlek
 source/_integrations/entur_public_transport.markdown @hfurubotten
 source/_integrations/environment_canada.markdown @gwww @michaeldavie
 source/_integrations/ephember.markdown @ttroy50
+source/_integrations/epic_games_store.markdown @hacf-fr @Quentame
 source/_integrations/epion.markdown @lhgravendeel
 source/_integrations/epson.markdown @pszafer
-source/_integrations/epsonworkforce.markdown @ThaStealth
+source/_integrations/eq3btsmart.markdown @eulemitkeule @dbuezas
 source/_integrations/escea.markdown @lazdavila
 source/_integrations/esera_onewire.markdown @garbled1 @epenet
 source/_integrations/esphome.markdown @OttoWinter @jesserockz @kbx81 @bdraco
@@ -263,7 +264,7 @@ source/_integrations/flux_led.markdown @icemanch
 source/_integrations/forecast_solar.markdown @klaasnicolaas @frenck
 source/_integrations/forked_daapd.markdown @uvjustin
 source/_integrations/fortios.markdown @kimfrellsen
-source/_integrations/foscam.markdown @skgsergio @krmarien
+source/_integrations/foscam.markdown @krmarien
 source/_integrations/freebox.markdown @hacf-fr @Quentame
 source/_integrations/freedompro.markdown @stefano055415
 source/_integrations/fritz.markdown @mammuth @AaronDavidSchneider @chemelli74 @mib1185
@@ -341,6 +342,7 @@ source/_integrations/homeassistant_yellow.markdown @home-assistant/core
 source/_integrations/homekit.markdown @bdraco
 source/_integrations/homekit_controller.markdown @Jc2k @bdraco
 source/_integrations/homematic.markdown @pvizeli
+source/_integrations/homematicip_cloud.markdown @hahn-th
 source/_integrations/homewizard.markdown @DCSBL
 source/_integrations/honeywell.markdown @rdfurman @mkmer
 source/_integrations/http.markdown @home-assistant/core
@@ -388,7 +390,7 @@ source/_integrations/iperf3.markdown @rohankapoorcom
 source/_integrations/ipma.markdown @dgomes
 source/_integrations/iqvia.markdown @bachya
 source/_integrations/irish_rail_transport.markdown @ttroy50
-source/_integrations/islamic_prayer_times.markdown @engrbm87
+source/_integrations/islamic_prayer_times.markdown @engrbm87 @cpfair
 source/_integrations/ismartwindow.markdown @starkillerOG
 source/_integrations/iss.markdown @DurgNomis-drol
 source/_integrations/isy994.markdown @bdraco @shbatm
@@ -430,7 +432,7 @@ source/_integrations/leaone.markdown @bdraco
 source/_integrations/led_ble.markdown @bdraco
 source/_integrations/legrand.markdown @cgtobi
 source/_integrations/leviton_z_wave.markdown @home-assistant/z-wave
-source/_integrations/lg_netcast.markdown @Drafteed
+source/_integrations/lg_netcast.markdown @Drafteed @splinter98
 source/_integrations/lidarr.markdown @tkdrob
 source/_integrations/light.markdown @home-assistant/core
 source/_integrations/linear_garage_door.markdown @IceBotYT
@@ -494,7 +496,7 @@ source/_integrations/mopeka.markdown @bdraco
 source/_integrations/motion_blinds.markdown @starkillerOG
 source/_integrations/motionblinds_ble.markdown @LennP @jerrybboy
 source/_integrations/motioneye.markdown @dermotduffy
-source/_integrations/mqtt.markdown @emontnemery @jbouwh
+source/_integrations/mqtt.markdown @emontnemery @jbouwh @bdraco
 source/_integrations/msteams.markdown @peroyvind
 source/_integrations/mullvad.markdown @meichthys
 source/_integrations/mutesync.markdown @currentoor
@@ -573,7 +575,6 @@ source/_integrations/overkiz.markdown @imicknl @vlebourl @tetienne @nyroDev @tro
 source/_integrations/ovo_energy.markdown @timmo001
 source/_integrations/p1_monitor.markdown @klaasnicolaas
 source/_integrations/panel_custom.markdown @home-assistant/frontend
-source/_integrations/panel_iframe.markdown @home-assistant/frontend
 source/_integrations/pcs_lighting.markdown @gwww
 source/_integrations/peco.markdown @IceBotYT
 source/_integrations/peco_opower.markdown @tronikos
@@ -583,7 +584,7 @@ source/_integrations/permobil.markdown @IsakNyberg
 source/_integrations/persistent_notification.markdown @home-assistant/core
 source/_integrations/pge.markdown @tronikos
 source/_integrations/philips_js.markdown @elupus
-source/_integrations/pi_hole.markdown @johnluetke @shenxn
+source/_integrations/pi_hole.markdown @shenxn
 source/_integrations/picnic.markdown @corneyl
 source/_integrations/pilight.markdown @trekky12
 source/_integrations/ping.markdown @jpbede
@@ -615,7 +616,7 @@ source/_integrations/pushover.markdown @engrbm87
 source/_integrations/pvoutput.markdown @frenck
 source/_integrations/pvpc_hourly_pricing.markdown @azogue
 source/_integrations/qbittorrent.markdown @geoffreylagaisse @finder39
-source/_integrations/qingping.markdown @bdraco @skgsergio
+source/_integrations/qingping.markdown @bdraco
 source/_integrations/qld_bushfire.markdown @exxamalte
 source/_integrations/qnap.markdown @disforw
 source/_integrations/qnap_qsw.markdown @Noltari
@@ -669,7 +670,7 @@ source/_integrations/ruckus_unleashed.markdown @lanrat @ms264556 @gabe565
 source/_integrations/ruuvi_gateway.markdown @akx
 source/_integrations/ruuvitag_ble.markdown @akx
 source/_integrations/rympro.markdown @OnFreund @elad-bar @maorcc
-source/_integrations/sabnzbd.markdown @shaiu
+source/_integrations/sabnzbd.markdown @shaiu @jpbede
 source/_integrations/saj.markdown @fredericvl
 source/_integrations/samsam.markdown @klaasnicolaas
 source/_integrations/samsungtv.markdown @chemelli74 @epenet
@@ -731,16 +732,17 @@ source/_integrations/smhi.markdown @gjohansson-ST
 source/_integrations/sms.markdown @ocalvo
 source/_integrations/smud.markdown @tronikos
 source/_integrations/snapcast.markdown @luar123
+source/_integrations/snmp.markdown @nmaggioni
 source/_integrations/snooz.markdown @AustinBrunkhorst
-source/_integrations/solaredge.markdown @frenck
+source/_integrations/solaredge.markdown @frenck @bdraco
 source/_integrations/solaredge_local.markdown @drobtravels @scheric
 source/_integrations/solarlog.markdown @Ernst79
 source/_integrations/solax.markdown @squishykid
 source/_integrations/soma.markdown @ratsept @sebfortier2288
 source/_integrations/somfy.markdown @imicknl @vlebourl @tetienne @nyroDev @tronix117
 source/_integrations/sonarr.markdown @ctalkington
 source/_integrations/songpal.markdown @rytilahti @shenxn
-source/_integrations/sonos.markdown @jjlawren
+source/_integrations/sonos.markdown @jjlawren @peterager
 source/_integrations/soundtouch.markdown @kroimon
 source/_integrations/spaceapi.markdown @fabaff
 source/_integrations/speedtestdotnet.markdown @rohankapoorcom @engrbm87
@@ -776,7 +778,7 @@ source/_integrations/switchbot.markdown @danielhiversen @RenierM26 @murtas @Elos
 source/_integrations/switchbot_cloud.markdown @SeraphicRav
 source/_integrations/switcher_kis.markdown @thecode
 source/_integrations/switchmate.markdown @danielhiversen @qiz-li
-source/_integrations/symfonisk.markdown @jjlawren
+source/_integrations/symfonisk.markdown @jjlawren @peterager
 source/_integrations/syncthing.markdown @zhulik
 source/_integrations/syncthru.markdown @nielstron
 source/_integrations/synology_dsm.markdown @hacf-fr @Quentame @mib1185
@@ -899,7 +901,7 @@ source/_integrations/wirelesstag.markdown @sergeymaysak
 source/_integrations/withings.markdown @joostlek
 source/_integrations/wiz.markdown @sbidy
 source/_integrations/wled.markdown @frenck
-source/_integrations/wolflink.markdown @adamkrol93
+source/_integrations/wolflink.markdown @adamkrol93 @mtielen
 source/_integrations/workday.markdown @fabaff @gjohansson-ST
 source/_integrations/worldclock.markdown @fabaff
 source/_integrations/ws66i.markdown @ssaenger

_config.yml

@@ -109,9 +109,9 @@ social:
 
 # Home Assistant release details
 current_major_version: 2024
-current_minor_version: 4
-current_patch_version: 4
-date_released: 2024-04-23
+current_minor_version: 5
+current_patch_version: 0
+date_released: 2024-05-01
 
 # Either # or the anchor link to latest release notes in the blog post.
 # Must be prefixed with a # and have double quotes around it.

source/_dashboards/iframe.markdown

@@ -55,6 +55,11 @@ title:
   required: false
   description: The card title.
   type: string
+allow:
+  required: false
+  description: The [Permissions Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Permissions-Policy#iframes) of the iframe, that is, the value of the [`allow`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe#allow) attribute.
+  type: string
+  default: "fullscreen"
 {% endconfiguration %}
 
 ### Examples

source/_dashboards/map.markdown

@@ -63,11 +63,11 @@ default_zoom:
   description: The default zoom level of the map.
   type: integer
   default: 14 (or whatever zoom level is required to fit all visible markers)
-dark_mode:
+theme_mode:
   required: false
-  description: Enable a dark theme for the map.
-  type: boolean
-  default: false
+  description: 'Override the theme to force the map to display in either a light mode (`theme_mode: light`) or a dark mode (`theme_mode: dark`). Default (`theme_mode: auto`) will follow the theme settings.'
+  type: string
+  default: 'auto'
 hours_to_show:
   required: false
   description: Shows a path of previous locations. Hours to show as path on the map.
@@ -141,3 +141,4 @@ entities:
     focus: false
 hours_to_show: 48
 ```
+

source/_docs/configuration/templating.markdown

@@ -732,12 +732,16 @@ For example, if you wanted to select a field from `trigger` in an automation bas
 
   {% endraw %}
 
-- `as_datetime(value, default)` converts a string containing a timestamp, or valid UNIX timestamp, to a datetime object. If that fails, returns the `default` value, or if omitted raises an error. This function can also be used as a filter.
+- `as_datetime(value, default)` converts a string containing a timestamp, or valid UNIX timestamp, to a datetime object. If that fails, it returns the `default` value or, if omitted, raises an error. When the input is already a datetime object it will be returned as is. in case the input is a datetime.date object, midnight will be added as time. This function can also be used as a filter.
 - `as_timestamp(value, default)` converts datetime object or string to UNIX timestamp. If that fails, returns the `default` value, or if omitted raises an error. This function can also be used as a filter.
 - `as_local()` converts datetime object to local time. This function can also be used as a filter.
 - `strptime(string, format, default)` parses a string based on a [format](https://docs.python.org/3.10/library/datetime.html#strftime-and-strptime-behavior) and returns a datetime object. If that fails, it returns the `default` value or, if omitted, raises an error.
-- `relative_time` converts datetime object to its human-friendly "age" string. The age can be in second, minute, hour, day, month or year (but only the biggest unit is considered, e.g., if it's 2 days and 3 hours, "2 days" will be returned). Note that it only works for dates _in the past_.
-  - Using `relative_time()` will cause templates to be refreshed at the start of every new minute.
+- `time_since(datetime, precision)` converts a datetime object into its human-readable time string. The time string can be in seconds, minutes, hours, days, months, and years. `precision` takes an integer (full number) and indicates the number of units returned.  The last unit is rounded. For example: `precision = 1` could return "2 years" while `precision = 2` could return "1 year 11 months". This function can also be used as a filter.
+If the datetime is in the future, returns 0 seconds.
+A precision of 0 returns all available units, default is 1.
+- `time_until(datetime, precision)` converts a datetime object into a human-readable time string. The time string can be in seconds, minutes, hours, days, months, and years. `precision` takes an integer (full number) and indicates the number of units returned.  The last unit is rounded. For example: `precision = 1` could return "2 years" while `precision = 2` could return "1 year 11 months". This function can also be used as a filter.
+If the datetime is in the past, returns 0 seconds.
+A precision of 0 returns all available units, default is 1.
 - `timedelta` returns a timedelta object and accepts the same arguments as the Python `datetime.timedelta` function -- days, seconds, microseconds, milliseconds, minutes, hours, weeks.
 
   {% raw %}

source/_docs/configuration/troubleshooting.markdown

@@ -123,3 +123,14 @@ After you download logs, you will also want to download the diagnostics for the
   <img src='/images/docs/configuration/download-diagnostics.png' alt='Example of Download Diagnostics'>
   Example of Download Diagnostics.
 </p>
+
+### Handling unexpected restarts or crashes
+
+Suppose you find that Home Assistant unexpectedly restarts or crashes; it's likely that you have a misbehaving integration impacting system stability. Home Assistant has a built-in debug option that can help find implementation errors. It can also block many unsafe thread operations from crashing the system. Enabling debug has a slight performance impact on the system and is not recommended for long-term use. To enable debug, add the following to your `configuration.yaml`:
+
+```yaml
+homeassistant:
+  debug: true
+```
+
+Once debug is enabled, periodically check [Home Assistant System Logs](https://my.home-assistant.io/redirect/logs) for new messages.

source/_docs/organizing/areas.markdown

@@ -44,3 +44,47 @@ If an area has not yet been assigned to a floor, it is shown in the **Unassigned
 1. Go to {% my areas title="**Settings** > **Areas, labels & zones**" %} and select **Create area**.
 2. On the area card, select the pencil icon.
 3. In the dialog, select the floor and add labels, if you like.
+
+## Assigning an area to multiple items
+
+You can assign an area to multiple items at once in the automation, scene, script, and device pages.
+
+1. Depending on what you want to assign, go to one of the following pages:
+   - For automations, scripts, or scenes {% my automations title="**Settings** > **Automations & Scenes**" %} and open the respective tab.
+   - For devices, go to {% my devices title="**Settings** > **Devices & services** > **Devices**" %}.
+2. In the list, [select all the items](/docs/organizing/filtering#selecting-multiple-items-in-a-table) you want to assign to an area.
+
+    ![Screenshot showing how to assign multiple devices to an area](/images/organizing/area_assign_devices.png)
+
+3. In the top right corner, select **Move to area** and select the target area from the list.
+
+## Editing an area
+
+Follow these steps to edit an area.
+
+1. Go to {% my areas title="**Settings** > **Areas, labels & zones**" %} and on the area card, select the pencil icon.
+2. In the dialog, adjust the area details you want to change:
+   - Edit the area **Name**.
+   - Add an icon (We use [Material icons](https://pictogrammers.com/library/mdi/)).
+   - Assign the area to a floor.
+     - If you have not created floors yet, you can [create a new one](/docs/organizing/floors/#creating-a-floor).
+     - The number can be negative. For example for underground floors.
+     - This number can later be used for sorting.
+   - Add an image representing that area.
+   - Add an **Alias**.
+     - Aliases are alternative names used in [voice assistants](/voice_control/aliases/) to refer to an area, entity, or floor.
+
+## Deleting an area
+
+Follow these steps to delete an area. It will be removed from all the floors it was assigned to. All the devices that were assigned to this area will become unassigned.
+If you used this area in automations or script as targets, or with voice assistant, these will no longer work.
+
+1. Go to {% my areas title="**Settings** > **Areas, labels & zones**" %} and select the area card.
+2. In the top right corner, select the three dot menu. Then, select **Delete**.
+
+    ![Delete area](/images/organizing/area_delete.png)
+
+3. If you used this area in automations or script as targets, or with voice assistant, they will no longer work.
+   - You can adjust or delete the related scripts or automations.
+4. If you still had devices in that area, they are no longer assigned to any room.
+   - If you have moved the devices, you can now reassign them to a new area.

source/_docs/organizing/filtering.markdown

@@ -16,7 +16,7 @@ related:
     title: Enabling or disabling entities and automations
 ---
 
-When working with tables, you can select multiple elements to apply an action on multiple items at once. If you have [grouped](/docs/organizing/) your assets by assigning them to floors, areas, labels, or directories you can also filter your data accordingly.
+When working with tables, you can select multiple items to apply an action. If you have [grouped](/docs/organizing/) items by assigning them to floors, areas, labels, or directories, you can also filter your data accordingly.
 
 ## Selecting multiple items in a table
 
@@ -40,6 +40,7 @@ You can filter a table so that only items matching certain criteria are shown.
 
 2. In the filters panel, select your filter criteria.
    - You can filter for [floors](/docs/organizing/floors/), [areas](/docs/organizing/areas/), [labels](/docs/organizing/labels/), and [categories](/docs/organizing/categories/) if you have previously defined them.
+   - The list of available criteria depends on the type of table.
 
     ![Screenshots showing the filter panel that tables can have, allowing you to easily find what you are looking for](/images/organizing/filter-panel.png)
 
@@ -49,8 +50,13 @@ You can group items in a table according to certain criteria. The number of show
 
 1. In the top right above the table, select the **Group by** button.
 2. The items will be grouped according to the criteria you chose.
-   - In the example, the items are grouped by manufacturer.
+   - The list of available criteria depends on the type of table.
+     - The example shows a list of devices, grouped by manufacturer.
+     - In contrast, the entities table does not allow grouping by manufacturer, but by entity domains.
 
     ![Select the Group by button](/images/organizing/table_group_01.png)
 
 3. To sort the items, select the **Sort by** button.
+4. To get a better overview, you can collapse groups in the list.
+
+    ![Collapse groups](/images/organizing/table_group_collapse.png)