Minimum required Home Assistant version is: 2025.12.0

• About
• Supported devices
• Possible use-cases
• Entities
  • Behavior
• Data updates
• Actions
  • Set bridge
  • Set sync state
• Installation
• Removal

Please set up the Philips Hue Play HDMI Sync Box with the Hue App first and make sure it works before setting up this integration.

This integration allows you to control and automate your Philips Hue Play HDMI Sync Box from Home Assistant. Use it in automations, dashboards, and scripts to improve your entertainment experience.

Both the 4K and 8K models are supported.

• Start light syncing in specific cases (e.g., when a specific app is running, or only after dark)
• Turn the box on and control the selected input based on which devices are on (useful if the automatic switching can not be used)
• Automate actions when light syncing starts (e.g., dim other lights, close blinds)

Entities are created for the following features:

• Power on/off
• Light sync on/off
• Intensity selection (subtle/moderate/high/intense)
• Sync mode selection (video/music/game)
• HDMI Input selection
• Brightness control slider
• Entertainment area selection
• HDMI input connection status
• Dolby Vision compatibility on/off (only on 4K)
• LED indicator mode selection
• Bridge connection status ⁺
• Bridge ID sensor ⁺
• IP address sensor ⁺
• Wifi quality sensor ⁺
• Content info sensor ⁺

Entities marked with ⁺ are disabled by default.

A few notes on behavior when changing entities. This behavior is just how the box reacts when sending these commands, not something explicitly coded in this integration.

• Enabling light sync will also power on the box
• Setting sync mode will also power on the box and start light sync on the selected mode
• When changing multiple entities the order is important. For example, Intensity applies to the current selected mode. So if you want to change both the intensity and mode you first have to change the mode and then set the intensity. Otherwise, the intensity is applied to the "old" mode. To avoid ordering issues use the set_sync_state action which will take care of the ordering and is more efficient than sending everything separately.

This integration polls the Philips Hue Play HDMI Sync Box every 3 seconds.

The integration exposes two additional actions.

This action allows setting the bridge to be used by the Philips Hue Play HDMI Sync Box. For example when you have 2 different bridges you want to sync to and need to switch.

Note that changing the bridge by the box takes a while (about 15 seconds it seems). After the bridge has changed you might need to (re)select the entertainment_area if connectionstate is invalidgroup instead of connected.

YAML action call example:

action: huesyncbox.set_bridge
data:
  device_id: 11223344556677889900aabbccddeeff
  bridge_id: 001788FFFE000000
  bridge_username: abcdefghijklmnopqrstuvwxyz1234567890ABCD
  bridge_clientkey: 00112233445566778899AABBCCDDEEFF

Set the state of multiple entities of the Philips Hue Play HDMI Sync Box at once. Using this action makes sure everything is set in the correct order and is more efficient than using separate commands.

YAML action call example:

action: huesyncbox.set_sync_state
data:
  device_id: 11223344556677889900aabbccddeeff
  power: true
  sync: true
  brightness: 42
  intensity: high
  mode: video
  input: input1
  entertainment_area: "TV Area"

Please set up the Philips Hue Play HDMI Sync Box with the Hue App first and make sure it works before setting up this integration.

HACS is a third-party downloader for Home Assistant to easily install and update custom integrations made by the community. See https://hacs.xyz/ for more details.

You can add this repository to HACS on your Home Assistant instance with the button below.

If the button does not work, or you don't want to use it, follow these steps to add the integration to HACS manually.

• Go to the releases section on GitHub
• Download the zip file for the version you want to install
• Extract the zip
• Ensure the config/custom_components/huesyncbox directory exists (create it if needed)
• Copy the files from the zip into the config/custom_components/huesyncbox directory
• Restart Home Assistant

The Philips Hue Play HDMI Sync Box will be discovered automatically in most cases. If not, add it manually via Settings > Devices and Services in Home Assistant.

For manual configuration, provide the following parameters (found in the Hue app's sync box device settings):

IP Address : IP address of the device e.g. 192.168.1.123.

Identifier : The device identifier of the box e.g. C42996000000

This integration follows standard integration removal. No extra steps are required.

Go to "Settings > Devices & Services". Select Philips Hue Play HDMI Sync Box. Click the three dots ⋮ menu and then select Delete.