Direkt zum Hauptinhalt

OBS_NOT_REACHABLE

Chatlix Connect ist gepairt und online, kann aber OBS nicht ansprechen. Sobald du eine Szenen-Aktion, ein Source-Toggle, einen Screenshot-Trigger oder eine Transform-Änderung aus dem Dashboard auslöst, kommt dieser Fehler zurück.

Wie die OBS-Anbindung technisch läuft

Chatlix steuert OBS nicht direkt, sondern über zwei Kanäle, die beide über Connect laufen (Backend: ObsRpcService):

  • Push-Cache: Connect schickt alle 10 Sekunden einen Snapshot des aktuellen OBS-Zustands (aktive Szene, Sources, Mute-Status) an den Server, der ihn in Redis mit 60s TTL zwischenspeichert. Das Dashboard liest für reine Anzeige-Zwecke aus diesem Cache — schnell, aber leicht verzögert.
  • Round-Trip-RPC: Für Aktionen (Szene wechseln, Screenshot holen) schickt der Server einen Befehl an Connect und wartet auf Antwort. Timeout ist konfigurierbar zwischen 200ms und 15s, Standard 5 Sekunden.

Voraussetzung auf deiner Seite: OBS-WebSocket v5, seit OBS Studio 28 fest eingebaut (kein Plugin nötig).

Die tatsächlichen Fehlerursachen

  • connect_offline — der Server sieht in Redis kein aktuelles „Connect ist online"-Flag. Heißt: Connect läuft entweder gar nicht, oder es hat gerade keine WebSocket-Verbindung zu Chatlix. Prüfe zuerst, ob Connect im Tray überhaupt aktiv ist.
  • connect_no_subscriber — laut Redis-Flag ist Connect online, aber die WebSocket-Subscription ist gerade weg (kurzer Verbindungsabriss/Reconnect). Meist selbstheilend innerhalb weniger Sekunden.
  • rpc_timeout — Connect selbst hat innerhalb des Zeitlimits nicht geantwortet. Das ist der klassische Fall, wenn OBS läuft, aber das WebSocket-Protokoll darin nicht erreichbar ist — falscher Port, falsches Passwort, oder OBS auf einem anderen Rechner als Connect.
  • rpc_error mit detail — Connect hat OBS erreicht, aber der konkrete Call ist fehlgeschlagen (z.B. Szene existiert nicht mehr, Source-Name falsch geschrieben).

Zusätzlich gibt es einen Stale-Marker: ist der Push-Cache-Snapshot älter als 30 Sekunden (3 verpasste Zyklen), markiert das Dashboard die Anzeige explizit als veraltet, statt falsche Live-Daten zu zeigen.

Voraussetzungen prüfen

  1. OBS-Version: Hilfe → Über OBS Studio. Unter 28 → aktualisieren.
  2. WebSocket aktiv? Werkzeuge → « WebSocket-Server-Einstellungen ». Häkchen bei „WebSocket-Server aktivieren" muss gesetzt sein.
  3. Port: Standard 4455. Muss mit der Connect-Konfiguration übereinstimmen.
  4. Passwort: 1:1 aus OBS „Verbindungsinformationen anzeigen" kopieren — Leerzeichen am Ende sind die häufigste Fehlerquelle.
  5. Firewall: Läuft OBS auf einem anderen Gerät im Netzwerk (Zweit-PC-Setup), muss Port 4455 lokal freigegeben sein.

Diagnose-Reihenfolge

  1. Läuft Connect überhaupt? (Tray-Icon-Status, siehe CONNECT_NOT_PAIRED für Pairing-Checks)
  2. Läuft OBS auf demselben Rechner wie Connect, oder Netzwerk-Setup?
  3. OBS-WebSocket-Server manuell mit einem WebSocket-Test-Tool ansprechen (z.B. Browser-Extension „obs-websocket tester"), um OBS-seitig auszuschließen.
  4. Connect-Log prüfen (connect.log) auf konkrete rpc_error-Details statt zu raten.

Kein generelles OBS-Last-Problem

Der Fehler hat nichts mit CPU-Last oder Anzahl deiner Overlays zu tun — das ist ein reines Erreichbarkeits-/Konfigurationsproblem. Für Performance-Fragen rund um viele Browser-Sources siehe OBS-Performance.