Szenen aus Chatlix steuern
Wenn Chatlix Connect mit OBS gekoppelt ist, kannst du Szenen aus dem Dashboard und aus Automations heraus steuern. Grundlagen zum Verbinden stehen in OBS mit Chatlix verbinden. Drei Wege gibt es.
Voraussetzung
- OBS laeuft mit aktivem WebSocket-Server (Werkzeuge → WebSocket-Server-Einstellungen, Standardport 4455)
- Chatlix Connect ist installiert, gepaart und online — siehe Erstes Pairing
- Im Dashboard unter OBS-Steuerung (Route
/obs-control) tauchen deine Szenen auf, sobald der erste Snapshot von Connect eingetroffen ist
Die Seite unterscheidet intern zwischen „live" (Connect online, frischer Snapshot), „veraltet" (Snapshot aelter als 30 Sekunden — es erscheint ein deutlicher Hinweis, weil die angezeigten Szenen/Zustaende dann nicht mehr verlaesslich sind) und „Connect offline" (Fallback auf eine frueher gespeicherte Direct-Verbindung, falls vorhanden, sonst Einrichtungs-Hinweis).
Weg 1: Manuell aus dem Dashboard
- Dashboard, OBS-Steuerung (Seite , Route
/obs-control). - In der Szenenliste die Zielszene anklicken.
- Auf den Wechseln-Button klicken.
Der Wechsel ist danach in OBS sofort sichtbar. Chatlix selbst setzt aktuell direkt die Programm-Szene (obs_switch_scene → SetCurrentProgramScene); ein separates „nur Vorschau schalten" fuer OBS-Studio-Mode gibt es im Dashboard nicht — falls du Studio-Mode nutzt, beachte den Abschnitt weiter unten.
Weg 2: Aus einer Automation
Automations koennen Szenen ausloesen, etwa bei einem Raid die „BRB"-Szene zeigen.
- Dashboard, Automations (Seite /).
- Neue Automation, Trigger waehlen (z. B. Raid empfangen).
- Aktion hinzufuegen, Typ „OBS: Szene wechseln" (intern
obs_switch_scene). - OBS-Verbindung/Connect auswaehlen, Szene aus der geladenen Liste waehlen.
- Speichern und aktivieren.
Weitere OBS-Aktionstypen, die im selben Automation-Baukasten stehen: obs_set_source_visibility („Source ein/aus"), obs_mute_source/obs_unmute_source, obs_set_volume. Eine reine Verzoegerungs-Aktion vor/zwischen Schritten gibt es im Automation-Editor separat als eigenen Aktionstyp — im aktuellen Editor ist keine dedizierte „Verzoegerung in Sekunden am Szene-Wechsel-Schritt" eingebaut; nutze stattdessen einen eigenen Verzoegerungs-Schritt zwischen zwei Aktionen, falls dein Ablauf getimt sein muss.
Weg 3: Per Producer-Pult / externem Trigger
Fuer Stream-Deck- oder Skript-Steuerung ohne Login gibt es das Producer-Pult: eine Token-authentifizierte HTTP-Route POST /v1/producer/obs/actions (Middleware producer_token, kein normaler Session-Login). Sie akzeptiert unter anderem switch_scene, set_source_visibility, set_source_transform (Position/Skalierung) und create_browser_source. Diese Route ist fuer eigene Skripte/Stream-Deck-Plugins gedacht, nicht fuer die normale Dashboard-Bedienung — den Producer-Token findest du im Dashboard beim jeweiligen Producer-Setup. Ein direkter „Trigger per Dashboard-Hotkey" fuer Szenenwechsel existiert aktuell nicht als eigenes Feature; nutze dafuer Automations (Weg 2) oder das Producer-Pult.
Studio-Mode beachten
OBS-Studio-Mode wird von Chatlix aktuell nicht separat behandelt: obs_switch_scene setzt immer direkt die Programm-Szene, unabhaengig davon, ob du in OBS Studio-Mode aktiviert hast. Wenn du Studio-Mode nutzt und erst in die Vorschau schalten willst, musst du das manuell in OBS machen — ein Chatlix-Klick geht am Vorschau-Schritt vorbei direkt auf Sendung. Plane das ein, bevor du eine Automation mit Szenenwechsel live schaltest.
Transitions
Die aktuell in OBS eingestellte Transition wird bei einem Szenenwechsel automatisch verwendet. Willst du fuer eine bestimmte Aktion eine andere Transition, gibt es den eigenen Aktionstyp „OBS: Transition setzen" (obs_set_transition → SetCurrentSceneTransition). Wichtig: Das setzt nur die aktive Transition fuer den naechsten Szenenwechsel, nicht fuer den, der gerade laeuft — feuere die Transition-Aktion also vor dem Szenenwechsel, nicht danach.
Mehrere OBS-Instanzen
Ein Chatlix-Account ist an genau eine Connect-Bridge pro OBS-Verbindung gekoppelt; die aktuelle Architektur geht von einer Connect-Instanz pro Nutzer aus. Wenn du mehrere Rechner mit OBS betreibst, lege dafuer separate Direct-Verbindungen an (Legacy-Modus, direkte OBS-TCP-Verbindung ohne Connect) oder nutze pro Rechner einen eigenen Chatlix-Nutzer/Team-Zugang. Ein eingebauter Geraete-Umschalter fuer „mehrere Connect-Instanzen gleichzeitig online" existiert im Dashboard nicht.
Limits und Stolperfallen
| Stolperfalle | Erkennung | Loesung |
|---|---|---|
| Szene umbenannt | Dashboard zeigt sie nicht mehr / Automation feuert ins Leere | Neuen Snapshot abwarten (Connect pusht alle ~10s) oder im Dashboard „Erweitert laden"/Refresh anstossen; Automation-Aktion neu auswaehlen |
| Szene fehlt komplett | Automation-Fehler, Szenenliste leer | Szene in OBS anlegen oder Automation anpassen |
| Studio-Mode aktiv, Wechsel geht „zu frueh" auf Sendung | Programm springt sofort um, keine Vorschau-Stufe | Bewusst einplanen — Chatlix schaltet immer das Programm, siehe oben |
| Mehrere schnelle Wechsel hintereinander | Fehler obs_rate_limited, Transitions ueberlappen sichtbar | Automation entprellen; Szenenwechsel liegen im Limit „scene_change" (60/min) |
| Snapshot „VERALTET" | Banner im OBS-Steuerung-Panel, aelter als 30s | Connect-Prozess pruefen — pusht normalerweise alle 10 Sekunden; laeuft er nicht mehr, Connect neu starten |
Fehler connect_offline beim Szenenwechsel | Dashboard/Automation meldet Fehler statt Erfolg | Connect-App auf dem Streaming-PC pruefen, siehe Connect Troubleshooting |
Test
Leg dir eine Test-Automation an, die mit einem Trigger (oder testweise manuell im Dashboard unter OBS-Steuerung) zwischen zwei Szenen hin und her schaltet. Damit kannst du in unter einer Minute pruefen, ob die Anbindung produktionsreif ist. Wenn dabei etwas nicht sofort in OBS ankommt, wirf zuerst einen Blick auf OBS-Doctor (Route /obs-doctor) — dort siehst du auf einen Blick, ob Connect online ist, ob der Snapshot frisch ist und ob die Browser-Source ueberhaupt sichtbar ist.