Common Errors

Konkrete Fehlermeldungen + ihre Loesung.

CONNECT_NOT_PAIRED

CONNECT_NOT_PAIRED

Dieser Fehler erscheint, wenn der Chatlix-Connect-Client auf deinem Rechner zwar läuft, aber keine gültige Verknüpfung zu einem Chatlix-Account hat. Connect kann sich dann nicht bei ws.chatlix.app autorisieren und bleibt im Tray-Icon mit rotem Punkt sichtbar.

Wann tritt der Fehler auf?

Lösung

Linux

Im Terminal:

chatlix-connect pair

Der Befehl gibt einen Hinweis aus, dass du einen Pairing-Code aus dem Dashboard brauchst. Den Code holst du dir hier:

  1. Dashboard öffnen: /dashboard/devices
  2. Button « Neues Gerät verbinden » klicken.
  3. Es wird ein 8-stelliger Code angezeigt (Lebensdauer 5 Minuten).
  4. Code in das wartende Terminal eingeben.

Connect bestätigt das Pairing und legt den neuen Token unter ~/.config/chatlix-connect/auth.json ab (Mode 600).

Windows

  1. Rechtsklick auf das Chatlix-Connect-Tray-Icon → « Pairing... ».
  2. Ein Dialog öffnet sich und wartet auf den Pairing-Code.
  3. Code aus /dashboard/devices holen (siehe oben).
  4. Code eintippen und mit « Verbinden » bestätigen.

Der Token wird unter %APPDATA%\Chatlix\Connect\auth.json gespeichert.

Diagnose, wenn das Pairing fehlschlägt

Mehrere Geräte verwalten

Unter /dashboard/devices siehst du alle gepairten Geräte mit Hostname, Betriebssystem, letzter Aktivität und Connect-Version. Geräte, die du nicht mehr verwendest, kannst du dort entfernen — der lokale Daemon erkennt das beim nächsten Reconnect und wirft denselben CONNECT_NOT_PAIRED-Fehler.

Wenn nichts hilft

Lösche die lokale Auth-Datei (auth.json) und führe den Pair-Vorgang noch einmal komplett von vorne durch. Im Dashboard das Gerät vorher entfernen, damit kein verwaister Eintrag stehen bleibt.

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.

  1. OBS-Version: Hilfe → Über OBS Studio. Steht dort < 28, aktualisieren.
  2. WebSocket aktiv? Werkzeuge → « WebSocket-Server-Einstellungen ». Häkchen bei « WebSocket-Server aktivieren » muss gesetzt sein.
  3. Port: Standard ist 4455. Wenn du den Port geändert hast, muss er in Chatlix unter /dashboard/integrations/obs denselben Wert haben.
  4. 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.

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

TWITCH_TOKEN_EXPIRED

TWITCH_TOKEN_EXPIRED

Chatlix hält pro verbundenem Twitch-Account einen OAuth-Access-Token und einen Refresh-Token. Der Access-Token läuft nach wenigen Stunden ab, Chatlix erneuert ihn automatisch mit dem Refresh-Token. Schlägt diese Erneuerung fehl, kommt TWITCH_TOKEN_EXPIRED. Sichtbar ist das meistens daran, dass plötzlich keine Chat-Nachrichten, keine Channel-Point-Redemptions und keine Sub-Events mehr ankommen.

Was Twitch macht

Twitch invalidiert Refresh-Tokens unter mehreren Bedingungen:

Was Chatlix macht

  1. Bei jedem fehlgeschlagenen Refresh markiert Chatlix die Integration als expired.
  2. Der Token wird nicht sofort gelöscht — du behältst Sichtbarkeit, dass eine Twitch-Verbindung mal da war.
  3. Im Dashboard erscheint ein rotes Warning-Banner: « Twitch-Verbindung abgelaufen — neu verbinden ».
  4. EventSub-Subscriptions werden pausiert, damit Chatlix nicht ins offene Messer rennt und 401-Loops fährt.

Lösung

  1. /dashboard/integrations aufrufen.
  2. Karte « Twitch » zeigt Status Abgelaufen. Button « Twitch neu verbinden » klicken.
  3. Du wirst zu Twitch geleitet und gefragt, ob du Chatlix wieder berechtigen willst. Die angeforderten Scopes werden angezeigt — kontrolliere, ob alle Häkchen passen (Hintergrund siehe Seite "Twitch-Scopes verstehen").
  4. Nach Bestätigung leitet Twitch zurück nach /dashboard/integrations, der Status wechselt auf Verbunden.

Was passiert im Hintergrund

Beim Re-Connect prüft Chatlix:

Häufige Folgefehler

Prävention

MEDIA_QUOTA_EXCEEDED

MEDIA_QUOTA_EXCEEDED

Deine Media-Library ist voll. Sobald du ein neues Asset (Bild, Sound, kurzes Video, GIF) hochlädst oder ein AI-generiertes Bild speicherst, lehnt der Server den Upload mit MEDIA_QUOTA_EXCEEDED ab. Die Aktion wird nicht halb durchgeführt — kein Teil-Upload, keine Credits werden für AI-Bilder verbrannt.

Wie groß ist die Quota?

Die Quota hängt am Plan deines Workspaces. Den aktuellen Stand fragst du am sichersten so ab:

GET /v1/plan/

Die Antwort enthält unter anderem:

{
  "plan": "free",
  "media_quota_bytes": 524288000,
  "media_used_bytes": 521943212,
  "...": "..."
}

Im Dashboard siehst du dasselbe als Fortschrittsbalken unter /dashboard/media. Bei ≥ 95% wird der Balken rot.

Als Richtwert (kann sich verschieben — der /v1/plan/-Response ist die Wahrheit):

Sofort-Lösungen

1. Aufräumen im Dashboard

/dashboard/media öffnen. Es gibt Filter:

Mehrfach-Auswahl per Häkchen, dann « Auswahl löschen ». Der Löschvorgang ist final (keine Tonne), Quota wird sofort wieder freigegeben.

2. Plan upgraden

Unter /dashboard/billing Plan wechseln. Die neue Quota greift sofort, der MEDIA_QUOTA_EXCEEDED verschwindet beim nächsten Upload.

3. Externe Hosting-URL nutzen

Für einzelne große Assets, die du eh anderswo liegen hast (z.B. CDN, Twitch-Asset, eigener S3-Bucket), kannst du in einigen Komponenten direkt eine URL eintragen statt einen Upload auszulösen. Achtung: Chatlix kann externe Quellen nicht garantieren — wenn die Datei woanders weg ist, ist sie auch im Overlay weg.

Warum AI-Bilder die Quota schnell füllen

Die ai_image_generate-Action speichert jedes erfolgreiche Bild automatisch in der Media Library. Pro Bild typisch 1–3 MB. Wer in einer Stream-Session 30 Bilder generiert, hat schnell 60–90 MB drauf. Tipps:

Diagnose, wenn der Balken "voll" anzeigt, du aber wenig drin hast

Verwandte Fehler