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:

• In OBS: BrowserSource → Eigenschaften — kopiere die URL raus.
• Im Dashboard unter /dashboard/overlays: dort steht die aktuelle URL fuer deinen Channel.
• Stimmen sie ueberein? Wenn du den Token rotiert hast (Sicherheits-Reset, Account-Aenderung), ist die alte URL ungueltig.

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:

• Dein Account-Passwort geaendert hast,
• Ein Pairing revoked hast,
• Den Overlay-Token explizit rotated hast (« Token neu generieren »),

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:

• Leere Seite mit ggf. Animations-Slot — alles OK. Overlay laedt, wartet auf Trigger.
• 401 Unauthorized JSON-Response — Token ungueltig oder revoked. Siehe Schritt 1+2.
• 404 Not Found — Channel-Slug falsch. Pruefe URL.
• Connection refused / Lange Ladezeit — DNS/Network. Pruefe nslookup overlay.chatlix.app.
• JS-Fehler in der DevTools-Console — bitte Screenshot davon an den Support.

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:

• In der BrowserSource-Eigenschaften unter dem URL-Feld den Button « Browser-Cache aktualisieren » klicken.
• Alternativ: « Browser-Cache aktualisieren wenn Szene aktiv wird » aktivieren — bei jedem Szenenwechsel wird neu geladen.
• Im Notfall: Source loeschen und mit der neuen URL neu hinzufuegen.

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:

• Rechtsklick auf die BrowserSource → Mit Interaktion.
• Im aufgehenden Fenster F12 druecken (oder Strg+Shift+I).

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 ».