Direkt zum Hauptinhalt

Gerät hinzufügen

Allgemeiner Ablauf

  1. Im Dashboard Lighting (Sidebar-Badge „NEU”) öffnen.
  2. Gerät hinzufügen klicken.
  3. Provider-Tab wählen: WLED, Govee, Hue, Nanoleaf, LIFX, Tapo, Yeelight oder HTTP-Generic.
  4. Pro Provider folgst du den unten beschriebenen Schritten.
  5. Nach dem Speichern erscheint das Gerät in der Liste. Klick Test — bei Cloud-Providern läuft der Test sofort server-seitig, bei LAN-Providern muss dafür ein Dashboard-Tab/Chatlix Connect/game-watcher im selben WLAN offen sein (siehe Seite „Lighting Grundlagen”, Abschnitt „Wer macht die LAN-Bridge?”).

Maximal 3 Geräte pro Account, beliebig gemischt über Provider.

WLED (LAN)

  • Eingaben: Name, Geräte-IP (z.B. 192.168.1.42).
  • Backend akzeptiert nur RFC1918-/Link-Local-/Loopback-Adressen (kein Hostname, kein DNS-Name) — sonst Fehler ip_not_lan.
  • Voraussetzung für Test/Pulse: Dashboard-Tab offen im selben WLAN wie der WLED-Controller (oder Chatlix Connect/game-watcher laufen dort).
  • IP finden: Router-DHCP-Liste (oft „wled-XXXXXX”), WLED-App am Handy, oder nmap -sn 192.168.1.0/24 im Terminal.
  • Test prüft GET http://<ip>/json/info — Antwort ohne ver-Feld heisst „ist online, aber kein WLED” (Code not_wled).

Govee (Cloud)

  • Eingaben: Govee-API-Key. Holen: Govee-Home-App → Profil → Einstellungen → „Apply for API Key” (kommt per E-Mail von Govee, meist innerhalb Minuten).
  • Nach Eingabe des Keys: Geräte entdecken klicken — Chatlix ruft developer-api.govee.com auf und listet nur Geräte, die controllable sind und Farb-/Helligkeits-Commands unterstützen (Geräte ohne diese Capability tauchen nicht auf).
  • Gerät aus der Liste auswählen, Name vergeben, speichern.
  • Test/Pulse laufen komplett server-seitig — kein Bridge-Tab nötig.

Govee-Cloud erlaubt offiziell 10 Requests/Minute pro API-Key. Ein Magic-Preset-Pulse macht 2 Calls (Farbe + Helligkeit) — bei sehr häufigen Triggern (z.B. Bit-Cheer-Sturm) kommt schnell ein 429. Details zum Umgang siehe Troubleshooting-Seite.

LIFX (Cloud)

  • Eingaben: LIFX-Personal-Access-Token (cloud.lifx.com → Settings → Personal Access Tokens → Generate New Token).
  • Token einfügen, Geräte entdecken klicken — Chatlix listet deine Lampen über die LIFX-Cloud-API.
  • Lampe auswählen, speichern. Auch hier: reiner Cloud-Pfad, keine Bridge nötig.

Tapo (Cloud)

  • Eingaben: Tapo-Account E-Mail + Passwort.
  • Einloggen klicken — Chatlix loggt sich gegen die TP-Link-Cloud ein, holt die Geräteliste und merkt sich Session-Token + regionale App-URL (z.B. eu-wap.tplinkcloud.com).
  • Gerät aus der Liste wählen, speichern.
  • Wenn der Session-Token abläuft: Dashboard zeigt „Token erneuern” — einmal klicken, Chatlix loggt sich erneut ein.
  • Nutze für Tapo möglichst ein Passwort, das du nirgendwo sonst verwendest.

Yeelight (LAN)

  • Eingaben: nur die Geräte-IP im LAN.
  • Voraussetzung: In der Yeelight-App unter dem Gerät „LAN-Control” aktivieren (sonst reagiert die Lampe nicht auf Chatlix-Calls).
  • Steuerung läuft über TCP-JSON-RPC auf Port 55443, ausgeführt von der Bridge (Dashboard-Tab/Connect/game-watcher) — kein zusätzlicher Auth-Token nötig.

Hue / Nanoleaf (LAN, in Vorbereitung)

Hue und Nanoleaf sind im Dashboard anlegbar und die Discovery-Buttons funktionieren technisch, sind aber noch nicht freigegeben. Rechne mit rougheren Kanten als bei WLED/Govee/LIFX/Tapo/Yeelight.

  • Voraussetzung: Bridge (Dashboard-Tab/Connect/game-watcher) im gleichen WLAN wie die Hue-Bridge bzw. das Nanoleaf-Panel.
  • Hue: Bridge entdecken klicken (mDNS-artige Suche im LAN), dann am Hue-Bridge-Gerät den physischen Link-Button drücken und Username + Light-ID eintragen.
  • Nanoleaf: Geräte-IP + Auth-Token. Token holen: Power-Button am Controller 5-7 Sekunden gedrückt halten, dann POST /api/v1/new gegen die Panel-IP (Chatlix macht das nicht automatisch für dich).

HTTP-Generic (experimentell, Neuanlage aktuell gesperrt)

Für alles, was kein nativer Provider ist (ESP32/Raspberry Pi mit eigener API, Webhooks, DIY-Bridges). Der Provider ist als „DIY-Alpha” markiert; Neuanlage ist standardmässig deaktiviert (Fehler provider_experimental_disabled). Bereits vor der Deaktivierung angelegte Geräte funktionieren weiter und lassen sich bearbeiten/löschen.

  • Wenn freigeschaltet: Base-URL, Methode (GET/POST/PUT/PATCH), optionale Header (max. 10, je 512 Zeichen), Action-Templates als JSON ({action_name: {url_suffix, body}}).
  • Platzhalter im Body-Template: r, g, b, brightness, state, preset, hex.
  • Timeout konfigurierbar 100-10000ms (Default 3000ms).
  • SSRF-Schutz serverseitig aktiv — interne/private Ziel-URLs, die nicht dein eigenes Gerät sind, werden geblockt.
  • Kein automatisches Discovery — du gibst exakt einen Endpoint an.

Wie sicher sind deine Zugangsdaten gespeichert?

Aktuell ist nur der Govee-API-Key nachweislich verschlüsselt (Backend-Encryptor, Klartext kommt im Dashboard nie zurück — du siehst nur „Key vorhanden” / „Key entfernen”). Tapo-Passwort, LIFX-Token, Hue-Username und Nanoleaf-Token liegen laut aktuellem Code-Stand noch als Klartext in der Datenbank (geplante Verschlüsselung für eine spätere Welle). Wenn du willst, dass ein Key komplett verschwindet: Gerät löschen statt nur bearbeiten.