From 818305d088e2b3fa3928c23f6f42dcc30e5ccc56 Mon Sep 17 00:00:00 2001 From: MattMorgan <48740594+spycle@users.noreply.github.com> Date: Mon, 7 Jul 2025 21:19:00 +0000 Subject: [PATCH 1/4] Add documentation for TuneBlade Remote integration --- .../_integrations/tuneblade_remote.markdown | 66 +++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 source/_integrations/tuneblade_remote.markdown diff --git a/source/_integrations/tuneblade_remote.markdown b/source/_integrations/tuneblade_remote.markdown new file mode 100644 index 000000000000..fefd9455e940 --- /dev/null +++ b/source/_integrations/tuneblade_remote.markdown @@ -0,0 +1,66 @@ +--- +title: TuneBlade Remote +description: Integrate TuneBlade AirPlay-connected devices with Home Assistant. +ha_category: + - Media player +ha_iot_class: Local Pull +ha_release: 2025.08.1 +ha_domain: tuneblade_remote +ha_codeowners: + - '@spycle' +ha_config_flow: true +ha_zeroconf: true +ha_platforms: + - media_player +ha_integration_type: integration +--- + +The **TuneBlade Remote** integration allows Home Assistant to control [TuneBlade](http://www.tuneblade.com/) — a Windows application that streams system audio to AirPlay receivers. + +Each AirPlay device connected to TuneBlade is exposed in Home Assistant as a [Media Player](/integrations/media_player/) entity. You can toggle power (connect/disconnect) and control volume for each. + +If the TuneBlade master control options are enabled, a separate "master" control is also available as an additional entity. + +{% include integrations/config_flow.md %} + +## Requirements + +Before using this integration, ensure the following settings are enabled in the TuneBlade application: + +- ✅ **Enable Remote Control** +- ✅ **Show master control options** *(optional, but recommended)* + +These can be found in TuneBlade’s preferences window. + +## Entities + +### Media Player + +For each AirPlay device connected to TuneBlade, a `media_player` entity is created. + +- **Features**: + - Toggle connection (on/off) + - Volume control +- **Master Media Player** (optional): + - Exposed when `Show master control options` is enabled in TuneBlade. + +## Troubleshooting + +### TuneBlade is not automatically discovered + +- Restart TuneBlade — its Bonjour broadcast may stop after extended uptime. +- Ensure **Enable Remote Control** is checked in TuneBlade settings. + +### Master volume is not displayed + +- Ensure **Show master control options** is checked in TuneBlade settings. + +## Debugging + +To enable debug logging for this integration, add the following to your `configuration.yaml`: + +```yaml +logger: + logs: + pytuneblade: debug + homeassistant.components.tuneblade_remote: debug From de5e99051178aaf0c404b603efc281709184bf49 Mon Sep 17 00:00:00 2001 From: MattMorgan <48740594+spycle@users.noreply.github.com> Date: Mon, 7 Jul 2025 22:29:26 +0100 Subject: [PATCH 2/4] Fix ha_iot_class --- source/_integrations/tuneblade_remote.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/tuneblade_remote.markdown b/source/_integrations/tuneblade_remote.markdown index fefd9455e940..94926fd25b0d 100644 --- a/source/_integrations/tuneblade_remote.markdown +++ b/source/_integrations/tuneblade_remote.markdown @@ -3,7 +3,7 @@ title: TuneBlade Remote description: Integrate TuneBlade AirPlay-connected devices with Home Assistant. ha_category: - Media player -ha_iot_class: Local Pull +ha_iot_class: Local Polling ha_release: 2025.08.1 ha_domain: tuneblade_remote ha_codeowners: From c0d20c214ab86855f7b20071bd7b520598f7e745 Mon Sep 17 00:00:00 2001 From: MattMorgan <48740594+spycle@users.noreply.github.com> Date: Wed, 9 Jul 2025 22:04:17 +0100 Subject: [PATCH 3/4] coderabbitai nitpicks --- source/_integrations/tuneblade_remote.markdown | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/_integrations/tuneblade_remote.markdown b/source/_integrations/tuneblade_remote.markdown index 94926fd25b0d..c487d9712517 100644 --- a/source/_integrations/tuneblade_remote.markdown +++ b/source/_integrations/tuneblade_remote.markdown @@ -21,6 +21,7 @@ Each AirPlay device connected to TuneBlade is exposed in Home Assistant as a [Me If the TuneBlade master control options are enabled, a separate "master" control is also available as an additional entity. + {% include integrations/config_flow.md %} ## Requirements @@ -41,8 +42,8 @@ For each AirPlay device connected to TuneBlade, a `media_player` entity is creat - **Features**: - Toggle connection (on/off) - Volume control -- **Master Media Player** (optional): - - Exposed when `Show master control options` is enabled in TuneBlade. + - **Master Media Player** (optional): + - Exposed when `Show master control options` is enabled in TuneBlade. ## Troubleshooting From 0c38866b8baec4a3efa57d01cad5526fe332777a Mon Sep 17 00:00:00 2001 From: MattMorgan <48740594+spycle@users.noreply.github.com> Date: Wed, 9 Jul 2025 22:09:06 +0100 Subject: [PATCH 4/4] Undo coderabbitai update --- source/_integrations/tuneblade_remote.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/tuneblade_remote.markdown b/source/_integrations/tuneblade_remote.markdown index c487d9712517..3fd1c193dd3c 100644 --- a/source/_integrations/tuneblade_remote.markdown +++ b/source/_integrations/tuneblade_remote.markdown @@ -21,7 +21,6 @@ Each AirPlay device connected to TuneBlade is exposed in Home Assistant as a [Me If the TuneBlade master control options are enabled, a separate "master" control is also available as an additional entity. - {% include integrations/config_flow.md %} ## Requirements