Integración domótica Twinkly, gratuita y de código abierto
Control your Twinkly smart LED lights over your local network.
Publicado por prohand
- Dispositivos
- Versión 1.0.1
- 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.
This integration connects Gladys to your Twinkly smart LED lights (strings, curtains, trees, Squares, Flex, Dots…). Gladys drives them locally, on your own network: no account, no cloud.
Before you start
- Set up each Twinkly with the Twinkly app first, and connect it to your Wi-Fi.
- It must be on the same network as Gladys.
- Recommended: give it a fixed IP (DHCP reservation in your router). If its IP changes, the integration finds it again, but more slowly.
Twinkly has no public cloud API: everything goes through the local network (local transport).
Configuration
| Field | What it does |
|---|---|
| IP addresses | IP addresses of your Twinkly devices, comma-separated. Optional when the scan finds them. |
| Network scan | Looks for Twinkly devices on the network (UDP broadcast, port 5555). On by default. |
| Refresh interval | How often each Twinkly is read: 10 s, 15 s, 30 s or 1 min. |
| When turned on, play | What a Twinkly shows when Gladys turns it on (default: what it played last). |
Test the connection looks for the Twinkly devices and lists what answers: name, address, LED count, firmware version, current mode.
Identify a Twinkly plays its demo for 5 seconds, then puts it back as it was: handy to tell which one is which.
The network scan finds nothing?
The integration container does not see network broadcasts: Gladys sends the scan for it. Some networks block it (separate VLANs, Wi-Fi client isolation). Then just type the IP addresses.
Adding the devices
In Integrations → Twinkly → Discovery, run a scan and add each Twinkly. Each one becomes a light with:
| Feature | What it does |
|---|---|
| On/Off | Off (mode off) or back on (see "When turned on, play"). |
| Brightness | 0 to 100 %. Raising the brightness of a Twinkly that is off turns it on. |
| Color | Solid color (firmware 2.7.1 or later). |
| Scene | The movies uploaded from the app, the playlist and the built-in effects. |
The device keeps its identity (based on its MAC address): renaming it in the app or a new IP never creates a duplicate.
Uploaded a new movie from the app? Run a scan again so it shows up in the Scene list.
Scenes (Gladys 5.1 and later)
Triggers
| Trigger | When | Variables |
|---|---|---|
| A Twinkly changed mode | The mode changed outside Gladys: the app, its button, its own timer. | device_name, mode, previous_mode |
| A Twinkly is unreachable | It stopped answering (unplugged, Wi-Fi lost…). | device_name |
| A Twinkly answers again | It answers again. | device_name |
A change Gladys ordered never fires "changed mode": a scene cannot loop.
Changes are seen at each read: with a 30 s interval, a scene reacts within 30 s.
Actions
| Action | Parameters | Output |
|---|---|---|
| Play a Twinkly movie | Twinkly, movie name (or number: 1 = first) | movie (name played) |
| Play a Twinkly effect | Twinkly, effect number (1 = first) | effect |
| Change a Twinkly mode | Twinkly, mode: on, off, movie, effect, playlist, solid color, demo | mode (applied) |
To set color and brightness in a scene, use the standard Gladys action "Control a device".
Dashboard (Gladys 5.1 and later)
The Twinkly widget has two views, picked in its settings:
-
No Twinkly chosen: one row per device (what it plays and how bright, or "Unreachable") and two buttons: All on and All off.
-
One Twinkly chosen: its live brightness, its state, the scene playing, its color, IP address, LED count and firmware, and a set of buttons (the Buttons setting):
Buttons What they do Scenes (default) Turn on/off, previous scene, next scene, Identify Brightness Turn on/off, −10 %, +10 %, Max Modes Turn on/off and up to 3 modes: movie, playlist, solid color, effect Colors White, red, green, blue (solid color, firmware 2.7.1+) A card holds 4 buttons at most: add the widget several times to get several sets. Scenes loop in the list order (movies, playlist, effects). Brightness does not go below 10 %: to switch off, use Turn off.
Troubleshooting
- "No Twinkly found yet": check that the Twinkly answers in the app, then type its IP in IP addresses.
- A Twinkly turns "Unreachable": it is unplugged, off the Wi-Fi, or its IP changed. The integration runs a new scan (at most once every 5 minutes). A fixed IP avoids the problem.
- The Twinkly app and Gladys at the same time: that works. When the app takes over, Gladys reconnects by itself.
- The integration logs (the Gladys Supervision page) say what was found and what does not answer.
Parámetros de configuración
Estos son los parámetros que Twinkly te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Getting started | section | No | Set up your Twinkly in the Twinkly app first, on the same network as Gladys. Gladys then drives it locally, without any account or cloud: it finds it by itself (network scan), or you type its IP address below. |
| IP addresses | string | No | IP addresses of your Twinkly devices, separated by commas. Optional when the network scan finds them; give them a fixed IP (DHCP reservation) in your router. |
| Network scan | boolean | No | Look for Twinkly devices on the network (UDP broadcast on port 5555, sent by Gladys). Turn it off if your network blocks broadcasts and you typed the IP addresses. |
| Refresh interval | select | No | How often Gladys reads each Twinkly, to follow changes made from the app. |
| When turned on, play | select | No | What a Twinkly shows when Gladys turns it on. |
Cómo instalar Twinkly en Gladys
- En Gladys, abre Integraciones: Twinkly 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/prohand/gladys-twinkly: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/prohand/gladys-twinkly.
Twinkly 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
Twinkly 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 prohand, 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