Intégration Philips Hue pour Gladys Assistant
Pilotez vos lampes Philips Hue (marche/arrêt, luminosité, couleur, température de blanc) en local.
Publiée par cicoub13
- Appareils
- Version 1.1.0
- Nécessite Gladys >=4.62.0
- ★ 0
Pilotez vos lampes Philips Hue depuis Gladys, directement sur votre réseau local (aucun compte cloud Hue nécessaire).
Ce que vous obtenez
Chaque lampe Hue est exposée comme un appareil Gladys avec les fonctionnalités qu'elle prend en charge :
| Type de lampe Hue | Marche/Arrêt | Luminosité | Couleur | Température de blanc |
|---|---|---|---|---|
| On/Off light | ✅ | |||
| Dimmable light | ✅ | ✅ | ||
| Color temperature light | ✅ | ✅ | ✅ | |
| Color light | ✅ | ✅ | ✅ | |
| Extended color light | ✅ | ✅ | ✅ | ✅ |
Les états sont rafraîchis par interrogation à l'intervalle choisi dans Intervalle de rafraîchissement (toutes les minutes par défaut).
Configuration
- Vérifiez que votre bridge Hue est allumé et connecté au même réseau local que votre serveur Gladys.
- Ouvrez l'écran Configuration de l'intégration et cliquez sur
Découvrir les bridges. L'adresse IP de votre bridge doit apparaître. Si la
découverte automatique échoue, saisissez l'IP du bridge dans le champ
Adresse IP du bridge (une adresse ou un nom d'hôte simple, par exemple
192.168.1.42— toute autre saisie est ignorée et le bouton vous le signale). - Appuyez sur le bouton rond situé sur le dessus du bridge Hue.
- Dans les 30 secondes, cliquez sur Appairer le bridge. En cas de succès, vos lampes apparaissent dans l'onglet Découverte, prêtes à être créées.
Comment le bridge est trouvé
Trois méthodes sont tentées, dans cet ordre, et la première qui trouve un bridge l'emporte :
- SSDP sur votre réseau local, effectué par Gladys pour le compte de l'intégration ;
- mDNS (
_hue._tcp), par le même mécanisme ; - le service N-UPnP de Philips (
discovery.meethue.com) en dernier recours. Celui-ci est un service cloud Philips : il nécessite un accès Internet et ne renvoie que les bridges vus depuis la même adresse IP publique. Il n'est sollicité que si les deux méthodes locales ne trouvent rien.
Remarques
- Les identifiants d'appairage (le username du bridge) sont stockés dans le
volume de données de l'intégration (
/data) et survivent aux redémarrages. L'appairage n'est fait qu'une seule fois. - Le pilotage de vos lampes est toujours 100 % local : les commandes et les lectures d'état vont directement au bridge sur votre réseau. Seule l'étape de découverte de dernier recours ci-dessus peut contacter un serveur Philips, et uniquement pendant que vous cherchez votre bridge.
- Le conteneur doit pouvoir joindre le bridge sur votre réseau local (HTTP, port 80).
Paramètres de configuration
Voici les paramètres demandés par Philips Hue dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Appairer votre bridge Hue | section | Non | Utilisez les boutons ci-dessous : d'abord « Découvrir les bridges » pour trouver votre bridge Hue sur le réseau, puis appuyez sur le bouton physique du bridge et cliquez sur « Appairer le bridge » dans les 30 secondes. Vous pouvez aussi renseigner l'IP du bridge manuellement si la découverte automatique échoue. |
| Adresse IP du bridge (optionnel) | string | Non | Nécessaire uniquement si la découverte automatique ne trouve pas votre bridge. Exemple : 192.168.1.42 |
| Intervalle de rafraîchissement | select | Non | Fréquence de rafraîchissement de l'état des lampes depuis le bridge. |
Comment installer Philips Hue dans Gladys
- Dans Gladys, ouvrez Intégrations : Philips Hue apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/cicoub13/gladys-philips-hue:1.1.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/cicoub13/gladys-philips-hue.
Philips Hue nécessite Gladys >=4.62.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Philips Hue est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par cicoub13, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation