Troubleshooting

Allgemeine Symptom-Loesung-Sammlung. Quereinstieg fuer 'Bei mir geht X nicht'.

Reward erstellt aber nichts passiert

Reward erstellt aber nichts passiert

Klassisches Symptom: Du hast einen Channel-Points-Reward angelegt, dem eine Action zugeordnet, eingeloest — und nichts. Gehe die Diagnose streng der Reihe nach durch. Nicht die Action neu bauen, bevor die Stufen davor sauber sind.

1. Twitch-Reward aktiv?

Oeffne im Twitch-Dashboard die Channel-Points-Rewards. Pruefe:

Wenn der Reward nicht aktiv ist, kommt bei Chatlix kein einziges Event an. Das ist die haeufigste Ursache.

2. Event-Log zeigt Channel-Points-Trigger?

Im Dashboard unter /dashboard/events filterst du nach Typ twitch.channel_points.redeem oder dem konkreten Reward-Namen. Pruefe einen frischen Test-Redeem (lass jemanden den Reward einloesen):

Der Event-Log ist die Quelle der Wahrheit. Wenn kein Event dort steht, ist das Problem vor Chatlix.

3. Action isoliert testen

Wenn das Event ankommt, aber die Action nichts tut: Im Dashboard unter /dashboard/actions jede gemappte Action einzeln per « Test ausfuehren » triggern. Damit umgehst du den Reward-Pfad komplett.

4. Connect / OBS online?

Nur fuer OBS-Actions relevant. Im Dashboard unter /dashboard/connect:

Eine OBS-Action mit Connect: offline wird vom Event-Log als skipped: connect_offline markiert — nicht als Fehler.

5. Zeitfenster und Cooldown

Wenn alles oben sauber ist, pruefe Reward-spezifische Limits:

Ein im Quiet-Hours geblocktes Event taucht im Log mit blocked: schedule auf — das wird oft uebersehen, weil das Event sichtbar da ist, aber die Action nicht.

Wenn alles passt und es trotzdem nicht laeuft

Nimm eine Screenshot vom Event-Log-Eintrag (mit Trigger-ID) und schick ihn an den Support. Die Trigger-ID ist der eindeutige Anker, mit der wir das Event durch die Pipeline zurueckverfolgen.

BrowserSource flackert

BrowserSource flackert

Flackern der BrowserSource zeigt sich als: kurzzeitiges Schwarz, weisse Frames, Tearing bei Animationen, oder ein Aufblitzen direkt nach einem Reaction-Trigger. In ueber 90% der Faelle ist das kein Chatlix-Problem, sondern Hardware-Acceleration im Chromium-Embed von OBS.

Reihenfolge der Workarounds

1. BrowserSource neu hinzufuegen

Klingt billig, hilft aber oft. OBS cached Render-State pro Source. Wenn die Source aus einer alten OBS-Version stammt oder oft umkonfiguriert wurde, kann der Render-Context inkonsistent sein.

Das behebt rund die Haelfte der Flacker-Reports.

2. Hardware-Acceleration in OBS togglen

OBS Studio nutzt Chromium fuer BrowserSources. Auf manchen GPU-Treibern (besonders aelteren NVIDIA-Versionen und Intel-iGPUs) kommt es bei aktivierter Hardware-Acceleration zu Tearing.

Das Toggle hat zwei Richtungen: auf manchen Systemen hilft on, auf anderen off. Probier beides aus.

3. Custom-CSS Hack

Einige Overlays flackern, weil OBS Frames waehrend des Compositings dropped. Ein hartes transform: translateZ(0) zwingt Chromium, das Element in einen eigenen Compositor-Layer zu legen — Tearing ist dann meist weg.

Im OBS BrowserSource Properties-Dialog gibt es das Feld Custom CSS. Standardmaessig steht da bereits ein body { background-color: rgba(0, 0, 0, 0); }. Erweiter es um:

body {
  background-color: rgba(0, 0, 0, 0);
  transform: translateZ(0);
  backface-visibility: hidden;
}

Nach « OK » neu zeichnet OBS die Source. Wenn das Flackern weg ist, war es ein Compositor-Layer-Issue.

4. OBS-Version pruefen

Fuer Chatlix-Overlays empfehlen wir OBS Studio 30.x oder neuer. OBS 28/29 haben Chromium-Versionen, die mit modernen CSS-Animations Tearing zeigen.

Nach einem OBS-Update kann das Browser-Cache aktualisieren einmal manuell ausgeloest werden (Rechtsklick auf Source → Aktualisieren).

Wenn das Flackern nur bei bestimmten Effects auftritt

Manche Reaction-Effects (vor allem Particle-basierte) zeigen auf low-end-GPUs Stutter, der wie Flackern aussieht. In dem Fall:

Wenn das Flackern nur im Aufnahme-Output ist, nicht im Preview

Das deutet auf einen Encoder-Bottleneck hin, nicht auf BrowserSource. Pruefe in OBS unter Statistiken die Frame-Drops. Wenn Encoder verpasste Frames > 0, hat dein Encoder Performance-Probleme — das kann mit einer Reduzierung der Output-Aufloesung, einem Wechsel auf NVENC/x264-CPU oder einer niedrigeren Bitrate behoben werden.

Wenn alles oben nicht hilft

Mach einen 30-Sekunden-Mitschnitt mit sichtbarem Flackern, notier OBS-Version, GPU und Treiber-Version und schick es an den Support. Wir koennen anhand des Pattern oft auf GPU-Treiber-Bugs schliessen, fuer die es konkrete Workarounds gibt.

Audio reagiert nicht

Audio reagiert nicht

Wenn eine Reaction oder ein TTS-Output zwar visuell im Overlay erscheint, aber kein Ton raus geht, liegt das fast nie an Chatlix selbst — sondern am Audio-Routing zwischen Browser-Source, OBS-Mixer und Output. Die folgende Reihenfolge deckt > 95% der Faelle ab.

1. Browser-Source erscheint im Mixer?

In OBS unter Audio-Mixer (unten in der Hauptansicht) muss die BrowserSource als eigener Slider sichtbar sein. Wenn nicht:

2. Audio-Monitoring korrekt eingestellt

Im Audio-Mixer rechtsklicken → Erweiterte Audio-Eigenschaften. Fuer die BrowserSource musst du in der Spalte « Audio-Monitoring » einen der folgenden Werte setzen:

Wenn der Wert auf « Monitor aus » steht, hoeren nur die Zuschauer den Ton — du nicht. Wenn der Wert auf « Nur Monitor » steht, hoerst nur du den Ton — die Zuschauer nicht.

Der haeufigste Fehler: « Nur Monitor » ist gesetzt, der Streamer testet im Headset und denkt alles laeuft, aber im Stream-Output kommt nichts an.

3. Monitoring-Device korrekt

Weiterhin in Erweiterte Audio-Eigenschaften: ganz oben ist Monitoring-Geraet. Das muss dein Output-Geraet sein (Headset, Lautsprecher), nicht ein virtuelles Mikrofon. Auf VoiceMeeter-/VB-Cable-Setups ist das ein klassischer Trap — wenn das Monitoring auf eine Virtual-Cable-Input zeigt, hoerst du nichts und der Stream auch nicht.

4. OS-Mute / OS-Mixer

Windows und Linux haben einen App-Mixer (Lautstaerke-Mixer / pavucontrol). Pruefe:

Vor allem nach Windows-Updates wird der App-Mixer manchmal neu gewichtet und einzelne Apps landen auf sehr leise.

5. Volumen in der Chatlix-Action

Wenn die ersten vier Stufen sauber sind, lieg's an der Source. Im Dashboard unter /dashboard/sounds/<id> oder im Action-Editor:

Der « Test »-Button im Sound-Editor spielt die Datei im Browser ab. Wenn er dort nichts spielt, kommt sie auch nicht in OBS an.

6. Stream-Output testen

Ein lokales Recording mit « Aufnahme starten » (10 Sekunden), Trigger ausloesen, Aufnahme beenden, Datei in einem Player oeffnen. Wenn die Aufnahme den Ton enthaelt, ist das Routing korrekt — Zuschauer hoeren ihn dann auch. Wenn nicht, ist es ein OBS-internes Routing-Problem, kein Chatlix-Problem.

Spezialfall: Reactions ohne Sound

Manche Reactions sind bewusst stumm konfiguriert (rein visuell). Pruefe im Reaction-Editor unter /dashboard/reactions/<id>, ob ein Sound zugeordnet ist. Wenn die Reaktion aus dem Standard-Pack stammt und stumm ist, ist das as designed.

Connect-Status: offline

Connect-Status: offline

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

1. Connect ueberhaupt gestartet?

Klingt trivial, ist die haeufigste Ursache. Auf der Maschine, auf der Connect laufen soll:

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

2. Pairing-Token noch gueltig?

Im Dashboard unter /dashboard/connect siehst du in der Pairing-Liste alle aktiven Tokens. Pruefe:

Im Connect-Log siehst du in dem Fall pairing token invalid oder 401 unauthorized direkt nach dem Start. Loesung:

chatlix-connect-linux pair

Danach laeuft Connect mit dem neuen Token.

3. Ausgehende Firewall

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

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 getaddrinfo ENOTFOUND ws.chatlix.app.

5. Restart

Wenn 1-4 sauber sind, mach einen sauberen Restart:

Nach dem Restart sollte der Status innerhalb von 5-15 Sekunden auf online springen.

6. Logs lesen

Die konkreten Fehler stehen in den Logs:

Die letzten 50 Zeilen reichen meist. Typische Eintraege:

Log-Zeile Bedeutung
ws connected alles OK
ws closed code=1006 Netzwerk-Abbruch, Connect retried automatisch
401 unauthorized Pairing-Token ungueltig, re-pairen
getaddrinfo ENOTFOUND DNS kaputt
ECONNREFUSED Firewall blockt ausgehend

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.

Overlay laedt nicht

Overlay laedt nicht

Das Overlay laedt nicht heisst meistens: in OBS ist die BrowserSource leer (schwarz, weiss, oder ein 404-Hinweis). Selten ist es ein Rendering-Problem, fast immer ein Token-, URL- oder Cache-Problem.

1. Token in der URL korrekt?

Die Overlay-URL hat das Format:

https://overlay.chatlix.app/<channel>?t=<token>

Der t=-Parameter ist Pflicht. Pruefe:

Der Token im Dashboard ist immer die Quelle der Wahrheit. Bei Abweichung: die neue URL kopieren und in OBS einsetzen.

2. Token nicht rotiert?

Unter /dashboard/overlays siehst du, wann der Token zuletzt rotiert wurde. Wenn du in den letzten Stunden:

ist die alte URL tot. Dasselbe in OBS einsetzen.

3. Test im normalen Browser

Kopier die Overlay-URL und oeffne sie in einem normalen Chrome/Firefox-Tab — nicht OBS-intern. Du solltest sehen:

Der Browser-Test ist der wichtigste Schritt. Wenn das Overlay im Browser arbeitet, aber nicht in OBS, ist es ein OBS-spezifisches Problem (typisch: Cache).

4. Cache in OBS aufraeumen

OBS cached BrowserSources aggressiv. Wenn du nach einem Token-Wechsel die URL geaendert hast, aber OBS noch die alte Response cached, hilft:

5. Width / Height

Wenn die Overlay-Antwort kommt, aber visuell nichts erscheint: pruefe die Source-Groesse. Default sollte 1920 × 1080 sein. Wenn die BrowserSource z.B. 100 × 100 ist, wird das Overlay zwar geladen, ist aber nur ein winziges Viereck.

Im Eigenschaften-Dialog der Source steht das Feld direkt unter der URL. Setze beide auf deine tatsaechliche Output-Aufloesung — nicht skalieren ueber den Transform-Modus.

6. Mehrere Overlays parallel

Wenn du mehrere BrowserSources mit derselben URL hast (z.B. Test-Szene + Live-Szene), teilen sie sich nicht den Render-State. Das ist Absicht — jede Source ist eine eigene Browser-Instanz. Bei vielen parallelen Overlays kann die CPU/GPU-Last steigen; bei Performance-Problemen reduziere auf eine Source, die in mehreren Szenen sichtbar geschaltet wird.

7. Devtools im OBS-Browser

Du kannst die DevTools direkt im OBS-Browser oeffnen:

Damit siehst du Console-Fehler, Network-Requests und kannst genau pruefen, welche Antwort der Overlay-Endpoint liefert. Bei 401 siehst du z.B. den exakten Token-Error-Code, der dem Support hilft.

8. Wenn alles passt aber nichts kommt

Die Overlay-Page ist geladen, wartet aber auf Events. Wenn keine Reactions kommen, ist nicht das Overlay kaputt, sondern der Trigger-Pfad — siehe Seite « Reward erstellt aber nichts passiert ».