2023.5: Let''s talk!

Home Assistant 核心 2023.5! 🎉

What an exciting 发布 we have for you this month! This 发布 is all about voice (well, almost fully), and I'm super excited we can ship you all this truly amazing stuff!

I've been following the progress of this all being built this month, and really, I've been mindblown multiple times a week. So what is in here? Well, you can now actually talk to Home Assistant! 🤯

I really appreciate that all these voice elements have been built the Home Assistant way: to be fully configurable and extendable. Giving you choices, including entirely local options for your own voice assistant.

This 发布 is packed! And we are not even halfway through Home Assistant's Year of the voice yet…

Enjoy the 发布!

../Frenck

Don't forget to join our 发布 party live stream on YouTube 3 May 2023, at 12:00 PDT / 21:00 CEST!

来聊聊吧!

Our goal for 2023 is to let you control Home Assistant in your own language: It is Home Assistant’s Year of the Voice! After chapter 1 in January, we announced chapter 2 in this exciting journey last week!

This 发布 ships everything (plus more) that was announced! This means, as of this 发布, you can actually start talking to Home Assistant! 🎙️

Here is a quick summary of all that has been announced, linked to the place you can read more about each of them:

To help you get started, we made sure the 文档 is perfect, including some cool project tutorials to jump-start your own private voice assistant journey:

If you missed last week's live stream, be sure to check it out. It is full of live demos and detailed explanations of everything packed into this 发布. The recording of the live stream:

管理暴露给语音助手的实体

A brand new and exciting menu item can be found in your 设置 menu: Voice assistants!

Screenshot showing the brand new menu item in the 设置 menu: Voice assistants.

This new 设置 item gives you access to many fantastic new voice features; it also provides a new Expose tab where you can manage which 实体 are exposed to your Assist, Alexa, and Google Assistant.

Screenshot showing the new expose 实体 tab in the voice assistants menu.

It gives an 概述 of what 实体 you have exposed to your voice assistants and easily remove or add new ones. Clicking on an 实体 in this screen will bring up the voice assistant setting for that 实体, allowing you to turn on/off the 实体's exposure to a specific voice assistant and manage the 实体's aliases.

Screenshot showing the new expose 实体 tab in the voice assistants menu.

This currently supports our Assist, and Amazon Alexa and Google Assistant via Home Assistant Cloud.

改进后的实体设置

Some nice tweaks have been made to the 实体 设置 dialog, making it easier to use and look cleaner.

The 实体 设置 dialog used to have an expandable advanced section, which you could expand to access features like showing/hiding/disabling 实体, changing the area, etc.

The advanced section has been removed, and all its features have been reorganized. So, no features were lost while providing a much nicer interface.

Screenshot showing the new and improved 实体 设置 dialog.

And, since this is the year of the voice, you may notice the "Voice assistants" option in the above screenshot, which will bring up:

Screenshot showing the new voice assistant expose controls accessible directly from the 实体 设置 dialog.

This allows you to quickly change the voice assistants the 实体 is exposed to, including its aliases, without having to navigate back to the voice assistants 面板 in the main 设置 screen.

配置 Home Assistant Yellow 的 LED

The enclosure of our amazing Home Assistant Yellow allows you to look at the beautiful board and parts inside of it.

However, the LEDs on the board might 灯光 up your environment when it is dark in an unwanted way. For example, when you sleep in the same room as your Home Assistant Yellow is in.

As of this 发布, you can 配置 (打开/off) the disk, heartbeat, and power LEDs of your Home Assistant Yellow by using the 配置 button on the 设置 > Hardware page.

Screenshot that show the new LED 设置 for the Home Assistant Yellow.

Webhook 触发器选项

Webhooks have been extended this 发布. We now have support for webhooks that use the GET HTTP method!

But that is not all. Thanks to @esev, we also got some new security features for our webhook 触发器. You can now set which HTTP methods your webhook 触发器 work with and the ability to limit webhooks to only work on your local network.

Screenshot showing the new options available on a Webhook 自动化 触发器.

全新的 Assist 流水线与语言选择器

If you are building 自动化 or 脚本 Blueprints, you can now leverage two new UI selectors for use with your Blueprints: an Assist pipeline selector and a language selector.

Screenshot showing the language selector. The language selector let's a user choose from a list of languages.

You could, for example, leverage this in a 通知 Blueprint to allow setting a different language on a text-to-speech 通知.

More information can be found in our selectors 文档.

其他值得注意的变化

There is much more juice in this 发布; here are some of the other noteworthy changes this 发布:

  • Home Assistant Operating System v10 has been released! The ODROID M-1 is now supported, improved data disk support and memory management. Bug fixes and reliability improvements for 蓝牙 and Thread.
  • Matter now has support for 遮盖, thanks @hidaris!
  • The process of making backups is now faster 🚀, thanks @bdraco!
  • @bdraco also gave the ONVIF 集成 some love, which should improve the stability of the 集成. Nice!
  • You can now set up multiple instances of the OpenAI Conversation 集成 with, for example, different prompts. Thanks, @balloob!
  • @rubenbe added direction support to MQTT 风扇! Nice!
  • BTHome added support for button and dimmer events. This means it supports the brand new Shelly BLU Button1! Thanks, @Ernst79!
  • The Supervisor can now create repair issues for some of the issues it detected on your system. Awesome @mdegat01!
  • @mib1185 added a 服务 to allow sorting of the Shopping list. Thanks!
  • @depoll added an 属性 to the Person 实体 that list the 设备 trackers for this person. Very useful for templates! Thanks!
  • The NextDNS 集成 added a whole bunch of new parental control 开关, thanks @bieniu!
  • Synology DSM can now browse your Synology Photos in the media browser. Cool addition, @lodesmets!
  • Simplepush now supports attachments, thanks to @tymm!
  • Some Z-Wave 通知 传感器 won't clear to idle automatically. Now you can use the new 通知 idle buttons to idle them manually!

New 集成

We welcome the following new 集成 in this 发布:

This 发布 also has a new virtual 集成. Virtual 集成 are stubs that are handled by other (existing) 集成 to help with findability. This one is new:

现已可通过 UI 设置的集成

The following 集成 are now available via the Home Assistant UI:

发布 2023.5.1 - May 4

发布 2023.5.2 - May 5

发布 2023.5.3 - May 14

发布 2023.5.4 - May 23

需要帮助?加入社区!

Home Assistant has a great community of users who are all more than willing to help each other out. So, join us!

Our very active Discord chat server is an excellent place to be at, and don't forget to join our amazing forums.

Found a bug or issue? Please report it in our issue tracker, to get it fixed! Or, check our help page for guidance for more places you can go.

Are you more into email? Sign-up for our Building the Open Home Newsletter to get the latest news about features, things happening in our community and other news about building an Open Home; straight into your inbox.

不向后兼容的变更

The ozone 传感器 and the ozone 状态 属性 of the weather 实体 showed incorrect values and are being removed. If you use these values in your 自动化 or 脚本, you need to 更新 them.

(@bieniu - #91492) (文档)

The "Android TV" 集成 has been renamed to "Android 调试 Bridge".

This rename is because that is what it actually controlled/provided. With the addition of the Android TV Remote 集成 in this 发布, we wanted to reduce possible confusion in the future.

(@tronikos - #90657) (文档)

All YAML 配置 options for the history 集成 have been removed as they were no longer used by the 前端.

(@bdraco - #90992) (文档)

The min/max target humidities for (de)加湿器 设备 exposed over HomeKit has changed. The HomeKit UI will now show the real relative humidity. When the slider in HomeKit goes above or below the max/min set humidity, it will be set back to the max/min allowed humidity.

(@stackia - #90854) (文档)


Default HomeKit to listen on all interfaces to match Home Assistant behavior. To limit HomeKit to specific network interfaces, specify an address in configuration.yaml.

(@bdraco - #91520) (文档)

The use of imap_content event could break for users that want to parse data from larger email messages from the truncated part. Only the first 2048 bytes of the message body (2 KiB) will be available.

(@jbouwh - #92066) (文档)

The silence option for DynamicShutter has been removed because it caused the 遮盖 实体 to be non-functional if it did not support silence. This functionality will be reintroduced in a future 发布.

(@iMicknl - #91354) (文档)

For Reolink doorbells, the "Status LED" 灯光 实体 is replaced by a "Status LED" select 实体. The 开关 off 状态 corresponds to the select Auto, and the 开关 on 状态 corresponds to the select Auto & always on at night. An additional Stay off 状态 is now available.

(@starkillerOG - #90469) (文档)

  • Muted groups with stream playing will have 状态 idle instead of playing.
  • Connected clients will not have 状态 on anymore but use the same 状态 as groups: idle and playing.
  • Disconnected clients have 状态 standby instead of off because the Snapcast server still accepts commands.

(@luar123 - #77449) (文档)

The unit conversion for all memory, storage, and network utilization-related 传感器 was corrected from binary (1024) to decimal (1000) base to be in line with the used measurement units (eq. MB = 1.000.000 bytes).

You may need to 更新 the historically recorded units for these 传感器 via the statistics page under 开发者工具.

(@mib1185 - #90633) (文档)

The ensure_ascii argument for to_json in Jinja templates now defaults to False, allowing us to use a faster JSON encoder by default.

This should not be an issue for most, as JSON parsers broadly accept Unicode input. If you still need to encode Unicode characters inside JSON strings, set ensure_ascii to True explicitly to 恢复 the old behavior.

(@depoll - #91253)

UniFi 集成 no longer provides both hostname and host_name 属性 for a client tracker 实体. Only host_name will be provided as an 属性.

(@Kane610 - #91188) (文档)

The previous deprecated set_doorbell_message 服务 has been removed. Use the text 实体 for the UniFi Protect LCD screen instead.

(@AngellusMortis - #91523) (文档)

The previously deprecated YAML 配置 of the Universal 设备 ISY/IoX 集成 has been removed.

Universal 设备 ISY/IoX is now configured via the UI. Any existing YAML 配置 has been imported in previous releases and can now be safely removed from your YAML 配置 files.

(@shbatm - #91575) (文档)


The built-in percentage unit % is now used for relative humidity and absolute humidity instead of the custom units %RH and %AH, respectively.

(@shbatm - #90863) (文档)


The following custom ISY994 服务 have been removed:

  • reload
  • cleanup_entities
  • system_query
  • set_ramp_rate
  • set_on_level
  • run_network_resource
  • set_variable

These 服务 had been previously deprecated in favor of built-in 服务 and number, select, and button 实体. Please 更新 your 自动化 and 仪表盘 to use the new 实体 and/or built-in 服务 if you have not already.

(@shbatm - #91569) (文档)


Dusk/Dawn nodes on Insteon Motion 传感器 now have their 状态 inverted to correctly show "灯光 detected" during daylight and "No 灯光" when the dusk 传感器 is active.

This is reversed from previous behavior. If you rely on this 传感器 in your 自动化, they must be updated.

(@shbatm - #92035) (文档)

Two new Webhook 触发器 options have been added that limit how a webhook can 触发器 an 自动化. A new allowed_methods option can be used to control which HTTP request methods can activate the 触发器 (GET, HEAD, POST, and PUT). And the local_only option is used to allow 设备 outside your local network to activate the 触发器.

Previously all webhook 触发器 could be activated by HEAD, POST, and PUT methods from any 设备 (local or on the internet). With the new options, only POST and PUT are enabled by default.

In Home Assistant 核心 2023.7, any webhook 触发器 that does not set local_only to false can only be activated by 设备 on the same network as Home Assistant.

Click the gear/cog icon beside the Webhook ID to 更新 your webhook 触发器. Then select an appropriate value for Only accessible from the local network. It is necessary to deselect the option for the Save button to appear. Then reselect the option if it should be enabled. This will make the repair 警告 go away.

Screenshot shoting webhook 触发器 options

See the webhook 触发器 文档 for a description of the new options. And please review the new Webhook Security section for best practices when using webhook 触发器.

(@esev - #66494) (文档)

With this 发布, you will need to 更新 your zwave-js-server instance. You must use zwave-js-server 1.28.0 or greater (schema 28).

  • If you use the Z-Wave JS add-on, you need at least 版本 0.1.79.
  • If you use the Z-Wave JS UI add-on, you need at least 版本 1.11.2.
  • If you use the Z-Wave JS UI Docker 容器, you need at least 版本 8.14.2.
  • If you run your own Docker 容器 or some other 安装 method, you will need to 更新 your zwave-js-server instance to at least 1.28.0.

(@raman325 - #91989) (文档)

If you are a custom 集成 developer and want to learn about breaking changes and new features available for your 集成: Be sure to follow our developer 博客. The following are the most notable for this 发布:

告别以下集成

The following 集成 are also no longer available as of this 发布:

所有变更

Of course, there is a lot more in this 发布. You can find a list of all changes made here: Full changelog for Home Assistant 核心 2023.5