Intégration domotique Twinkly, gratuite et open source
Pilotez vos guirlandes et lumières LED Twinkly sur votre réseau local.
Publiée par prohand
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration relie Gladys à vos lumières LED Twinkly (guirlandes, rideaux, sapins, Squares, Flex, Dots…). Gladys les pilote en local, sur votre propre réseau : pas de compte, pas de cloud.
Avant de commencer
- Installez d'abord chaque Twinkly avec l'application Twinkly et connectez-le à votre Wi-Fi.
- Il doit être sur le même réseau que Gladys.
- Conseillé : donnez-lui une IP fixe (réservation DHCP dans votre box). Si son IP change, l'intégration le retrouve, mais plus lentement.
Twinkly n'a pas d'API cloud publique : tout passe par le réseau local (transport local).
Configuration
| Champ | Rôle |
|---|---|
| Adresses IP | IP de vos Twinkly, séparées par des virgules. Facultatif si la recherche réseau les trouve. |
| Recherche réseau | Cherche les Twinkly sur le réseau (diffusion UDP, port 5555). Activée par défaut. |
| Intervalle de rafraîchissement | Fréquence de lecture de chaque Twinkly : 10 s, 15 s, 30 s ou 1 min. |
| À l'allumage, jouer | Ce qu'affiche un Twinkly quand Gladys l'allume (par défaut : ce qu'il jouait en dernier). |
Le bouton Tester la connexion cherche les Twinkly et liste ce qui répond : nom, adresse, nombre de LED, version du firmware, mode en cours.
Le bouton Identifier un Twinkly lance sa démo pendant 5 secondes, puis le remet comme il était : pratique pour savoir qui est qui.
La recherche réseau ne trouve rien ?
Le conteneur de l'intégration ne voit pas la diffusion réseau : c'est Gladys qui l'émet pour elle. Certains réseaux la bloquent (VLAN séparés, isolation Wi-Fi des clients). Dans ce cas, saisissez simplement les adresses IP.
Ajouter les appareils
Dans Intégrations → Twinkly → Découverte, lancez une recherche puis ajoutez chaque Twinkly. Chacun devient une lumière avec :
| Fonction | Ce qu'elle fait |
|---|---|
| On/Off | Éteint (mode off) ou rallume (selon « À l'allumage, jouer »). |
| Luminosité | 0 à 100 %. Monter la luminosité d'un Twinkly éteint l'allume. |
| Couleur | Couleur fixe (firmware 2.7.1 ou plus récent). |
| Scène | Liste des animations chargées depuis l'application, de la playlist et des effets. |
L'appareil garde son identité (basée sur l'adresse MAC) : changer son nom dans l'application ou son IP ne crée pas de doublon.
Une nouvelle animation chargée depuis l'application ? Relancez une recherche pour qu'elle apparaisse dans la liste Scène.
Scènes (Gladys 5.1 et plus)
Déclencheurs
| Déclencheur | Quand | Variables |
|---|---|---|
| Un Twinkly a changé de mode | Le mode a changé hors de Gladys : application, bouton, minuterie du Twinkly. | device_name, mode, previous_mode |
| Un Twinkly est injoignable | Il ne répond plus (débranché, Wi-Fi perdu…). | device_name |
| Un Twinkly répond à nouveau | Il répond de nouveau. | device_name |
Un changement demandé par Gladys ne déclenche jamais « a changé de mode » : une scène ne peut pas tourner en boucle.
Les changements sont vus à chaque lecture : avec un intervalle de 30 s, une scène réagit en 30 s au plus.
Actions
| Action | Paramètres | Résultat |
|---|---|---|
| Jouer une animation Twinkly | Twinkly, nom de l'animation (ou numéro : 1 = première) | movie (nom joué) |
| Jouer un effet Twinkly | Twinkly, numéro de l'effet (1 = premier) | effect |
| Changer le mode d'un Twinkly | Twinkly, mode : allumé, éteint, animation, effet, playlist, couleur fixe, démo | mode (appliqué) |
Pour régler couleur et luminosité dans une scène, utilisez l'action standard de Gladys « Contrôler un appareil ».
Tableau de bord (Gladys 5.1 et plus)
Le widget Twinkly a deux vues, au choix dans ses réglages :
-
Sans Twinkly choisi : une ligne par appareil (ce qu'il joue et sa luminosité, ou « Injoignable ») et deux boutons : Tout allumer et Tout éteindre.
-
Avec un Twinkly choisi : sa luminosité en direct, son état, la scène en cours, sa couleur, son adresse IP, son nombre de LED, son firmware, et un jeu de boutons (réglage Boutons) :
Boutons Contenu Scènes (défaut) Allumer/Éteindre, scène précédente, scène suivante, Identifier Luminosité Allumer/Éteindre, −10 %, +10 %, Max Modes Allumer/Éteindre et jusqu'à 3 modes : animation, playlist, couleur fixe, effet Couleurs Blanc, rouge, vert, bleu (couleur fixe, firmware 2.7.1+) Une carte tient 4 boutons au plus : ajoutez le widget plusieurs fois pour avoir plusieurs jeux. Les scènes tournent en boucle dans l'ordre de la liste (animations, playlist, effets). La luminosité ne descend pas sous 10 % : pour éteindre, utilisez Éteindre.
Dépannage
- « Aucun Twinkly trouvé » : vérifiez que le Twinkly répond dans l'application, puis saisissez son IP dans Adresses IP.
- Un Twinkly passe « Injoignable » : il est débranché, hors Wi-Fi, ou son IP a changé. L'intégration relance une recherche (au plus une fois toutes les 5 minutes). Une IP fixe évite le problème.
- L'application Twinkly et Gladys en même temps : c'est possible. Si l'application prend la main, Gladys se reconnecte toute seule.
- Les journaux de l'intégration (page Supervision de Gladys) disent ce qui a été trouvé et ce qui ne répond pas.
Paramètres de configuration
Voici les paramètres demandés par Twinkly dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Installez d'abord votre Twinkly avec l'application Twinkly, sur le même réseau que Gladys. Gladys le pilote ensuite en local, sans compte ni cloud : elle le trouve seule (recherche réseau), ou vous saisissez son adresse IP ci-dessous. |
| Adresses IP | string | Non | Adresses IP de vos Twinkly, séparées par des virgules. Facultatif si la recherche réseau les trouve ; donnez-leur une IP fixe (réservation DHCP) dans votre box. |
| Recherche réseau | boolean | Non | Cherche les Twinkly sur le réseau (diffusion UDP sur le port 5555, émise par Gladys). Désactivez-la si votre réseau bloque la diffusion et que vous avez saisi les adresses IP. |
| Intervalle de rafraîchissement | select | Non | Fréquence de lecture de chaque Twinkly, pour suivre les changements faits depuis l'application. |
| À l'allumage, jouer | select | Non | Ce qu'affiche un Twinkly quand Gladys l'allume. |
Comment installer Twinkly dans Gladys
- Dans Gladys, ouvrez Intégrations : Twinkly 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/prohand/gladys-twinkly: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). - 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/prohand/gladys-twinkly.
Twinkly 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
Twinkly 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 prohand, 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