Lighting Grundlagen
Chatlix steuert Lampen während des Streams — über Automations, Reactions oder Cinematics. Wichtig zu wissen: die Lampen selbst laufen technisch über zwei völlig verschiedene Wege — Cloud-direkt oder LAN-Bridge. Welcher Weg gilt, hängt vom Provider ab (Details siehe Seite „Provider Übersicht“).
- Cloud-Provider — Govee, LIFX, Tapo. Chatlix-Server spricht direkt mit der Hersteller-Cloud. Kein Setup auf deinem Rechner nötig, funktioniert auch wenn dein Stream-PC gerade nicht online ist (Test/Pulse laufen server-seitig).
- LAN-Provider — WLED, Yeelight (produktiv), Hue, Nanoleaf (in Vorbereitung, siehe unten). Die Lampen sind nur im lokalen Netzwerk erreichbar. Chatlix-Server kann sie nicht direkt anfassen — er published einen Steuerbefehl über Redis an den Channel
user:<deine-id>:lights, und eine „Bridge” in deinem LAN führt den eigentlichen HTTP/TCP-Call gegen die Lampe aus. - DIY / Sonderfall — HTTP-Generic. Aktuell experimentell und nicht freigeschaltet — Neuanlage liefert
provider_experimental_disabled. Bereits angelegte Geräte laufen weiter.
Wer macht die LAN-Bridge?
Anders als man vermuten könnte, brauchst du für WLED/Yeelight keine zusätzliche Software. Der Standard-Weg ist: dein geöffneter Chatlix-Dashboard-Tab im selben WLAN wie die Lampe. Der Browser-Tab abonniert den Redis-Channel (Long-Poll/SSE über lights-bridge.js) und feuert den LAN-Call selbst. Kein Subscriber online → Test/Pulse laufen ins Leere, du bekommst den Hinweis „Keine Bridge online”.
Zwei Alternativen, falls du den Browser nicht offen halten willst:
- Chatlix Connect (Desktop-App) — hat ein eigenes Lighting-Actions-Modul, das denselben Redis-Channel abonniert und die Lampe steuert, sobald Connect läuft und eingeloggt ist.
- game-watcher — dieselbe lokale Runtime, die auch PC-RGB-Hardware ansteuert (siehe unten), kann ebenfalls als Bridge für WLED & Co. dienen.
Für alle drei gilt: Es reicht, wenn irgendeiner davon online ist und den Channel hört — es müssen nicht mehrere gleichzeitig laufen.
Wie produktionsreif ist welcher Provider?
| Provider | Status | Bridge nötig? |
|---|---|---|
| WLED | voll unterstützt, auch anlegbar | ja — Browser-Tab/Connect/game-watcher |
| Govee | voll unterstützt, auch anlegbar | nein, Cloud-direkt |
| LIFX | Provider-Klasse implementiert, aktuell nicht anlegbar (siehe Korrektur oben) | nein, Cloud-direkt |
| Tapo | Provider-Klasse implementiert, aktuell nicht anlegbar (siehe Korrektur oben) | nein, Cloud-direkt |
| Yeelight | Provider-Klasse implementiert (LAN, TCP-JSON-RPC) | ja — Bridge |
| Hue | In Vorbereitung — derzeit noch nicht einrichtbar | ja — Bridge |
| Nanoleaf | In Vorbereitung — derzeit noch nicht einrichtbar | ja — Bridge |
| HTTP-Generic | experimentell, derzeit nicht für neue Geräte freigeschaltet | meist ja, je nach Endpoint |
Hue und Nanoleaf sind in Vorbereitung und lassen sich derzeit noch nicht einrichten.
Sonderfall: PC-RGB-Hardware (Razer, OpenRGB, HyperHDR, Corsair)
Diese vier Provider existieren in der Datenbank und im game-watcher/Connect-Adapter-Set, sind aber nicht über den normalen „Gerät hinzufügen”-Dialog im Dashboard anlegbar. Sie sind für PC-Peripherie gedacht (Tastatur/Maus/Case-RGB, Capture-Karten-HDR-Sync) und werden über game-watcher lokal verwaltet, nicht über die Lighting-Seite. Wenn du RGB-Peripherie einbinden willst, ist game-watcher der richtige Einstieg, nicht diese Wiki-Seite.
Limits
| Limit | Wert |
|---|---|
| Geräte pro Streamer | 3 (hart im Code, MAX_DEVICES_PER_USER_V1) |
| Provider gleichzeitig | beliebig kombinierbar unter den aktuell tatsächlich anlegbaren Providern (WLED, Govee, HTTP-Generic) |
Wenn du mehr Geräte brauchst, melde dich beim Support — wir heben das Limit pro Konto an, sobald wir wissen, dass es nicht in unbedachte Storm-Loops läuft.
Was kann Lighting nicht?
- Lampen ausserhalb deines WLAN per LAN-Provider erreichen — die Bridge (Browser/Connect/game-watcher) muss physisch im selben Netz wie die Lampe laufen.
- Geräte über Bluetooth-only ansteuern (Govee BLE-only-Modelle gehen nicht; Govee Cloud-fähige schon).
- Strobe-Effekte in Endlos-Loop — Pulse-Dauer ist gecappt, damit Lampen/Netzteile nicht überlastet werden.
- Govee: keine eingebauten Strobe/Wipe-Effekte auslösen — Govee-Presets sind reine Color+Brightness-Sprünge (kein Effekt-Engine-Zugriff wie bei WLED). Vorgefertigte App-Szenen laufen stattdessen über „Scene Bookmarks”, siehe Seite „Provider Übersicht”.
- Hue, LIFX und Tapo aktuell überhaupt anlegen (Bug, siehe Korrektur oben); Nanoleaf/Yeelight korrekt als solche anlegen (werden als WLED fehlgespeichert).
Nächste Schritte
Wie du konkret ein Gerät anlegst: Seite „Gerät hinzufügen”. Vergleich aller Provider inkl. Govee-Scene-Bookmarks: Seite „Provider Übersicht”. Fehlerbilder & Fixes: Seite „Lighting Troubleshooting”.
Und was ist mit DMX-Scheinwerfern?
Seit August 2026 steuert Chatlix zusätzlich echte Bühnentechnik über Art-Net/DMX. Dieser Weg läuft nicht über die hier beschriebenen Lighting-Provider, sondern über einen eigenen Menüpunkt Connect-Lichtgeräte (/dashboard/lighting/connect) und über Chatlix Connect auf deinem Stream-PC.
Faustregel zur Abgrenzung:
- WLAN-Lampe mit Hersteller-App → Smart Lights, also diese Seite
- Scheinwerfer am DMX-Kabel hinter einem Art-Net-Gateway → Connect-Lichtgeräte
Alles Weitere dazu steht im eigenen Buch „DMX & Art-Net“: Gateways finden, Fixtureprofile, Gruppen, Szenen, Animationen und die Diagnoseseite.