Direkt zum Hauptinhalt

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. Wenn das Overlay stattdessen laedt, aber sichtbar zuckt/flackert, bist du hier falsch — siehe stattdessen « BrowserSource flackert ».

1. Token in der URL korrekt?

Die Overlay-URL hat das Format:

https://chatlix.app/overlay/view.php?id=<overlay-id>&token=<token>

Es gibt keinen Channel-Namen in der URL — massgeblich sind die numerische id deines Overlays und der token-Parameter, beide Pflicht. Pruefe:

  • In OBS: BrowserSource → Eigenschaften — kopiere die URL raus.
  • Im Dashboard unter /dashboard/overlays: dort steht die aktuelle URL fuer dein Overlay.
  • Stimmen sie ueberein? Wenn du den Token explizit ueber « Token neu generieren » rotiert hast, 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. Beachte: dieser Overlay-Token ist ein eigener Wert, getrennt vom Connect-Token aus connect.json (siehe « Connect-Status: offline ») — beide liegen in getrennten Datenbank-Tabellen und werden unabhaengig voneinander rotiert.

2. Token nicht rotiert?

Unter /dashboard/overlays siehst du deine aktuelle Overlay-URL. Wichtig: die alte URL wird ausschliesslich ungueltig, wenn du im Dashboard explizit auf « Token neu generieren » klickst. Ein Passwort-Wechsel oder das generelle Widerrufen einer Verbindung/eines Pairings rotiert den Overlay-Token nicht mit — das betrifft nur deine Login-Sessions bzw. den separaten Connect-Token.

Nach einem expliziten Regenerieren ist die alte URL sofort 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.
  • Seite laedt (HTTP 200), zeigt aber eine sichtbare Fehler-Karte statt Overlay — id oder token falsch/veraltet. Chatlix unterscheidet hier bewusst nicht, ob die ID oder der Token falsch ist (Schutz gegen Durchprobieren fremder Overlay-IDs) — es gibt also auch keinen eigenen 404 fuer „falsche ID". Siehe Schritt 1+2.
  • 403 Forbidden — nur relevant, falls du den Single-Element-Embed (/overlay/element) statt der normalen Overlay-URL nutzt und dort der Token ungueltig ist.
  • Connection refused / Lange Ladezeit — DNS/Network. Pruefe nslookup 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. Overlay wird von Connect verwaltet — via OBS-Automation-Builder eingefuegt?

Wenn du die BrowserSource nicht manuell in OBS angelegt hast, sondern eine Chatlix-Action vom Typ create_browser_source sie automatisch erzeugt hat (Automation-Builder), gilt zusaetzlich: Die Source existiert nur, solange Connect online war, als die Action lief. Pruefe in dem Fall zuerst den Connect-Status unter /dashboard/connect — wenn er zum Zeitpunkt der Action offline war, wurde die Source gar nicht erst angelegt (kein Overlay-Problem, sondern ein Connect-Problem). Siehe « Connect-Status: offline ».

9. 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 ». Und falls die Page laedt, aber Sound stumm bleibt, ist das ein eigenstaendiges Thema — siehe « Audio reagiert nicht ».