Skip to content

Hue Sync Box

Controls a Hue Play HDMI Sync Box. It is an HDMI switch that drives lights from the picture, so in an activity it behaves like a receiver: it switches inputs as well as controlling the sync effect.

Network, over HTTPS (a self-signed certificate is accepted) using a bearer token. Pairing is by button hold: hold the button on the Sync Box, which yields a token, stored as a managed secret. State is read by polling.

  • Host — the Sync Box’s address.
  • Pairing — run pair_begin, then hold the button on the Sync Box to obtain the token.
CommandWhat it does
pair_beginStart pairing (hold the button on the Sync Box)
power_on / power_off / power_toggleStart, stop, or toggle syncing
standbyPut the box into standby
set_input / input_hdmi1input_hdmi4Select an HDMI input
set_modeSet the sync mode (e.g. video)
set_intensitySet the sync intensity
set_brightnessSet the light brightness

It implements input-source discovery, exposing its HDMI inputs, and acts as an input switcher within an activity.