OBS_NOT_REACHABLE

OBS_NOT_REACHABLE 
 Chatlix Connect kann das OBS-WebSocket nicht erreichen. Sobald du eine Szenen-Aktion, ein Source-Toggle oder einen Replay-Buffer-Save aus dem Chatlix-Dashboard auslöst, antwortet die Pipeline mit diesem Fehler. Im Tray-Icon erscheint ein orangener Status, Connect selbst läuft normal weiter. 
 Voraussetzungen prüfen 
 Chatlix steuert OBS über das OBS-WebSocket-Protokoll v5 . Das ist seit OBS Studio 28 fest eingebaut, du brauchst kein externes Plugin mehr. 
 
 OBS-Version: Hilfe → Über OBS Studio. Steht dort < 28, aktualisieren. 
 WebSocket aktiv? Werkzeuge → « WebSocket-Server-Einstellungen » . Häkchen bei « WebSocket-Server aktivieren » muss gesetzt sein. 
 Port: Standard ist 4455 . Wenn du den Port geändert hast, muss er in Chatlix unter /dashboard/integrations/obs denselben Wert haben. 
 Passwort: OBS erzeugt standardmäßig ein Passwort. Klick auf « Verbindungsinformationen anzeigen » in OBS und kopiere das Passwort 1:1 ins Chatlix-Feld. Leerzeichen am Ende sind ein typischer Copy-Paste-Fehler. 
 
 Häufige Ursachen 
 1. OBS läuft nicht / ist abgestürzt 
 Connect pollt die WebSocket-Adresse alle paar Sekunden. Wenn OBS geschlossen ist, kommt sofort OBS_NOT_REACHABLE . Starte OBS und warte ein paar Sekunden — der Status sollte automatisch wieder grün werden. 
 2. Firewall blockt Port 4455 
 Unter Windows fragt die Firewall beim ersten OBS-Start, ob du den Zugriff erlauben willst. Wer das damals weggeklickt hat, hat OBS-WebSocket geblockt. 
 
 Windows: Windows-Sicherheit → Firewall & Netzwerkschutz → Eine App durch die Firewall lassen → OBS Studio für private Netzwerke freigeben. 
 Linux (ufw): sudo ufw allow from 127.0.0.1 to any port 4455 (nur Loopback reicht, da Connect lokal läuft). 
 
 3. Connect läuft auf anderem Rechner als OBS 
 Der typische Chatlix-Setup ist: Connect und OBS auf demselben PC. Wenn du Connect auf einem zweiten Rechner laufen lässt, muss du in der Connect-Config die IP+Port von OBS eintragen und sicherstellen, dass OBS-WebSocket nicht nur auf 127.0.0.1 lauscht. Das ist ein fortgeschrittenes Setup und für die meisten Streamer nicht nötig. 
 4. Passwort falsch (häufig) 
 Wenn du das OBS-Passwort neu generiert hast (Button « Passwort generieren » ), musst du den neuen Wert in Chatlix eintragen. Sonst kommen entweder OBS_NOT_REACHABLE (bei Handshake-Reject) oder obs_auth_failed -Folgefehler. 
 Diagnose 
 chatlix-connect status
 
 gibt unter anderem aus: 
 obs:
 configured: true
 url: ws://127.0.0.1:4455
 reachable: false
 last_error: ECONNREFUSED
 
 Die Werte verraten, ob das Problem auf TCP-Ebene liegt ( ECONNREFUSED , ETIMEDOUT ) oder im Handshake ( obs_auth_failed ). 
 Wenn alles passt und es trotzdem nicht geht 
 
 OBS einmal neustarten — manchmal startet das WebSocket-Modul nicht sauber durch. 
 Antivirus-Programme prüfen — manche Suites stufen lokale WS-Verbindungen als verdächtig ein. 
 Mehrere OBS-Profile: Chatlix verbindet sich gegen den Port, der im aktiven Profil eingestellt ist. Wechsel des Profils kann den Port ändern.