From e3ce3a598d55981cea533303e6fcfb523a08a6fa Mon Sep 17 00:00:00 2001 From: Maciej Bieniek Date: Thu, 23 Apr 2026 12:08:44 +0200 Subject: [PATCH 1/6] Add media player entities to Shelly integration Added media player section and related details for Wall Display devices. --- source/_integrations/shelly.markdown | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown index d2c3a6f97d31..f557543fcfb7 100644 --- a/source/_integrations/shelly.markdown +++ b/source/_integrations/shelly.markdown @@ -8,6 +8,7 @@ ha_category: - Energy - Event - Light + - Media player - Number - Select - Sensor @@ -34,6 +35,7 @@ ha_platforms: - diagnostics - event - light + - media_player - number - select - sensor @@ -214,6 +216,14 @@ Depending on how a device's button type is configured, the integration will crea For generation 2+ hardware, it's possible to select if a device's input is connected to a button or a switch. Binary sensors are created only if the **Input Mode** is set to `Switch`. When the **Input Mode** is set to `Button` you need to use events for your automations. +## Media player entities + +Wall Display devices with firmware 2.2 or newer can function as media players and the integration creates media player entities for them. + +The Wall Display media player can play local audio files (you need to upload them to the Wall Display media library) and internet radio stations that you have added to your favorites in the device interface. + +These audio files and your favorite radio stations are visible in the Home Assistant media browser. + ## Event entities ### Event entities (generation 1) From 4c3e877dbd8de858438cdf93abeffea899de2680 Mon Sep 17 00:00:00 2001 From: Maciej Bieniek Date: Thu, 23 Apr 2026 14:29:56 +0200 Subject: [PATCH 2/6] Add examples --- source/_integrations/shelly.markdown | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown index f557543fcfb7..f2bc92f84540 100644 --- a/source/_integrations/shelly.markdown +++ b/source/_integrations/shelly.markdown @@ -224,6 +224,33 @@ The Wall Display media player can play local audio files (you need to upload the These audio files and your favorite radio stations are visible in the Home Assistant media browser. +### Play media using `media_player.play_media` action + +This action will start playing your favorite radio station with ID `2`: + +```yaml +action: media_player.play_media +data: + media: + media_content_id: 2 + media_content_type: radio +target: + entity_id: media_player.shelly_wall_display +``` + +This action will start playing your audio file with ID `15`: + +```yaml +action: media_player.play_media +data: + media: + media_content_id: 15 + media_content_type: audio +target: + entity_id: media_player.shelly_wall_display +``` + + ## Event entities ### Event entities (generation 1) From 852c8acbe78df48dff600e8c5c9dfd3a9cd09f7f Mon Sep 17 00:00:00 2001 From: Maciej Bieniek Date: Thu, 23 Apr 2026 14:30:33 +0200 Subject: [PATCH 3/6] Format --- source/_integrations/shelly.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown index f2bc92f84540..5f9307cc48e8 100644 --- a/source/_integrations/shelly.markdown +++ b/source/_integrations/shelly.markdown @@ -250,7 +250,6 @@ target: entity_id: media_player.shelly_wall_display ``` - ## Event entities ### Event entities (generation 1) From ca7cac607461466bde6d208283532fddb833187f Mon Sep 17 00:00:00 2001 From: Maciej Bieniek Date: Thu, 23 Apr 2026 14:37:02 +0200 Subject: [PATCH 4/6] Update source/_integrations/shelly.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/shelly.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown index 5f9307cc48e8..0e63855a24ea 100644 --- a/source/_integrations/shelly.markdown +++ b/source/_integrations/shelly.markdown @@ -218,7 +218,7 @@ For generation 2+ hardware, it's possible to select if a device's input is conne ## Media player entities -Wall Display devices with firmware 2.2 or newer can function as media players and the integration creates media player entities for them. +Wall Display devices with firmware 2.2 or newer can function as media players. The integration creates media player entities for them. The Wall Display media player can play local audio files (you need to upload them to the Wall Display media library) and internet radio stations that you have added to your favorites in the device interface. From b6cff774b3c475235752b781d95a34e149fbff82 Mon Sep 17 00:00:00 2001 From: Maciej Bieniek Date: Thu, 23 Apr 2026 14:37:27 +0200 Subject: [PATCH 5/6] Update source/_integrations/shelly.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/shelly.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown index 0e63855a24ea..8098b4a083eb 100644 --- a/source/_integrations/shelly.markdown +++ b/source/_integrations/shelly.markdown @@ -224,7 +224,7 @@ The Wall Display media player can play local audio files (you need to upload the These audio files and your favorite radio stations are visible in the Home Assistant media browser. -### Play media using `media_player.play_media` action +### Play media using the `media_player.play_media` action This action will start playing your favorite radio station with ID `2`: From bbcf54b4c33784711dc9b558c21482fb220c09b2 Mon Sep 17 00:00:00 2001 From: Maciej Bieniek Date: Thu, 23 Apr 2026 16:26:21 +0200 Subject: [PATCH 6/6] Update source/_integrations/shelly.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/shelly.markdown | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/source/_integrations/shelly.markdown b/source/_integrations/shelly.markdown index 8098b4a083eb..2227a85d8c50 100644 --- a/source/_integrations/shelly.markdown +++ b/source/_integrations/shelly.markdown @@ -220,7 +220,10 @@ For generation 2+ hardware, it's possible to select if a device's input is conne Wall Display devices with firmware 2.2 or newer can function as media players. The integration creates media player entities for them. -The Wall Display media player can play local audio files (you need to upload them to the Wall Display media library) and internet radio stations that you have added to your favorites in the device interface. +The Wall Display media player can play the following audio formats: + +- Local audio files uploaded to the Wall Display media library +- Internet radio stations added to your favorites These audio files and your favorite radio stations are visible in the Home Assistant media browser.