OBS Overlays
Overlays sind Browser-URLs für OBS. Bei KALYIX Tipp rendert das Overlay aktuell Alerts. Goals als eigene Overlay-Ausgabe sind geplant, aber nicht Teil des aktuellen Overlay-Verhaltens.
Alert Overlay
Das Alert Overlay ist im Normalzustand leer. Es zeigt nur dann Inhalt, wenn ein Alert aus der Queue aktiv ist.
Details zur Einrichtung in OBS stehen im OBS Setup.
URL Format
Die URL muss immer vollständig angezeigt und kopiert werden:
https://deine-domain.example/overlay/<secret>Nur /overlay/<secret> reicht für OBS nicht, weil OBS keinen Domain-Kontext kennt.
Wie Es Arbeitet
| Schritt | Verhalten |
|---|---|
| Queue leer | Die Overlay-Seite bleibt sichtbar leer. |
| Alert wird getriggert | Test Send oder ein echtes Payment legt einen Alert Job in die Queue. |
| Overlay bekommt Änderung | Die Browser Source bekommt ein Queue-Update und holt den nächsten Alert. |
| Alert aktiv | Das gespeicherte Alert Template wird mit Tokens, Positionen, Styles und Animationen gerendert. |
| Duration läuft ab | Nach der Template-Duration wird der Alert bestätigt und aus der aktiven Anzeige entfernt. |
| Cooldown vorbei | Der nächste Queue-Eintrag kann starten. |
Sicherheit
Overlay URLs enthalten einen geheimen Token. Wer die URL kennt, kann die Alert-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 Alert-Ausgabe kontrolliert. |
| Bei Verdacht Token rotieren | Danach ist die alte Overlay 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
Die Overlay-Seite ist absichtlich leer, wenn kein Alert aktiv ist. Das ist korrekt: OBS soll keinen Default-Inhalt anzeigen, sondern nur echte Alert-Ausgaben.