Skip to content

Philips Hue

Controls a Philips Hue bridge, exposing its lights, rooms, and scenes. It acts as a bridge device, with each Hue resource surfaced as its own controllable device.

Network, over the Hue v2 HTTPS API. Pairing is by button press: press the link button on the bridge, which yields an application key (appKey), stored as a managed secret. Bridges are discovered over _hue._tcp.

  • Host — the bridge’s address (or discover it automatically).
  • Pairing — run pair_begin, then press the link button on the bridge to obtain the appKey.
CommandWhat it does
pair_beginStart pairing (press the bridge’s link button)
power_on / power_off / power_toggleTurn a light on or off
set_brightness / brightness_up / brightness_downSet or step a light’s brightness
set_temperatureSet colour temperature in kelvin
set_colorSet colour (CIE xy)
activateActivate a scene

Commands are generated dynamically per resource type — lights, grouped lights (rooms), and scenes each expose the relevant actions.