Integración domótica Philips Hue, gratuita y de código abierto
Control Philips Hue lights (on/off, brightness, color, white temperature) from Gladys, locally.
Publicado por cicoub13
- Dispositivos
- Versión 2.0.0
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
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 type | On/Off | Brightness | Color | White 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).
Hue scenes in Gladys scenes
Requires Gladys 5.1 or later.
The Activate a Hue scene action of the Gladys scene editor recalls a scene created in the Hue app: all its lights take their color and brightness at once, with the bridge's transition.
- Scene: the name shown in the Hue app, for example
Relax. Case and surrounding spaces are ignored. - Room or zone (optional): only needed when several rooms have a scene with
that name, for example
Living room.
When the name matches no scene, or several, the action fails and the scene logs list the scenes (or the rooms) available. The rest of the Gladys scene keeps running.
Setup
- Make sure your Hue bridge is powered on and connected to the same local network as your Gladys server.
- 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). - Press the round link button on top of the Hue bridge.
- 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:
- SSDP on your local network, performed by Gladys on the integration's behalf;
- mDNS (
_hue._tcp), same mechanism; - 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.
Whichever method finds it, every device is verified before being offered to
you: the integration asks it for its Hue identity card (/api/config). Devices
that do not answer like a Philips Hue bridge — a printer, a NAS, a speaker — are
discarded, and the message tells you how many were.
Troubleshooting
"No Hue bridge found" while the bridge is powered on: check that it sits on the same network as Gladys (a guest network or a separate VLAN makes it invisible). If the message says other devices answered but none is a Hue bridge, discovery did see your network but not the bridge: type its address in Bridge IP address. You will find it in the Hue app, under Settings → My devices → Bridge.
"The link button was not pressed": the bridge was found, only the pairing is missing. Press the round button on top of the bridge, then click Pair bridge again within the next 30 seconds.
Lights stopped responding: check that the bridge did not change IP address (reserve it in your router), then run a discovery again.
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 on port 80, or HTTPS if your bridge no longer accepts plain HTTP).
- HTTPS security: a Hue bridge serves a certificate issued by Philips rather than by a public authority. On first contact the integration checks that this certificate carries the bridge's own identifier, then remembers its fingerprint. On later connections any different fingerprint is refused, so a device impersonating your bridge is blocked.
Parámetros de configuración
Estos son los parámetros que Philips Hue te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Pairing your Hue bridge | section | No | Use 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) | string | No | Only needed if automatic discovery does not find your bridge. Example: 192.168.1.42 |
| Refresh interval | select | No | How often the light states are refreshed from the bridge. |
Cómo instalar Philips Hue en Gladys
- En Gladys, abre Integraciones: Philips Hue aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/cicoub13/gladys-philips-hue:2.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/cicoub13/gladys-philips-hue.
Philips Hue requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Guías relacionadas
- Philips Hue sin el puente: vincula tus bombillas Hue directamente a un dongle Zigbee.
Sobre las integraciones externas
Philips Hue es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene cicoub13, no el equipo principal de Gladys.
- Explorar todas las integraciones externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación