Skip to main content

Philips Hue integration for Gladys Assistant

Philips Hue integration for Gladys Assistant

Control Philips Hue lights (on/off, brightness, color, white temperature) from Gladys, locally.

View on GitHubAll external integrations

Control your Philips Hue lights from Gladys, directly over your local network (no Hue cloud account required).

What you get​

Each Hue light is exposed as a Gladys device with the features it supports:

Hue light typeOn/OffBrightnessColorWhite temperature
On/Off light✅
Dimmable light✅✅
Color temperature light✅✅✅
Color light✅✅✅
Extended color light✅✅✅✅

States are refreshed by polling at the interval you choose in Refresh interval (default: every minute).

Setup​

  1. Make sure your Hue bridge is powered on and connected to the same local network as your Gladys server.
  2. Open the integration Configuration screen and click Discover bridges. The IP address of your bridge should appear. If auto-discovery fails, type the bridge IP address in the Bridge IP address field (a plain address or hostname, for example 192.168.1.42 — anything else is ignored and the button tells you so).
  3. Press the round link button on top of the Hue bridge.
  4. Within 30 seconds, click Pair bridge. On success, your lights appear in the Discovery tab, ready to be created as devices.

How the bridge is found​

Three methods are tried, in order, and the first one that finds a bridge wins:

  1. SSDP on your local network, performed by Gladys on the integration's behalf;
  2. mDNS (_hue._tcp), same mechanism;
  3. Philips' N-UPnP endpoint (discovery.meethue.com) as a last resort. This one is a Philips cloud service: it needs Internet access and only returns bridges seen from the same public IP address. It is only used when the two local methods find nothing.

Notes​

  • The pairing credentials (the bridge username) are stored in the integration data volume (/data) and survive restarts. You only pair once.
  • Controlling your lights is always 100 % local: commands and state reads go straight to the bridge over your LAN. Only the last-resort discovery step above may contact a Philips server, and only while you look for your bridge.
  • The container must be able to reach the bridge on your LAN (HTTP, port 80).

Configuration settings​

These are the settings Philips Hue asks for in its configuration screen in Gladys.

SettingTypeRequiredDescription
Pairing your Hue bridgesectionNoUse the buttons below: first "Discover bridges" to find your Hue bridge on the network, then press the physical link button on top of the bridge and click "Pair bridge" within 30 seconds. You can also fill the bridge IP manually if auto-discovery fails.
Bridge IP address (optional)stringNoOnly needed if automatic discovery does not find your bridge. Example: 192.168.1.42
Refresh intervalselectNoHow often the light states are refreshed from the bridge.

How to install Philips Hue in Gladys​

  1. In Gladys, open Integrations: Philips Hue appears in the catalog, next to the native integrations, with a community badge.
  2. Click Install. Gladys pulls the Docker image (ghcr.io/cicoub13/gladys-philips-hue:1.1.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration).
  3. Open the Configuration screen of the integration, fill in the settings, and save.
  4. You can also install it directly from its repository URL: https://github.com/cicoub13/gladys-philips-hue.

Philips Hue requires Gladys >=4.62.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.

Not running Gladys yet? It is free and open source: follow the installation guide to get started.

About external integrations​

Philips Hue is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by cicoub13, not by the Gladys core team.

Subscribe to the Gladys Assistant newsletter

A few emails per month about new releases and project news. Sent by Pierre-Gilles Leymarie, founder of the project. Unsubscribe anytime 🙂
Last updated on