Direkt zum Hauptinhalt

Lighting Troubleshooting

Hue/LIFX/Tapo ließen sich nicht anlegen, Nanoleaf/Yeelight verhielten sich komisch (behoben 2026-07-08)

„Keine Bridge online" / Test-Toast „Browser tab"

Betrifft nur LAN-Provider (WLED, Yeelight, Hue, Nanoleaf). Chatlix hat den Steuerbefehl an deinen Redis-Channel published, aber niemand hat zugehört. Fix:

  • Öffne den Chatlix-Dashboard-Tab im selben WLAN wie die Lampe (das ist der Standard-Weg — keine zusätzliche Software nötig) und klick Test erneut.
  • Alternativ: Chatlix Connect starten und einloggen, oder game-watcher starten — beide können ebenfalls als Bridge dienen.
  • Wichtig: Es reicht ein aktiver Subscriber, mehrere gleichzeitig schaden aber auch nicht.

„ip_not_lan" beim Anlegen eines WLED-Geräts

Die eingegebene Adresse ist kein RFC1918-/Link-Local-/Loopback-Bereich (z.B. Hostname statt IP, oder eine öffentliche IP eingetragen). Fix: exakte LAN-IP eintragen, z.B. 192.168.x.x oder 10.x.x.x — per Router-DHCP-Liste oder nmap -sn ermitteln.

„not_wled" beim Test

Das Gerät auf der IP antwortet, ist aber kein WLED-Controller (die JSON-Antwort auf /json/info hat kein ver-Feld). Meist: falsche IP erwischt (z.B. Router oder ein anderes IoT-Gerät hat die IP jetzt, weil sie sich per DHCP geändert hat). Fix: WLED feste IP geben (Router-Reservation) oder IP neu ermitteln.

Geräte-Status rot — "no_route_to_host" / "unreachable"

Lampe im LAN nicht erreichbar.

  • Lampe online? Govee-App / Hue-App / Nanoleaf-App / Yeelight-App öffnen, dort direkt ansteuern.
  • Richtiges WLAN? Manche Smart-Plugs landen im 2.4-GHz-WLAN, während dein Bridge-Gerät im 5-GHz-WLAN läuft. Beide ins selbe Subnetz.
  • Gast-WLAN mit Client-Isolation blockt LAN-Provider komplett — Streaming-PC und Lampe müssen im „normalen" WLAN sein.
  • WLED/Yeelight: IP fix vergeben oder per DHCP-Reservation pinnen, sonst ändert sich die IP irgendwann und Chatlix findet sie nicht mehr (siehe auch „not_wled" oben).

Govee — "429 too many requests"

Govee erlaubt offiziell nur 10 Requests/Minute pro API-Key. Ein Magic-Preset-Pulse braucht 2 Calls (Farbe + Helligkeit) — bei 5 Fires/Minute bist du schon bei 10, also am Limit. Chatlix wartet die Backoff-Zeit ab und versucht erneut. Wenn das oft passiert:

  • Cinematic-Cooldown im Trigger erhöhen (z.B. 10s statt Standard).
  • Anzahl gleichzeitig getriggerter Govee-Geräte reduzieren — jede Lampe ist ein eigener API-Call, mehrere Govee-Lampen multiplizieren das Limit-Risiko.
  • Bei Gift-Sub-Bombs/Raid-Wellen: Rate-Limiting ist erwartetes Verhalten, kein Bug — Govees Cloud ist einfach so gedrosselt.

Govee — Scene/Bookmark reagiert nicht, obwohl "200 OK" kam

Bekannter Govee-Server-Bug (auch in der Govee-Community dokumentiert): Die Router-API bestätigt eine Szenen-Aktivierung mit 200 OK, aber die Lampe wechselt nicht. Chatlix versucht das nicht zu umgehen, weil es kein zuverlässiges Muster gibt. Fix: Bookmark neu capturen (Szene in der Govee-App erneut manuell auslösen, dann in Chatlix neu Capture klicken) oder auf einen Magic-Preset statt Bookmark wechseln.

Tapo — "auth_expired" / "token_expired"

Tapo-Cloud-Session-Token läuft regelmässig ab.

  • Im Dashboard "Token erneuern" klicken — Chatlix loggt sich mit den hinterlegten Zugangsdaten neu ein.
  • Wenn das nicht geht: Passwort in der Tapo-App geändert? Gerät entfernen und mit dem neuen Passwort neu anlegen.
  • bei Verdacht auf Kompromittierung Passwort in der Tapo-App ändern und Gerät in Chatlix neu anlegen.

LIFX — Discover findet keine Geräte / "lifx_discover_failed"

  • Token korrekt kopiert? Token ist ein 64-stelliger Hex-String aus cloud.lifx.com → Settings → Personal Access Tokens.
  • Lampen in der offiziellen LIFX-App online und dem Account zugeordnet, mit dem der Token erstellt wurde?
  • Token abgelaufen/widerrufen? Neuen Token generieren und Gerät neu anlegen.

Yeelight — Pulse tut nichts, Test bleibt gelb

Fast immer: „LAN-Control" ist in der Yeelight-App nicht aktiviert. Ohne diesen Schalter ignoriert die Lampe alle TCP-JSON-RPC-Calls aus dem LAN. Fix: Yeelight-App → Gerät → Einstellungen → LAN-Control einschalten, danach Test erneut probieren (ggf. Bridge/Dashboard-Tab neu laden).

Hue / Nanoleaf — "bridge_not_paired" / generell instabil

Denk dran: Hue und Nanoleaf laufen intern noch unter Status „kommt noch" (in Vorbereitung) — die Bausteine (Discovery, DB-Felder, Bridge-Payload) sind da, aber es ist kein durchgehärteter Produktionspfad wie bei WLED/Govee. Häufige Stolpersteine:

  • Bridge (Dashboard-Tab/Connect/game-watcher) läuft im selben WLAN wie die Hue-Bridge bzw. das Nanoleaf-Panel? Ohne das geht nichts.
  • Hue: Link-Button an der Bridge nicht rechtzeitig gedrückt beim Pairing-Versuch — Button muss innerhalb weniger Sekunden nach Klick auf „Bridge entdecken" gedrückt werden.
  • Nanoleaf: Auth-Token nur gültig, wenn er direkt nach dem 5-7s-Hold-Power-Pairing abgerufen wurde — ein alter/kopierter Token von früher funktioniert meist nicht mehr.
  • Bridge-IP geändert? Im Lighting-Menü Gerät bearbeiten, IP neu setzen.
  • Bleibt es instabil: das ist aktuell erwartbar, kein Fall für „mein Setup ist kaputt" — meld's trotzdem gern, das hilft uns beim Priorisieren von v2.

HTTP-Generic — "provider_experimental_disabled"

Der Provider ist standardmässig für Neuanlagen gesperrt (DIY-Alpha-Status). Bereits vorher angelegte HTTP-Generic-Geräte funktionieren weiter und lassen sich bearbeiten/löschen, aber kein neues anlegen. Wenn du unbedingt einen brauchst: Support kontaktieren.

"Test" tut nichts, aber ein Cinematic-Pulse läuft scheinbar normal

Möglich, dass nur der Test-Endpoint blockiert ist (z.B. Hue-Bridge-Username noch nicht freigegeben, aber der reguläre Pulse-Pfad hat andere Rechte). Klicke einmal einen echten Preset-Button statt „Test" — wenn das wirkt, ist nur die Test-Route inkonsistent (kein Streaming-Bug).

Lampe ist viel zu kurz / zu lang an

Jeder Magic-Preset hat eine fest hinterlegte Standarddauer (3-10s, siehe Seite „Provider Übersicht"). Wenn du eine eigene Dauer willst:

  • Baue eine Custom-Automation mit der Action Light Pulse statt „Cinematic feuern".
  • Dort kannst du Dauer + Preset frei kombinieren (innerhalb des serverseitigen Caps, damit keine Endlos-Strobes entstehen).

Mehrere Geräte sollen nicht alle gleichzeitig pulsen

Aktuell feuert eine Cinematic auf alle aktiven Geräte des Streamers gleichzeitig. Wenn du Geräte gruppieren willst (z.B. "nur Studio-Lampen für Game-Watcher-Events"), baue:

  • Custom-Automation pro Trigger.
  • Pro Gerät eine eigene Lighting-Action mit expliziter Geräte-ID.

Geräte-Gruppen als First-Class-Feature gibt es noch nicht — das ist im Backlog.

Govee-Gerät taucht bei "Geräte entdecken" nicht auf

Discovery zeigt nur Geräte, die laut Govee-Cloud controllable sind und Farbe/Helligkeit-Commands unterstützen. Reine BLE-only-Modelle (kein WLAN-Chip) sind zwar in der Govee-App sichtbar, tauchen bei Chatlix aber nie auf, weil die Cloud sie gar nicht kennt. Fix: Modell-Datenblatt prüfen, ob WLAN/Cloud-Steuerung überhaupt unterstützt wird — sonst geht nur ein Wechsel auf ein Cloud-fähiges Govee-Modell.