Integración domótica Elgato Light, gratuita y de código abierto
Key Light, Ring Light y Light Strip de Elgato en la red local: brillo, blanco, color.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Controle sus luces Elgato desde Gladys, a través de su red local: Key Light, Key Light Air, Key Light Mini, Ring Light y Light Strip. Encendido y apagado, brillo, el blanco de cálido a frío, el color de un Light Strip, la batería de una Key Light Mini, y dos acciones de escena: hacer parpadear luces y ajustar varias luces de una vez para una videollamada. Sin cuenta y sin nube: Gladys habla directamente con cada luz, como lo hace la aplicación Elgato Control Center.
Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha construido y probado con respuestas reales de luces Elgato grabadas por los proyectos python-elgato y Home Assistant, y con una luz simulada, no con una luz real. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Luces Elgato ya configuradas con la aplicación Elgato Control Center, conectadas al Wi-Fi de la misma red que Gladys.
- Nada más: ni cuenta Elgato, ni clave, ni acceso a Internet. Las luces responden en el puerto TCP 9123 de su red local.
Instalación
- Instale la integración desde el catálogo de Gladys. La pantalla de
instalación pide un permiso: Gladys puede buscar el servicio
_elg._tcpen su red (mDNS), como Control Center encuentra las luces. - Abra su Configuración. Nada es obligatorio; las opciones son:
- Direcciones IP de las luces Elgato: solo para las luces que el
descubrimiento automático no encuentra, separadas por comas (por ejemplo
192.168.1.50, 192.168.1.51). Control Center muestra la dirección de cada luz en sus ajustes; su router también la lista. Se aceptan un nombre (keylight.lan) y un puerto (192.168.1.50:9123). - Intervalo de actualización: la frecuencia de lectura de cada luz, de 5 a 60 segundos (10 por defecto). Es lo que tarda Gladys en ver un cambio hecho desde Control Center, un Stream Deck o los botones de la luz.
- Idioma de los nombres de las funciones: inglés, francés, alemán o español (francés por defecto). Los nombres de las funciones se asignan al añadir el dispositivo.
- Direcciones IP de las luces Elgato: solo para las luces que el
descubrimiento automático no encuentra, separadas por comas (por ejemplo
- Abra la pestaña Descubrir: un dispositivo por luz. Haga clic en Añadir, elija una habitación y guarde.
- ¿Falta una luz? Haga clic en Buscar luces Elgato en la pantalla de configuración: el mensaje bajo el botón lista las luces encontradas y las que no responden.
Una luz que cambia de dirección se vuelve a encontrar en 15 minutos, sin un nuevo dispositivo en Gladys: se reconoce por su número de serie.
Los dispositivos de Gladys
Cada luz se convierte en un dispositivo de Gladys, con el nombre dado en Control Center, o con su producto y el final de su número de serie (por ejemplo Elgato Key Light Air 0002). Cámbiele el nombre como quiera.
| Función | Qué es | Luces |
|---|---|---|
| Luz | Encendida / apagada | Todas |
| Brillo | De 1 a 100 %; 0 apaga la luz | Todas |
| Temperatura de color | El blanco, de 2900 K (cálido) a 7000 K (frío) | Todas |
| Tono | El color, de 0 a 360° | Light Strip |
| Saturación | De 0 % (blanco) a 100 % (color intenso) | Light Strip |
| Color | El color, para la rueda de colores del panel | Light Strip |
| Batería | Nivel de carga, en % | Key Light Mini |
| Cargando | Si la batería se está cargando | Key Light Mini |
- Elegir un brillo, un blanco o un color también enciende la luz.
- Un Light Strip muestra o un blanco o un color: en modo blanco, su tono, su saturación y su color no se actualizan; en modo color, su temperatura de color no.
- Cuando una luz deja de responder, su indicador muestra que no está disponible y Gladys conserva su último estado (una luz Elgato puede perder el Wi-Fi sin apagarse).
Botones de la configuración
- Buscar luces Elgato: vuelve a buscar en la red ahora y lista las luces encontradas.
- Hacer parpadear una luz: elija una luz y parpadeará unos segundos. Útil para saber cuál es cuál antes de darles nombre.
Panel
Sin widget propio: el panel de luz del tablero de Gladys ya tiene todos los controles de una luz Elgato (encendido, barra de brillo, control de cálido a frío, rueda de colores con tono y saturación para el Light Strip). Añada el dispositivo a una caja Dispositivos de la habitación, o a cualquier caja que muestre dispositivos.
Escenas
Disparadores
Sin disparador propio: use el disparador habitual sobre el estado de un dispositivo (la luz se enciende, el brillo cambia, la batería baja del 20 %...).
Acciones
- Hacer parpadear luces Elgato: una o varias luces parpadean unos segundos y luego vuelven a su ajuste.
- Ajustar luces Elgato: enciende una o varias luces con un brillo (de 1 a 100 %) y una temperatura de color (de 2900 a 7000 K), ambos opcionales, con una sola petición por luz: la luz no muestra antes su ajuste anterior. Un Light Strip en modo color pasa al blanco cuando se indica una temperatura.
Las dos acciones pasan a las acciones siguientes el número de luces alcanzadas, y solo fallan cuando ninguna luz ha respondido.
Ideas de escenas
- Videollamada: cuando empieza el evento de calendario «Reunión» → Ajustar luces Elgato en las dos Key Light del escritorio, 40 % y 5000 K; al terminar, apáguelas.
- Timbre silencioso: cuando suena el timbre → Hacer parpadear luces Elgato del despacho, para quien lleve auriculares.
- Batería baja: cuando la Batería de la Key Light Mini baja del 15 % → enviar el mensaje «Cargue la Key Light Mini».
- Noche: al atardecer → encender el Light Strip, temperatura de color 2900 K, brillo 30 %.
Solución de problemas
- No se encuentra ninguna luz automáticamente: compruebe que las luces y Gladys están en la misma red (una red de invitados o una VLAN separada para los objetos conectados bloquea el descubrimiento). Introduzca las direcciones IP en la configuración: funciona entre redes siempre que Gladys llegue al puerto 9123. Dar a las luces una dirección fija en su router también ayuda.
- «no responde»: la luz está desenchufada, su batería está vacía o ha perdido el Wi-Fi. Control Center muestra entonces lo mismo. Vuelve sola en cuanto responde de nuevo.
- El blanco o el color en Gladys difiere un poco de Control Center: las luces trabajan en mireds y en grados de tono enteros; Gladys muestra el valor en kelvin más cercano (a 10 K) y el color más cercano.
- La integración registra lo que encuentra y lo que no responde: abra los
registros de la integración desde la interfaz de Gladys (
LOG_LEVEL=debugmuestra cada lectura).
Límites
- Los cambios hechos fuera de Gladys (Control Center, Stream Deck, botones de la luz) se ven en la lectura siguiente, dentro del intervalo de actualización: las luces no envían nada por sí mismas. Gladys lee cada luz con una pequeña petición local por intervalo (dos para una Key Light Mini, que también da su batería). La API local no tiene cuota ni condiciones de uso; ningún tráfico de Internet.
- No disponibles: el comportamiento al encender, las duraciones de fundido, el modo estudio y el ahorro de energía de la Key Light Mini, las actualizaciones de firmware (use Control Center), las escenas del Light Strip Pro.
- Un dispositivo de Gladys por luz: las luces no se agrupan.
- Desarrollada sin una luz Elgato real: lo que no se ha podido comprobar está en el README.
Esta integración no está afiliada a Elgato ni a Corsair. Elgato, Key Light, Ring Light y Light Strip son marcas de Corsair Memory, Inc.
Parámetros de configuración
Estos son los parámetros que Elgato Light te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Encontrar sus luces Elgato | section | No | Las luces Elgato de la misma red que Gladys se encuentran automáticamente: abra la pestaña Descubrir. Configúrelas primero en la aplicación Elgato Control Center. Si falta alguna, introduzca su dirección IP a continuación. |
| Direcciones IP de las luces Elgato | string | No | Opcional, separadas por comas. Solo para las luces que el descubrimiento automático no encuentra. |
| Intervalo de actualización | select | No | Frecuencia de lectura de cada luz, para seguir los cambios hechos desde la aplicación Elgato o los botones de la luz. |
| Idioma de los nombres de las funciones | select | No | Nombres que reciben las funciones de los nuevos dispositivos (Luz, Brillo, Temperatura de color...). |
Cómo instalar Elgato Light en Gladys
- En Gladys, abre Integraciones: Elgato Light 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/guim31/gladys-elgato:1.0.1), 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/guim31/gladys-elgato.
Elgato Light 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.
Sobre las integraciones externas
Elgato Light 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 guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación