{% if pending_update %}
{% endif %} {% if prerelease %}
{% endif %}
UPDATE January 2022: The official integration Denon HEOS had grouping features implemented as of Home Asssitant version 2021.12 and this custom integration should not be necessary anymore. It may be deprecated after a time of testing. OBS! If using the mini-media-player card for grouping, note that platform must be changed from 'heos' to 'media_player' for the speaker_group setting (see here). Feel free to continue using the custom integration, it may be used for testing other features like media browsing and similar.
--
The official integration for Denon HEOS in Home Assistant unfortunately lacks the grouping feature. Work is ongoing to add such features to the official integration, but due to some architectual discussions and the time it takes to conclude those, this custom integration allows HEOS-users to start grouping already today. Once this is implemented in the official integration, this custom integration will probably cease to exist. Follow the progress on official work (by others) here and here.
The grouping feature is available as service calls join and unjoin but for the best user experience I recommend using the amazing mini-media-card which has the grouping feature working from UI/Lovelace.
DISCLAIMER: I am not the codeowner of the official HEOS integration and do not take credit for anything else but adding a grouping-hack while waiting for official support of the feature. Credits for the hard work belongs to Andrew Sayre who is the author of both the official integration and the PyHeos library.
Configuration is done through UI/Lovelace. In Home Assistant, click on Configuration > Integrations where you add it with the + icon.
This custom integration should work the same way as the official integration but has added a grouping feature to enable you to group you speakers - just like you can do it in the HEOS app on you mobile or tablet.
Either use the service calls join and unjoin, and be sure to check out the amazing mini-media-card which has the grouping feature working from UI/Lovelace. With that card you can control grouping easily from your UI.
For further information, see README