Twinkly Smart-Home-Integration, kostenlos und Open Source
Steuere deine Twinkly-LED-Lichter über dein lokales Netzwerk.
Veröffentlicht von prohand
- Geräte
- Version 1.2.1
- Erfordert Gladys >=5.2.0
- ★ 0
Diese Integration verbindet Gladys mit deinen Twinkly-LED-Lichtern (Lichterketten, Vorhänge, Bäume, Squares, Flex, Dots…). Gladys steuert sie lokal, in deinem eigenen Netzwerk: ohne Konto, ohne Cloud.
Bevor du beginnst
- Richte jedes Twinkly zuerst mit der Twinkly-App ein und verbinde es mit deinem WLAN.
- Es muss sich im selben Netzwerk wie Gladys befinden.
- Gladys 5.2 oder neuer.
- Empfohlen: Gib ihm eine feste IP (DHCP-Reservierung in deinem Router). Ändert sich seine IP, findet die Integration es wieder, aber langsamer.
Twinkly hat keine öffentliche Cloud-API: Alles läuft über das lokale Netzwerk (Transport local).
Konfiguration
| Feld | Funktion |
|---|---|
| IP-Adressen | IP-Adressen deiner Twinkly-Geräte, durch Kommas getrennt. Optional, wenn die Suche sie findet. |
| Netzwerksuche | Sucht Twinkly-Geräte im Netzwerk (UDP-Broadcast, Port 5555). Standardmäßig aktiviert. |
| Aktualisierungsintervall | Wie oft jedes Twinkly abgefragt wird: 10 s, 15 s, 30 s oder 1 min. |
| Beim Einschalten abspielen | Was ein Twinkly zeigt, wenn Gladys es einschaltet (Standard: was es zuletzt abgespielt hat). |
Verbindung testen sucht die Twinkly-Geräte und listet auf, was antwortet: Name, Adresse, Anzahl der LEDs, Firmware-Version, aktueller Modus.
Ein Twinkly identifizieren spielt 5 Sekunden lang seine Demo ab und stellt es dann wieder so ein, wie es war: praktisch, um zu erkennen, welches welches ist.
Die Netzwerksuche findet nichts?
Der Container der Integration sieht keine Netzwerk-Broadcasts: Gladys sendet die Suche für ihn. Manche Netzwerke blockieren sie (getrennte VLANs, WLAN-Client-Isolation). Gib dann einfach die IP-Adressen ein.
Geräte hinzufügen
Drücke unter Integrationen → Twinkly → Entdecken auf Scannen und füge jedes Twinkly mit Zu Gladys hinzufügen hinzu. Jedes wird zu einer Leuchte mit:
| Funktion | Wirkung |
|---|---|
| Ein/Aus | Aus (Modus off) oder wieder an (siehe „Beim Einschalten abspielen“). |
| Helligkeit | 0 bis 100 %. Die Helligkeit eines ausgeschalteten Twinkly zu erhöhen, schaltet es ein. |
| Farbe | Feste Farbe (Firmware 2.7.1 oder neuer). |
| Szene | Die aus der App hochgeladenen Animationen, die Playlist und die integrierten Effekte. |
Das Gerät behält seine Identität (auf Basis seiner MAC-Adresse): Eine Umbenennung in der App oder eine neue IP erzeugt nie ein Duplikat.
Eine neue Animation aus der App hochgeladen? Starte erneut eine Suche, damit sie in der Liste Szene erscheint.
Szenen (Gladys 5.1 und neuer)
Auslöser
| Auslöser | Wann | Variablen |
|---|---|---|
| Ein Twinkly hat den Modus gewechselt | Der Modus hat sich außerhalb von Gladys geändert: App, seine Taste, eigener Timer. | device_name, mode, previous_mode |
| Ein Twinkly ist nicht erreichbar | Es antwortet nicht mehr (ausgesteckt, WLAN verloren…). | device_name |
| Ein Twinkly antwortet wieder | Es antwortet wieder. | device_name |
Eine von Gladys befohlene Änderung löst „hat den Modus gewechselt“ nie aus: Eine Szene kann keine Schleife bilden.
Änderungen werden bei jeder Abfrage erkannt: Bei einem Intervall von 30 s reagiert eine Szene innerhalb von 30 s.
Aktionen
| Aktion | Parameter | Ausgabe |
|---|---|---|
| Twinkly-Animation abspielen | Twinkly, Name der Animation (oder Nummer: 1 = erste) | movie (abgespielter Name) |
| Twinkly-Effekt abspielen | Twinkly, Effektnummer (1 = erster) | effect |
| Modus eines Twinkly ändern | Twinkly, Modus: ein, aus, Animation, Effekt, Playlist, feste Farbe, Demo | mode (angewendet) |
Um Farbe und Helligkeit in einer Szene einzustellen, verwende die Standardaktion von Gladys „Gerätewert setzen“.
Dashboard (Gladys 5.1 und neuer)
Das Widget Twinkly hat zwei Ansichten, die in seinen Einstellungen gewählt werden:
-
Kein Twinkly gewählt: eine Zeile pro Gerät (was es abspielt und wie hell, oder „Nicht erreichbar“) und zwei Schaltflächen: Alle ein und Alle aus.
-
Ein Twinkly gewählt: seine Live-Helligkeit, sein Zustand, die laufende Szene, seine Farbe, IP-Adresse, Anzahl der LEDs und Firmware sowie ein Satz Schaltflächen (Einstellung Schaltflächen):
Schaltflächen Funktion Szenen (Standard) Ein-/Ausschalten, vorherige Szene, nächste Szene, Identifizieren Helligkeit Ein-/Ausschalten, −10 %, +10 %, Max Modi Ein-/Ausschalten, Abspielen… (siehe unten) und bis zu 2 Modi: Animation, Playlist Farben Weiß, Rot, Grün, Blau (feste Farbe, Firmware 2.7.1+) Eine Karte enthält höchstens 4 Schaltflächen: Füge das Widget mehrmals hinzu, um mehrere Sätze zu erhalten. Die Szenen laufen in der Reihenfolge der Liste durch (Animationen, Playlist, Effekte). Die Helligkeit sinkt nicht unter 10 %: Zum Ausschalten verwende Ausschalten.
Abspielen… öffnet ein kleines Formular in der Karte: Wähle in einer einzigen Liste, was abgespielt werden soll — einen Modus (Animation, Playlist, feste Farbe, Effekt, Demo), eine der aus der App hochgeladenen Animationen oder einen integrierten Effekt — und optional eine Helligkeit (10 bis 100 %; leer lassen, um die aktuelle beizubehalten). Es ist mit dem vorausgefüllt, was das Twinkly gerade abspielt.
Fehlerbehebung
- „Noch kein Twinkly gefunden“: Prüfe, ob das Twinkly in der App antwortet, und gib dann seine IP unter IP-Adressen ein.
- Ein Twinkly wird „Nicht erreichbar“: Es ist ausgesteckt, nicht im WLAN, oder seine IP hat sich geändert. Die Integration startet eine neue Suche (höchstens alle 5 Minuten). Eine feste IP vermeidet das Problem.
- Die Twinkly-App und Gladys gleichzeitig: Das funktioniert. Wenn die App übernimmt, verbindet sich Gladys von selbst wieder.
- Die Protokolle der Integration (Reiter Protokolle in Gladys) zeigen, was gefunden wurde und was nicht antwortet.
Konfigurationseinstellungen
Diese Einstellungen fragt Twinkly in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Richte dein Twinkly zuerst in der Twinkly-App ein, im selben Netzwerk wie Gladys. Gladys steuert es dann lokal, ohne Konto und ohne Cloud: Gladys findet es selbst (Netzwerksuche), oder du gibst unten seine IP-Adresse ein. |
| IP-Adressen | string | Nein | IP-Adressen deiner Twinkly-Geräte, durch Kommas getrennt. Optional, wenn die Netzwerksuche sie findet; gib ihnen in deinem Router eine feste IP (DHCP-Reservierung). |
| Netzwerksuche | boolean | Nein | Sucht Twinkly-Geräte im Netzwerk (UDP-Broadcast auf Port 5555, von Gladys gesendet). Deaktiviere sie, wenn dein Netzwerk Broadcasts blockiert und du die IP-Adressen eingegeben hast. |
| Aktualisierungsintervall | select | Nein | Wie oft Gladys jedes Twinkly abfragt, um Änderungen aus der App zu verfolgen. |
| Beim Einschalten abspielen | select | Nein | Was ein Twinkly zeigt, wenn Gladys es einschaltet. |
So installierst du Twinkly in Gladys
- Öffne in Gladys Integrationen: Twinkly erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-twinkly:1.2.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-twinkly.
Twinkly benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Twinkly ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation