2023.12：欢迎回家！

    Home Assistant 核心 2023.12! 🎄

    The last 发布 of 2023 is here, and we are going out with a bang! 🎉

    2023 has been the Year of the Voice, and please stay tuned, as we will host a final 5th chapter live stream on our YouTube channel on 13 December 2023, at 12:00 PST / 21:00 CET! But that is not the end of the voice journey... Be sure to tune in!

    This 发布 has some nice quality-of-life improvements, making it feel like Christmas already! The thermostat 卡片 has been redesigned to match the gorgeous new 实体 dialog introduced, a new feature for the ever-improving tile 卡片, re-importing blueprints, and much more!

    I'm most excited about the new login page that this 发布 brings. It is beautiful, modern, and literally welcomes you into your own home! 🏡 Home is where Home Assistant is, right? 😃

    This is it for 2023! What a year it has been! I just got one last thing to say this year:

    Thank you for using Home Assistant! ❤️

    Happy holidays & enjoy the 发布!

    ../Frenck

    Don't forget to join our 发布 party live stream on YouTube 6 December 2023, at 12:00 PST / 21:00 CET!

    漂亮的新登录页

    Note

    This feature has been disabled in Home Assistant 2023.12.3.
    Read more about it here.

    The login page of Home Assistant has been redesigned to be more modern and match the recent redesign of the Home Assistant onboarding.

    When Home Assistant detects you are accessing it via your local home network, it means you are in your trusted home environment; you will be greeted by this beautiful new login page, which resembles how most platforms, like Windows, macOS, Netflix, and others, handle this: by showing your user profiles.

    Screenshot of the new Home Assistant login screen that allows you to click on your profile picture to 日志 in.

    It is also much smarter! It works seamlessly with trusted networks, and when home, we automatically remember your login. So, no more forgetting to check the "keep me logged in" checkbox. 👊

    Of course, when logging in from outside your home network, we can't do this as that would give away privacy-sensitive information about your system and who is in it. So, when you are outside of your home network, the login page will ask for your username and password, just like before.

    Screenshot showing the new login screen, when accessing from the external network. It will still prompt for a username & password, protecting your privacy.

    Oh! And you can now change the language straight from the login page! 🌍

    温控卡片的新设计

    Home Assistant 2023.9 introduced a gorgeous new 实体 dialog for thermostat 实体. As a result of that, many have been asking for a similar design for the thermostat 卡片. Well, here it is!

    Screenshot showing two thermostat 卡片 that showcase their stunning new looks.

    There is nothing you have to do to use this new 卡片. Once you 升级 to this 发布, the thermostat 卡片 will automatically use this gorgeous new design.

    We took it one step further and added support for features. Features are additional functionality that you can add to a 卡片, previously only available for the tile 卡片. This 发布 adds support for features to the thermostat 卡片 as well!

    Screenshot that shows the new features available when configuring a thermostat 卡片.

    For the thermostat 卡片, it allows you to add HVAC mode buttons and presets. By default, these features are hidden, giving it the cleanest look possible.

    Oh! The same design has been applied to the (de)humidifer 卡片, of course, including its respective tile features 😎.

    Screenshot showing the same styling has been applied to the 加湿器 卡片.

    Tile 卡片的数字输入功能

    The tile 卡片 is very powerful, and @JosephAbbey is even extending it this 发布 by adding a new "numeric input" feature.

    The numeric input feature works with all number 实体 and number helpers. It allows you to control the number 实体 from the tile 卡片 directly and provides the choice to use it as a slider or as an input with up/down buttons.

    Screenshot showing two tile 卡片, one showing the button variant, the other displaying a slider.

    默认仪表盘选项

    The default 仪表盘 now has options that will allow you to change its behavior. You can now 配置 the default 仪表盘 to hide certain areas, hide 实体 that don't belong to an area, and the option to hide the energy summary 卡片.

    Screenshot that shows the new options available for the generated default 仪表盘.

    When selecting Areas, you can choose to hide the areas but also change the display order of the areas by dragging them around.

    A first step in making the 仪表盘 configurable, but above all, it gives you more control over the default 仪表盘, especially when you have just started with using Home Assistant.

    When adding a new 仪表盘, we added a dialog similar to the ones we show when you create new 自动化 or 脚本. It gives you the option to start with an empty manual 仪表盘 or create a new default 仪表盘.

    Screenshot that shows the new dialog you get presented when creating a new 仪表盘.

    显示长期统计的历史仪表盘

    The history 仪表盘 did get some love from @karwosts this 发布; he added a big improvement to all the graphs shown there.

    Previously, the graphs would only show the 状态 history, limited to a few days, until the data is removed. This is not always very useful, for example, when you want to look back further in time.

    @karwosts came up with a solution for this, and the history 仪表盘 now combines the 状态 history with the recorded long-term statistics to provide insights into the past.

    Screenshot showing a history graph over a longer period of time.

    The right and darker part of the graph line is provided by the 状态 history (like before), and the long-term statistics provide the left and lighter part of the graph line (and is thus downsampled hourly data).

    If you have manually 修改 the days to keep before purging recorder on your system, consider removing that customization. With the long-term statistics and new feature, you most likely don’t need it anymore, resulting in a smaller database and, thus, faster and smaller backups.

    更多待办！

    The first iteration for support for to-do lists was added in the last 发布, and there has been continued work on this feature in this 发布.

    First of all, there are two new 服务 available. A much-requested 服务 to list all items on a to-do list and a helpful 服务 to remove all completed items from a to-do list.

    It is nice to see 集成 adding support for the to-do list feature. For example, the CalDAV 集成 now supports adding to-do items to your CalDAV server, and with Picnic and OurGroceries you can now manage your shopping list. In the case of Picnic, it will even look up the product you add in their store to your shopping list and add the product to your shopping cart.

    Also, when viewing a to-do list from the Home Assistant interface, you can copy/paste or bookmark the URL, which will always bring you back to the same one—a small but very helpful improvement.

    重新导入蓝图

    This 发布 adds the ability to re-import the blueprint from the source from which you originally imported it. The newly downloaded blueprint will overwrite the existing blueprint, providing a simple "更新" feature for blueprints.

    If you use Blueprints, for example, the ones 创建 by our incredible community, you might have noticed that when you import a blueprint, it will not 更新 when the author updates it. The only option you had was to manually adjust the YAML of the blueprint to make it match the latest 版本 published by the author. To make this last bit easier, we added this re-import ability.

    Screenshot showing that the overflow menu of a blueprint now provides the option to re-import an blueprint.

    A helpful feature that will make it easier to keep your blueprints in sync with the latest 版本 published by the blueprint author.

    其他值得注意的变更

    There are many more improvements in this 发布; here are some of the other noteworthy changes this 发布:

    • We have a brand new 触发器 selector for you to use in your Blueprints and 脚本. Thanks, @piitaya!
    • That is not all for selectors, @schelv added support for Kelvin to the color temperature selector. Nice!
    • If you use the IKEA IDÅSEN desk, you will now have a height 传感器! Thanks @abmantis!
    • The ESPHome 集成 had many performance improvements, making it faster and more reliable. Thanks @bdraco!
    • @Lash-L added support for displaying maps from your Roborock 吸尘器! Awesome!
    • 服务 with a response now support handling responses when multiple 实体 are targeted. Nice! Thanks @eifinger!
    • @iMicknl added local API support for the Somfy TaHoma to the Overkiz 集成! Also, thanks Somfy! It's nice to see a manufacturer adding local API support!
    • The ViCare received tons of love from @CFenner; keep up the good work!
    • The media browser now has support for toggling between grid and list view. Thanks @karwosts!
    • @emontnemery worked hard to improve all 错误 messages originating from manual YAML 配置. The messages should now be more detailed, readable, and correctly pinpoint which file and file line the 错误 is located at. Awesome!
    • @karwosts 创建 a UI when you want to add selectors to your 脚本 field! Very nicely done!
    • 错误 shown by Home Assistant can now be translated! While many places still need to adopt this, it is a big and user-friendly step forward! Outstanding job @jbouwh!

    新集成

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

    现已支持通过 UI 配置的集成

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

    发布 2023.12.1 - December 8

    发布 2023.12.2 - December 13

    发布 2023.12.3 - December 14

    发布 2023.12.4 - December 27

    需要帮助？加入社区！

    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.

    不向后兼容的变更

    calendar.list_events uses an outdated response data format and is now deprecated, pending removal in Home Assistant 2024.6.

    Please use calendar.get_events, which supports multiple 实体, instead.

    The output of this newer 服务 changed slightly, as it now returns a mapping of 实体 IDs to lists of events instead of a list of events.

    (@eifinger - #102481) (文档)

    The previously deprecated counter.configure 服务 has been removed.

    (@gjohansson-ST - #103204) (文档)

    DSMR 实体 will not automatically 更新 on each received DSMR telegram when the value between telegrams has not changed.

    If you rely on this, for example, for graphing, please refer to the statistics integrations.

    (@gigatexel - #104037) (文档)

    For users using the 5B 版本: The previous gas 传感器 (Gas consumption) will change to Gas consumption mbusX. Also, multiple gas 传感器 will be possible.

    (@dupondje - #84097) (文档)

    The previously deprecated detection sensitivity 服务 has been removed.

    (@gjohansson-ST - #103392) (文档)

    The initial 状态 of the smart plug did not reflect the same 状态 as in the Genius Hub application. Correcting this creates a backward-incompatible change in that the behavior is now correct but different.

    If you have an 自动化 that relies on this 状态, you should check if your 自动化 or 脚本 is still behaving as expected.

    (@GeoffAtHome - #102110) (文档)

    When calling a 服务 via the Home Assistant REST API, the 服务 used to be canceled on connection drop, which is no longer the case. If you relied on that behavior, you would need to revisit the logic. With this change, a connection drop will not cancel the 服务 call.

    Also, a REST post to call a 服务 with the /api/services/<domain>/<service> endpoint will no longer timeout after 10 seconds.

    (@Shulyaka - #102657) (@MartinHjelmare - #104709) (文档)

    The HomeWizard HWE-SKE (the wall plugs), SDM230, and SDM630 provided duplicate 传感器 for energy import and export: A total and a tariff of 1.

    As only a single tariff is available on those, the total and tariff 1 are always the same. To clean this up, tariff 1 has been removed.

    If you used this 传感器 in your energy 仪表盘, you will need to 配置 your energy 仪表盘 to use the total import/export 传感器 instead.

    (@frenck - #104493) (文档)

    S-Series 实体 priority-3102, hot-water-demand-mode-40057, and oper-mode-40238 are changed from a number 实体 to a select 实体 with mapping values for the possible choices.

    If you have the old number 实体 enabled, you can delete them since they will no longer be provided by the 集成.

    (@elupus - #103788) (文档)

    Remove rounding of the exchange rate.

    Exchange rates are generally more sensitive to small changes, and some quotes need many decimal numbers to be accurate. The Open Exchange Rates 服务 will provide different significant digits for different quotes.

    You can change the display precision or use a template 传感器 to customize the rounding of the value.

    (@MartinHjelmare - #103972) (文档)

    The option to set a custom polling interval has been removed. If you are using custom interval and really need it, you can use the homeassistant.update_entity in an 自动化 to poll at your custom pace. See our 文档 on defining a custom polling interval 更多信息.

    (@jpbede - #103743) (文档)

    Support for the, in November 2019 deprecated, 属性 brightness_pct, color_name, flash, kelvin, profile, and transition have been removed from 灯光 场景.

    If you have used these 属性 in your 场景, you will need to adjust those to this change.

    (@emontnemery - #104254) (文档)

    The SMTP 集成 will send images as attachments to a plain text email instead of HTML in-line when the html field is not set.

    Previous behavior was to send all images as HTML in-line even when the html field was not set. To continue sending images as in-line, please set the optional html field and include the images as <img src="cid:image_name.ext"> within the HTML block as described in the 文档.

    (@aptalca - #93562) (文档)

    Trafikverket Weather has changed its endpoint and is no longer providing the information for wind direction and precipitation in plain text, so therefore, these 传感器 have been removed:

    • Wind direction text
    • Precipitation name

    (@gjohansson-ST - #104165) (文档)

    weather.get_forecast uses an outdated response data format and is now deprecated, pending removal in Home Assistant 2024.6.

    Please use weather.get_forecasts, which supports multiple 实体 instead.

    The output of this newer 服务 changed slightly, as it now returns a mapping of 实体 IDs to lists of forecasts instead of a list of forecasts.

    (@eifinger - #102534) (文档)

    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 发布:

    • MyQ has been removed. Read all about it in our 博客 post.
    • eQ-3 蓝牙 Smart Thermostats have been removed. The 集成 has been in a non-functional 状态 for a long time.

    全部变更

    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.12