Aller au contenu principal

Intégration domotique Elgato Light, gratuite et open source

Intégration Elgato Light pour Gladys Assistant

Key Light, Ring Light et Light Strip d'Elgato en réseau local : luminosité, blanc, couleur.

Voir sur GitHubToutes les intégrations

Pilotez vos lampes Elgato depuis Gladys, en réseau local : Key Light, Key Light Air, Key Light Mini, Ring Light et Light Strip. Allumage et extinction, luminosité, le blanc du chaud au froid, la couleur d'un Light Strip, la batterie d'une Key Light Mini, et deux actions de scène : faire clignoter des lampes, et régler plusieurs lampes d'un coup pour une visio. Ni compte ni cloud : Gladys parle directement à chaque lampe, comme le fait l'application Elgato Control Center.

Développée sans le matériel : vos retours sont les bienvenus. Cette intégration a été construite et testée sur de vraies réponses de lampes Elgato enregistrées par les projets python-elgato et Home Assistant, et sur une lampe simulée, pas sur une vraie lampe. Si quelque chose ne marche pas comme décrit, dites-le sur le forum Gladys ou dans les issues.

Ce qu'il faut​

  • Gladys Assistant 5.1.0 ou plus récent.
  • Des lampes Elgato déjà configurées avec l'application Elgato Control Center, connectées au Wi-Fi du même réseau que Gladys.
  • Rien d'autre : ni compte Elgato, ni clé, ni accès à Internet. Les lampes répondent sur le port TCP 9123 de votre réseau local.

Installation​

  1. Installez l'intégration depuis le catalogue de Gladys. L'écran d'installation demande une autorisation : Gladys peut chercher le service _elg._tcp sur votre réseau (mDNS), comme Control Center trouve les lampes.
  2. Ouvrez sa Configuration. Rien n'est obligatoire ; les options sont :
    • Adresses IP des lampes Elgato : seulement pour les lampes que la découverte automatique ne trouve pas, séparées par des virgules (par exemple 192.168.1.50, 192.168.1.51). Control Center affiche l'adresse de chaque lampe dans ses réglages ; votre box la liste aussi. Un nom (keylight.lan) et un port (192.168.1.50:9123) sont acceptés.
    • Intervalle d'actualisation : la fréquence de lecture de chaque lampe, de 5 à 60 secondes (10 par défaut). C'est le délai avant que Gladys voie un changement fait depuis Control Center, un Stream Deck ou les boutons de la lampe.
    • Langue des noms des fonctionnalités : anglais, français, allemand ou espagnol (français par défaut). Les noms des fonctionnalités sont donnés à l'ajout de l'appareil.
  3. Ouvrez l'onglet Découverte : un appareil par lampe. Cliquez sur Ajouter, choisissez une pièce, enregistrez.
  4. Une lampe manque ? Cliquez sur Rechercher les lampes Elgato dans l'écran de configuration : le message sous le bouton liste les lampes trouvées et celles qui ne répondent pas.

Une lampe qui change d'adresse est retrouvée dans les 15 minutes, sans nouvel appareil dans Gladys : elle est reconnue à son numéro de série.

Les appareils Gladys​

Chaque lampe devient un appareil Gladys, nommé d'après le nom donné dans Control Center, ou d'après son produit et la fin de son numéro de série (par exemple Elgato Key Light Air 0002). Renommez-le à votre guise.

FonctionnalitéCe que c'estLampes
ÉclairageAllumée / éteinteToutes
LuminositéDe 1 à 100 % ; 0 éteint la lampeToutes
Température de couleurLe blanc, de 2900 K (chaud) à 7000 K (froid)Toutes
TeinteLa couleur, de 0 à 360°Light Strip
SaturationDe 0 % (blanc) à 100 % (couleur vive)Light Strip
CouleurLa couleur, pour la roue chromatique du tableau de bordLight Strip
BatterieNiveau de charge, en %Key Light Mini
En chargeSi la batterie est en chargeKey Light Mini
  • Choisir une luminosité, un blanc ou une couleur allume aussi la lampe.
  • Un Light Strip affiche soit un blanc, soit une couleur : en mode blanc, sa teinte, sa saturation et sa couleur ne sont pas mises à jour ; en mode couleur, sa température de couleur ne l'est pas.
  • Quand une lampe ne répond plus, son badge indique qu'elle est injoignable et Gladys garde son dernier état (une lampe Elgato peut perdre le Wi-Fi tout en restant allumée).

Boutons de la configuration​

  • Rechercher les lampes Elgato : cherche de nouveau sur le réseau, maintenant, et liste les lampes trouvées.
  • Faire clignoter une lampe : choisissez une lampe, elle clignote quelques secondes. Pratique pour savoir laquelle est laquelle avant de les nommer.

Tableau de bord​

Pas de widget dédié : le panneau lumière du tableau de bord de Gladys a déjà toutes les commandes d'une lampe Elgato (allumage, barre de luminosité, curseur du chaud au froid, roue chromatique avec teinte et saturation pour le Light Strip). Ajoutez l'appareil à une boîte Appareils de la pièce, ou à toute boîte qui affiche des appareils.

Scènes​

Déclencheurs​

Pas de déclencheur propre : utilisez le déclencheur habituel sur l'état d'un appareil (la lampe s'allume, la luminosité change, la batterie passe sous 20 %...).

Actions​

  • Faire clignoter des lampes Elgato : une ou plusieurs lampes clignotent quelques secondes, puis reprennent leur réglage.
  • Régler des lampes Elgato : allume une ou plusieurs lampes avec une luminosité (de 1 à 100 %) et une température de couleur (de 2900 à 7000 K), toutes deux facultatives, en une seule requête par lampe : la lampe ne montre pas d'abord son réglage précédent. Un Light Strip en mode couleur passe au blanc quand une température est donnée.

Les deux actions donnent aux actions suivantes le nombre de lampes atteintes, et n'échouent que si aucune lampe n'a répondu.

Idées de scènes​

  • Visio : quand l'événement d'agenda « Réunion » commence → Régler des lampes Elgato sur les deux Key Light du bureau, 40 % et 5000 K ; à la fin, éteignez-les.
  • Sonnette silencieuse : quand on sonne → Faire clignoter des lampes Elgato du bureau, pour qui porte un casque.
  • Batterie faible : quand la Batterie de la Key Light Mini passe sous 15 % → envoyer le message « Recharge la Key Light Mini ».
  • Soirée : au coucher du soleil → allumer le Light Strip, température de couleur 2900 K, luminosité 30 %.

Dépannage​

  • Aucune lampe trouvée automatiquement : vérifiez que les lampes et Gladys sont sur le même réseau (un réseau invité ou un VLAN séparé pour les objets connectés bloque la découverte). Saisissez les adresses IP dans la configuration : cela marche d'un réseau à l'autre tant que Gladys atteint le port 9123. Donner une adresse fixe aux lampes dans votre box aide aussi.
  • « ne répond pas » : la lampe est débranchée, sa batterie est vide, ou elle a perdu le Wi-Fi. Control Center montre alors la même chose. Elle revient d'elle-même dès qu'elle répond de nouveau.
  • Le blanc ou la couleur dans Gladys diffère un peu de Control Center : les lampes travaillent en mireds et en degrés de teinte entiers ; Gladys affiche la valeur en kelvins la plus proche (à 10 K près) et la couleur la plus proche.
  • L'intégration journalise ce qu'elle trouve et ce qui ne répond pas : ouvrez les logs de l'intégration depuis l'interface de Gladys (LOG_LEVEL=debug montre chaque lecture).

Limites​

  • Les changements faits hors de Gladys (Control Center, Stream Deck, boutons de la lampe) sont vus à la lecture suivante, dans l'intervalle d'actualisation : les lampes n'envoient rien d'elles-mêmes. Gladys lit chaque lampe par une petite requête locale par intervalle (deux pour une Key Light Mini, qui donne aussi sa batterie). L'API locale n'a ni quota ni conditions d'utilisation ; aucun trafic Internet.
  • Non proposés : le comportement à l'allumage, les durées de fondu, le mode studio et l'économie d'énergie de la Key Light Mini, les mises à jour du firmware (utilisez Control Center), les scènes du Light Strip Pro.
  • Un appareil Gladys par lampe : les lampes ne sont pas regroupées.
  • Développée sans vraie lampe Elgato : ce qui n'a pas pu être vérifié est listé dans le README.

Cette intégration n'est pas affiliée à Elgato ni à Corsair. Elgato, Key Light, Ring Light et Light Strip sont des marques de Corsair Memory, Inc.

Paramètres de configuration​

Voici les paramètres demandés par Elgato Light dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Trouver vos lampes ElgatosectionNonLes lampes Elgato du même réseau que Gladys sont trouvées automatiquement : ouvrez l'onglet Découverte. Configurez-les d'abord dans l'application Elgato Control Center. S'il en manque une, saisissez son adresse IP ci-dessous.
Adresses IP des lampes ElgatostringNonFacultatif, séparées par des virgules. Seulement pour les lampes que la découverte automatique ne trouve pas.
Intervalle d'actualisationselectNonFréquence de lecture de chaque lampe, pour suivre les changements faits depuis l'application Elgato ou les boutons de la lampe.
Langue des noms des fonctionnalitésselectNonNoms donnés aux fonctionnalités des nouveaux appareils (Éclairage, Luminosité, Température de couleur...).

Comment installer Elgato Light dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Elgato Light apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-elgato:1.0.1), 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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-elgato.

Elgato Light nécessite Gladys >=5.1.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​

Elgato Light 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 guim31, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le