Connect-Status: offline

Wenn das Dashboard unter /dashboard/connect offline zeigt, kommen keine OBS-Actions, Game-Watcher-Events, lokalen Sound-Presets oder Hardware-Trigger durch. Reactions auf Pure-Overlay-Basis (BrowserSource ohne Connect) funktionieren weiter — alles, was Hardware-Zugriff, OBS-WebSocket oder lokale Ausfuehrung auf dem Streamer-PC braucht, nicht.

Wichtig, weil es haeufig falsch angenommen wird: Chatlix Connect ist aktuell ein reines Windows-Programm (Electron/Node, als EXE bzw. ZIP ausgeliefert). Es gibt keine offizielle Linux- oder macOS-Version, keinen Systemd-Service und kein Menubar-Icon auf dem Mac. Wenn du auf Linux oder macOS streamst, kannst du Connect derzeit nicht nutzen — nur reine Overlay-Reactions ohne OBS-Steuerung funktionieren dort.

1. Connect ueberhaupt gestartet?

Klingt trivial, ist die haeufigste Ursache.

Ist im System-Tray (unten rechts, Pfeil zum Einblenden versteckter Icons) ein Chatlix Connect-Icon zu sehen? Seit Version 0.5.0 ist der Tray-Modus Standard.
Falls kein Tray-Icon da ist, aber ein Konsolenfenster offen ist: Connect wurde vermutlich mit --no-tray gestartet (sichtbare Konsole statt Tray) — das ist gewollt und kein Fehler, solange das Fenster offen bleibt.
Wurde die ChatlixConnect starten.bat aus dem entpackten Programmordner gestartet, oder versehentlich direkt aus der ZIP-Vorschau? Ein Start direkt aus dem ZIP-Fenster heraus schliesst sich meist sofort wieder, weil Windows dabei nur eine temporaere Kopie einzelner Dateien entpackt. Immer erst per Rechtsklick → « Alle extrahieren » in einen festen Ordner (z.B. C:\Tools\ChatlixConnect) entpacken, nicht in OneDrive und nicht ins Programme-Verzeichnis, dann von dort starten.

Wenn der Prozess nicht laeuft, ist offline korrekt. Starten und 5-10 Sekunden warten.

2. Verbindungs-Token noch gueltig?

Connect authentifiziert sich nicht per interaktivem Pairing-Kommando, sondern ueber einen Token, der in der lokalen Konfigurationsdatei connect.json (im Connect-Installationsordner, direkt neben der EXE) steht:

{
  "chatlix": {
    "url": "wss://ws.chatlix.app/ws",
    "api_base": "https://chatlix.app",
    "token": "DEIN_CONNECT_TOKEN_AUS_DEM_DASHBOARD",
    "client_id": "mein-pc"
  }
}

Im Dashboard unter /dashboard/connect generierst/holst du diesen Token. Pruefe:

Ist der Token in der lokalen connect.json identisch zu dem, was im Dashboard aktuell angezeigt wird?
Wurde er manuell rotiert/revoked (Button « Token neu generieren » im Dashboard)? Dann ist die alte lokale Kopie automatisch ungueltig — die neue muss manuell in connect.json eingetragen werden.
Wurde er durch ein Account-Reset oder Password-Reset auto-revoked? (Passiert bei vollem Account-Reset.)

Im Connect-Log siehst du in dem Fall eine [AUTH]-Fehlermeldung direkt nach dem Start bzw. einen [WS] HTTP 401-Eintrag (Connect versucht in dem Fall automatisch einen Token-Refresh, sichtbar als [SELF-HEAL] connect_token_refresh_...). Haeufigste Ursache dabei: der Token wurde mit einem fuehrenden/nachgestellten Leerzeichen kopiert (z.B. aus einem Chat oder einer Mail). Loesung: Token frisch aus dem Dashboard kopieren, in connect.json einfuegen, Connect komplett neu starten — es gibt keinen Hot-Reload fuer Config-Aenderungen, ein reines Trennen/Verbinden reicht nicht.

3. Ausgehende Firewall

Connect baut eine WebSocket-Verbindung zu wss://ws.chatlix.app/ws (Port 443/TCP, ausgehend) auf. Pruefe:

curl -v https://ws.chatlix.app/ antwortet mit einem HTTP-Fehler wie 426 Upgrade Required (erwartet — der Endpoint ist nicht GET-faehig, aber TCP-Connect funktioniert, das reicht als Nachweis).
Wenn curl haengt oder Connection refused zurueckkommt, blockt eine Firewall / ein Filter den Traffic. Im Connect-Log erscheint in dem Fall eine [WS]-Fehlermeldung mit Netzwerk-Ursache (z.B. "Chatlix-Server nicht erreichbar — Firewall oder Server offline?").
Auf Firmen-Netzen muss eventuell die Domain *.chatlix.app whitelisted werden.

Wichtig: Chatlix nutzt WSS auf 443, kein anderer Port. Du brauchst keine Sonderfreigaben.

4. DNS-Probleme

Auf manchen Setups (Pi-hole, AdGuard, Corporate-DNS) kann der Domain-Resolve fehlschlagen:

nslookup ws.chatlix.app

Erwartet: gueltige IP. Wenn NXDOMAIN oder SERVFAIL, ist dein Resolver kaputt. Connect zeigt in dem Fall im Log eine [WS]-Meldung wie "DNS-Fehler: Hostname nicht aufloesbar".

5. Restart

Wenn 1-4 sauber sind, mach einen sauberen Restart: Rechtsklick auf das Tray-Icon → « Beenden », dann per ChatlixConnect starten.bat neu starten. Nach dem Restart sollte der Status innerhalb von 5-15 Sekunden auf online springen.

Nach laengeren Standby-/Sleep-Phasen des PCs (> 1 Tag) kann der erste Reconnect nach dem Aufwachen etwas laenger dauern, bis der interne Wake-Watcher anschlaegt — meist < 15 Sekunden, kein Grund zur Sorge. Erst wenn nach ca. 1 Minute nach dem Aufwachen weiterhin offline steht, ist es ein echtes Problem — dann Connect manuell beenden und neu starten.

6. Logs lesen

Die konkreten Fehler stehen in logs\connect.log — dieser Pfad ist relativ zum Connect-Installationsordner (dort, wo die EXE bzw. die entpackte ZIP liegt), nicht unter %APPDATA%. Wenn Connect z.B. unter C:\Tools\ChatlixConnect liegt, findest du die Log-Datei unter C:\Tools\ChatlixConnect\logs\connect.log.

Am einfachsten ueber das mitgelieferte ChatlixConnect Logs oeffnen.bat im Programmordner — das oeffnet den Ordner direkt, ohne den Pfad suchen zu muessen. Die letzten 50-200 Zeilen reichen meist. Typische Eintraege:

Log-Zeile	Bedeutung
`[WS] socket open — awaiting hello` / `[AUTH] auth_ok received`	alles OK
`[WS] Verbindung getrennt (<code>) — erneuter Versuch in Xs...`	Netzwerk-Abbruch, Connect retried automatisch
`[WS] HTTP 401` / `[SELF-HEAL] connect_token_refresh_failed`	Token alt/falsch kopiert/im Dashboard rotiert, neu eintragen
`[OBS] OBS antwortet nicht auf <host>:<port>`	OBS laeuft nicht oder WebSocket-Server in OBS nicht aktiviert
`[OBS] Authentifizierung fehlgeschlagen`	falsches Passwort in `connect.json` ODER ein zu altes/inkompatibles obs-websocket-Plugin — Connect unterscheidet das im Log nicht, im Zweifel Passwort pruefen und OBS auf 28+ updaten
`[WS] DNS-Fehler: Hostname nicht aufloesbar`	DNS kaputt
`PREFLIGHT_ONEDRIVE` ("ChatlixConnect liegt in OneDrive")	Programmordner liegt in OneDrive mit "Dateien bei Bedarf" — Ordner nach z.B. `C:\Tools\ChatlixConnect` verschieben
`[WS] erzwinge Reconnect (wake-from-sleep)` ggf. mit `[WS] Reconnect-Storm erkannt (...)`	PC kam aus langem Standby, Netzwerk-Stack noch nicht warm — kurz abwarten oder Connect neu starten

Falls Connect abgestuerzt ist, findest du zusaetzlich Crash-Dumps im Unterordner crashes\ — das ist immer meldenswert (Support/Discord #beta), nicht selbst reparierbar.

Diagnose-Bundle fuer den Support

Statt einzelne Log-Zeilen abzutippen: im Connect-Programmordner liegt ChatlixConnect Diagnose exportieren.bat. Ein Doppelklick erzeugt eine TXT-Datei im Unterordner diagnostics\. Tokens, OBS-Passwoerter, Cookies und volle Windows-Benutzerpfade werden darin automatisch maskiert. Nicht automatisch gefiltert werden z.B. Klarnamen in eigenen Szenen-/Quellen-Labels oder Query-Tokens in extern eingetragenen Webhook-URLs (z.B. Discord) — wirf vor dem Versenden kurz selbst einen Blick mit einem Texteditor drueber und entferne, was nicht oeffentlich sein soll. Das Format bleibt auch nach dem Loeschen einzelner Zeilen verarbeitbar.

7. Server-seitiger Ausfall

In seltenen Faellen ist der WS-Cluster gestoert. Pruefe den Status auf status.chatlix.app (falls verfuegbar) oder im Discord-Channel #status. Wenn das WS-Backend down ist, helfen keine Client-seitigen Massnahmen.

Siehe auch: « Reward erstellt aber nichts passiert » (Schritt 4, OBS-Actions), « Audio reagiert nicht » (Spezialfall lokale Sound-Presets).