OBS Overlays

Overlays sind Browser-URLs für OBS. In KALYIX Tip gibt es zwei Arten:

Typ	Verhalten
Alert Overlay	Kurzlebige Alerts aus der Alert Queue. Leer, solange kein Alert aktiv ist.
Public Overlay	Dauerhafte Overlays wie Goal Bar, Text, HTML, Medien oder Tip-Listen. Leer, wenn das Overlay deaktiviert ist.

Alert Overlay

Das Alert Overlay zeigt nur dann Inhalt, wenn ein Alert aus der Queue aktiv ist.

Zustand	Verhalten
Queue leer	Die Browser Source bleibt sichtbar leer.
Alert wird getriggert	Test Send oder ein echtes Payment legt einen Alert Job in die Queue.
Alert aktiv	Das gespeicherte Alert Template wird mit Tokens, Positionen, Styles und Animationen gerendert.
Duration läuft ab	Der Alert wird bestätigt und verschwindet wieder.

Details stehen unter Alerts, Alert Editor und OBS Setup.

Public Overlay

Public Overlays werden im Public Overlay Editor gebaut. Sie sind für dauerhafte OBS-Flächen gedacht.

Beispiel	Typischer Einsatz
Goal Bar	Support-Ziel dauerhaft im Stream anzeigen.
Latest Tippers	Liste der letzten Unterstützer aus bezahlten Tipps.
Text/HTML	Eigene Info-Boxen, Stream-Hinweise oder animierte Blöcke.
Media	Bild oder Grafik als Overlay-Element.
Laufband	Laufender Text mit statischen Inhalten oder Tokens.

Ein Public Overlay hat eine eigene öffentliche URL. Nur aktive Overlays zeigen Inhalt. Wenn ein Overlay deaktiviert ist, bleibt die URL für OBS leer.

Aktuell werden Creator-, Goal-, Latest-Tippers- und Top-Tipper-Werte beim Speichern automatisch aus deinen Tip-Daten gefüllt. Stream-Message-Daten bleiben leer, bis eine Stream-Quelle angebunden ist.

URL Formate

Alert Overlay:

https://deine-domain.example/a/<secret>

Public Overlay:

https://deine-domain.example/overlay/widget/<secret>

Die URL muss in OBS immer vollständig kopiert werden. Nur /a/... oder /overlay/... reicht nicht, weil OBS keinen Domain-Kontext kennt.

Sicherheit

Overlay URLs enthalten einen geheimen Token. Wer die URL kennt, kann die Ausgabe öffnen.

Regel	Warum
URL nicht öffentlich teilen	Der Token ist der Zugriff auf dein Overlay.
Nur in OBS oder eigenen Testfenstern nutzen	So bleibt die Ausgabe kontrolliert.
Bei Verdacht Token rotieren	Danach ist die alte URL ungültig und OBS muss die neue URL bekommen.
Keine Screenshots mit sichtbarer URL posten	Der Token kann aus dem Screenshot kopiert werden.

Wichtig Für OBS

Leere Ausgabe ist bei Overlays kein Fehler:

Fall	Warum leer korrekt ist
Alert Queue leer	Es gibt gerade keinen Alert zum Anzeigen.
Public Overlay deaktiviert	Deaktivierte Overlays zeigen keinen Inhalt.
Noch nicht gespeichert	Das Overlay wurde noch nicht gespeichert oder veröffentlicht.