{"id":18817210,"url":"https://github.com/mvdwetering/huesyncbox","last_synced_at":"2025-12-28T23:47:00.937Z","repository":{"id":37032936,"uuid":"269588712","full_name":"mvdwetering/huesyncbox","owner":"mvdwetering","description":"Custom integration for Home Assistant to control the Philips Hue Play HDMI Sync Box 4K or 8K","archived":false,"fork":false,"pushed_at":"2025-02-05T20:00:45.000Z","size":394,"stargazers_count":125,"open_issues_count":3,"forks_count":13,"subscribers_count":6,"default_branch":"dev","last_synced_at":"2025-04-13T22:56:53.560Z","etag":null,"topics":["hacs","homeassistant-integration","hue-entertainment","huesync","philips-hue"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mvdwetering.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-06-05T09:37:40.000Z","updated_at":"2025-04-07T23:16:24.000Z","dependencies_parsed_at":"2024-04-23T13:58:29.033Z","dependency_job_id":"4e92936d-e1fd-4154-b15c-02c95ed77283","html_url":"https://github.com/mvdwetering/huesyncbox","commit_stats":null,"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvdwetering%2Fhuesyncbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvdwetering%2Fhuesyncbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvdwetering%2Fhuesyncbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mvdwetering%2Fhuesyncbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mvdwetering","download_url":"https://codeload.github.com/mvdwetering/huesyncbox/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248794571,"owners_count":21162614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacs","homeassistant-integration","hue-entertainment","huesync","philips-hue"],"created_at":"2024-11-08T00:09:50.587Z","updated_at":"2025-12-28T23:47:00.932Z","avatar_url":"https://github.com/mvdwetering.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Philips Hue Play HDMI Sync Box\n\nMinimum required Home Assistant version is: 2025.12.0\n\n[![Contributors](https://img.shields.io/github/contributors/mvdwetering/huesyncbox.svg)](https://github.com/mvdwetering/huesyncbox/graphs/contributors)\n\n- [About](#about)\n- [Supported devices](#supported-devices)\n- [Possible use-cases](#possible-use-cases)\n- [Entities](#entities)\n  - [Behavior](#behavior)\n- [Data updates](#data-updates)\n- [Actions](#actions)\n  - [Set bridge](#set-bridge)\n  - [Set sync state](#set-sync-state)\n- [Installation](#installation)\n- [Removal](#removal)\n- [Updating from before version 2.0](#updating-from-before-version-20)\n\n## About\n\n\u003e 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.\n\nThis 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.\n\n## Supported devices\n\nBoth the 4K and 8K models are supported.\n\n## Possible use-cases\n\n- Start light syncing in specific cases (e.g., when a specific app is running, or only after dark)\n- Turn the box on and control the selected input based on which devices are on (useful if the automatic switching can not be used)\n- Automate actions when light syncing starts (e.g., dim other lights, close blinds)\n\n## Entities\n\nEntities are created for the following features:\n\n- Power on/off\n- Light sync on/off\n- Intensity selection (subtle/moderate/high/intense)\n- Sync mode selection (video/music/game)\n- HDMI Input selection\n- Brightness control slider\n- Entertainment area selection\n- HDMI input connection status\n- Dolby Vision compatibility on/off (only on 4K)\n- LED indicator mode selection\n- Bridge connection status ⁺\n- Bridge ID sensor ⁺\n- IP address sensor ⁺\n- Wifi quality sensor ⁺\n- Content info sensor ⁺\n\nEntities marked with ⁺ are disabled by default.\n\n### Behavior\n\nA 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.\n\n- Enabling light sync will also power on the box\n- Setting sync mode will also power on the box and start light sync on the selected mode\n- 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](#set-sync-state) which will take care of the ordering and is more efficient than sending everything separately.\n\n## Data updates\n\nThis integration polls the Philips Hue Play HDMI Sync Box every 3 seconds.\n\n## Actions\n\nThe integration exposes two additional actions.\n\n### Set bridge\n\nThis 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.\n\nNote 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`.\n\n| Parameter | Description | Example |\n| --- | --- | --- |\n| device_id | Home Assistant device ID of the Philips Hue Play HDMI Sync Box. | 11223344556677889900aabbccddeeff |\n| bridge_id | ID of the bridge. A hexadecimal code of 16 characters. | 001788FFFE000000 |\n| bridge_username | Username (a.k.a. application key) valid for the bridge. A long code of random characters. | abcdefghijklmnopqrstuvwxyz1234567890ABCD |\n| bridge_clientkey | Client key that belongs with the username. A hexadecimal code of 32 characters. | 00112233445566778899AABBCCDDEEFF |\n\nYAML action call example:\n\n```yaml\naction: huesyncbox.set_bridge\ndata:\n  device_id: 11223344556677889900aabbccddeeff\n  bridge_id: 001788FFFE000000\n  bridge_username: abcdefghijklmnopqrstuvwxyz1234567890ABCD\n  bridge_clientkey: 00112233445566778899AABBCCDDEEFF\n```\n\n### Set sync state\n\nSet 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.\n\n| Parameter | Description | Example |\n| --- | --- | --- |\n| `device_id` | Home Assistant device ID of the Philips Hue Play HDMI Sync Box. | 11223344556677889900aabbccddeeff |\n| `power` | Turn the box on or off. | true |\n| `sync` | Set light sync state on or off. Setting this to on will also turn on the box. | true |\n| `brightness` | Brightness value to set. | 42 |\n| `intensity` | Intensity to set. | high |\n| `mode` | Mode to set. Setting the mode will also turn on the box and start light sync. | video |\n| `input` | Input to select. | input1 |\n| `entertainment_area` | Entertainment area to select. Name must match _exactly_. | TV Area |\n\nYAML action call example:\n\n```yaml\naction: huesyncbox.set_sync_state\ndata:\n  device_id: 11223344556677889900aabbccddeeff\n  power: true\n  sync: true\n  brightness: 42\n  intensity: high\n  mode: video\n  input: input1\n  entertainment_area: \"TV Area\"\n```\n\n## Installation\n\n\u003e **Note**\n\u003e 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.\n\n\n### Downloading\n\n#### Home Assistant Community Store (HACS)\n\n\u003e HACS is a third-party downloader for Home Assistant to easily install and update custom integrations made by the community. See \u003chttps://hacs.xyz/\u003e for more details.\n\nYou can add this repository to HACS on your Home Assistant instance with the button below.\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=mvdwetering\u0026repository=huesyncbox\u0026category=integration)\n\nIf the button does not work, or you don't want to use it, follow these steps to add the integration to HACS manually.\n\n\u003cdetails\u003e\n\u003csummary\u003eManual HACS configuration steps\u003c/summary\u003e\n\n- Go to your Home Assistant instance\n- Open the HACS page\n- Search for \"Philips Hue HDMI Sync Box\" in the HACS search bar\n- Click/tap on the integration to open the integration page\n- Press the Download button to download the integration\n- **Restart Home Assistant**\n\n\u003c/details\u003e\n\n#### Manual download\n\n- Go to the [releases section on GitHub](https://github.com/mvdwetering/huesyncbox/releases)\n- Download the zip file for the version you want to install\n- Extract the zip\n- Ensure the `config/custom_components/huesyncbox` directory exists (create it if needed)\n- Copy the files from the zip into the `config/custom_components/huesyncbox` directory\n- **Restart Home Assistant**\n\n### Configuration\n\nThe Philips Hue Play HDMI Sync Box will be discovered automatically in most cases. If not, add it manually via `Settings \u003e Devices and Services` in Home Assistant.\n\nFor manual configuration, provide the following parameters (found in the Hue app's sync box device settings):\n\n**IP Address**\n: IP address of the device e.g. 192.168.1.123.\n\n**Identifier**\n: The device identifier of the box e.g. C42996000000\n\n## Removal\n\nThis integration follows standard integration removal. No extra steps are required.\n\nGo to \"Settings \u003e Devices \u0026 Services\". Select Philips Hue Play HDMI Sync Box. Click the three dots ⋮ menu and then select Delete.\n\n## Updating from before version 2.0\n\nVersion 2.0 is a complete rewrite, enabling multiple entities and modernizing the integration. It is a breaking change, but no functionality is lost—features have just moved.\n\nSee the [release notes for 2.0.0](https://github.com/mvdwetering/huesyncbox/releases/tag/v2.0.0) for migration details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvdwetering%2Fhuesyncbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmvdwetering%2Fhuesyncbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvdwetering%2Fhuesyncbox/lists"}