OBS mit Chatlix verbinden
Es gibt zwei Wege, OBS und Chatlix zu verheiraten. Du musst dich nicht entscheiden, die meisten Streamer nutzen beide gleichzeitig.
Weg 1: Browser-Source (immer noetig fuer Overlays)
Du bindest dein Chatlix-Overlay als Browser-Source in OBS ein. Damit wird das Overlay gerendert und ueber dein Bild gelegt. Dieser Weg funktioniert komplett ohne Chatlix Connect.
- Dashboard, Overlays, Overlay auswaehlen (Seite
OverlayLibrary/Overlays). - URL im Format
https://chatlix.app/overlay/view.php?token=...kopieren. - In OBS bei der Zielszene auf das Plus unter Quellen.
- „Browser" waehlen (in aelteren OBS-Versionen „Browser-Quelle").
- URL einsetzen.
- Breite und Hoehe auf Canvas-Aufloesung setzen (z. B. 1920x1080).
- OK.
Die Browser-Source rendert das Overlay live. Aenderungen im Dashboard greifen in der Regel sofort — Details und Fehlerbilder dazu stehen in Overlay in OBS einfuegen.
Weg 2: OBS-WebSocket plus Chatlix Connect (fuer Steuerung)
Wenn du Szenen, Quellen oder Audio aus Chatlix heraus steuern willst, brauchst du OBS-WebSocket (in OBS ab Version 28 fest eingebaut) und die Chatlix Connect Desktop-Bridge. Connect laeuft lokal auf deinem Streaming-Rechner, spricht dort mit OBS per WebSocket und meldet sich per Redis/WS-Pubsub an deinem Chatlix-Account an. Chatlix selbst hat also nie eine direkte Verbindung zu deinem OBS — alle Befehle gehen ueber Connect als Vermittler.
Schritt fuer Schritt
Die Befehle laufen technisch so: Dashboard/Automation → Backend-Route (z. B. /v1/producer/obs/actions fuer das Producer-Pult) → einen internen Kanal → Chatlix Connect auf deinem PC → obs-websocket-Aufruf an OBS. Die Antwort geht denselben Weg zurueck (Redis BLPOP auf einen Reply-Key), das Dashboard wartet also auf ein echtes „hat geklappt", nicht nur auf ein Fire-and-forget.
Bewiesene Actions
Folgende Steuerbefehle sind Ende-zu-Ende gegen echtes OBS verifiziert:
obs_switch_scene— Programm-Szene wechselnobs_set_source_visibility— einzelne Quelle in einer Szene ein-/ausblendenobs_set_scene_item_transform— Position und Skalierung einer Quelle setzen (kein Crop, keine Rotation, keine Filter)obs_create_browser_source— neue Browser-Source in einer Szene anlegen (Producer-Pult)
Daneben existieren im Standard-Aktionskatalog (ObsControl::ACTION_VERBS) unter anderem Start/Stop von Stream und Aufnahme, Mute/Unmute, Lautstaerke, Media-Play/Restart, Text setzen, Hotkey ausloesen und Transition setzen — siehe Szenen aus Chatlix steuern fuer die Automation-Variante.
Was geht ohne Connect
- Overlays anzeigen
- Reaktionen auf Twitch-Events darstellen
- StoryQuest-Steps im Overlay
Was zusaetzlich geht mit Connect
- Szenen aus dem Dashboard und aus Automations wechseln
- Quellen ein- und ausblenden, Position/Skalierung setzen
- Audio mute/unmute und Lautstaerke
- Stream/Aufnahme starten und stoppen
- Reaktionen, die Szenen umschalten
Empfohlene OBS-Einstellungen
| Bereich | Empfehlung |
|---|---|
| OBS-Version | 28 oder neuer (obs-websocket v5 ist dann eingebaut, kein Plugin noetig) |
| WebSocket-Port | 4455 (Standard, im Server-Einstellungsdialog aenderbar) |
| Aufloesung Canvas | 1920x1080 |
| FPS | 60, wenn deine Hardware mitkommt |
| Browser-Quelle Cache | aktiv lassen, vereinfacht das Reloaden |
| Browser-Quelle Hardware | aktiv, fuer fluessigere Animationen |
Sicherheits-Hinweise
- Overlay-Token nie oeffentlich teilen (Stream, Discord, Tweets).
- OBS-WebSocket immer mit Passwort betreiben — Chatlix Connect verlangt es ohnehin fuer eine stabile Verbindung.
- Passwoerter landen bei Chatlix verschluesselt in der Datenbank und werden nie im Klartext geloggt (auch im Aktions-Log werden
password/secret/token-Felder vor dem Schreiben entfernt). - Wenn du auf Tour bist und an fremden Rechnern arbeitest: dort kein Connect installieren, lieber Browser-Source-Workflow.
Troubleshooting: Verbindung klappt nicht
| Symptom | Wahrscheinliche Ursache | Loesung |
|---|---|---|
| Dashboard zeigt „Connect nicht verbunden" | Connect-App laeuft nicht oder Pairing abgelaufen | Connect starten, ggf. neu koppeln — siehe Connect Troubleshooting |
Connect online, aber „OBS offline" / connect_offline | WebSocket-Server in OBS nicht aktiviert oder OBS zu, seit Connect gestartet wurde | OBS starten bzw. Werkzeuge → WebSocket-Server-Einstellungen pruefen, Connect neu verbinden lassen |
Fehler rpc_timeout | OBS antwortet nicht innerhalb 5-15 Sekunden (haengender Encoder, sehr grosse Szene mit vielen Quellen) | OBS-Performance pruefen, Aktion erneut ausloesen; bei Screenshot/Start-Stream ist ein laengeres Timeout normal (bis 15s) |
Fehler connect_no_subscriber | Connect war im Redis als „online" markiert, ist aber gerade in dem Moment weggebrochen (Reconnect, Absturz) | Kurz warten, Connect meldet sich automatisch neu; falls dauerhaft: Connect-Prozess neu starten |
Fehler obs_rate_limited | Zu viele Befehle derselben Gruppe in kurzer Zeit (z. B. Automation-Sturm mit vielen Szenenwechseln) | Automation entschaerfen/entprellen; Limits siehe Tabelle unten |
| Verbindungstest schlaegt fehl, Port erreichbar | Falsches Passwort oder Authentifizierung in OBS deaktiviert | Passwort in OBS und in Connect/Dashboard exakt gleich setzen |
| Connect findet OBS nicht automatisch | OBS laeuft auf anderem Host/Port, oder bindet nur an IPv6 | Host/Port manuell im Connect-Setup eintragen; Connect probiert automatisch 127.0.0.1, localhost und ::1 auf Port 4455 und 4444 |
| Alter obs-websocket-Plugin (v4, Port 4444) | OBS-Version < 28 mit separat installiertem Plugin | OBS auf 28+ aktualisieren — Connect unterstuetzt nur das v5-Protokoll (Port 4455), nicht das alte v4-Plugin (Port 4444) |
Rate-Limits pro Aktionsgruppe (Schutz vor OBS-Absturz)
| Gruppe | Aktionen | Limit |
|---|---|---|
| stream_control | Stream/Aufnahme start/stop | 6 pro Minute |
| scene_change | Szene wechseln, Quelle ein/aus, Scene-Item togglen | 60 pro Minute |
| audio | Mute/Unmute, Lautstaerke | 120 pro Minute |
| media | Media Play/Restart | 60 pro Minute |
| text | Text setzen | 120 pro Minute |
| hotkey | Hotkey ausloesen | 30 pro Minute |
Diese Limits schuetzen deine OBS-Instanz vor einer durchdrehenden Automation oder Timeline (bekanntes Problem bei anderen Bots, die OBS mit zu vielen Requests in kurzer Zeit lahmlegen). Wird ein Limit erreicht, kommt obs_rate_limited mit einer retry_after_ms-Angabe zurueck — die Aktion ist nicht verloren, du musst nur kurz warten.
OBS-Doctor: eingebaute Diagnose
Im Dashboard unter OBS-Doctor (Route /obs-doctor) laeuft eine automatische Check-Batterie: OBS-Verbindung konfiguriert, WebSocket erreichbar, aktuelle Szene lesbar, Browser-Source im Snapshot vorhanden, Overlay-URL gueltig, Browser-Source sichtbar, Overlay-WS verbunden, letzter Alert empfangen, empfohlene Aufloesung, Connect-App online, Snapshot-Frische. Jeder Check liefert „ok", „warning", „error" oder „unknown" (nie ein gefaktes Gruen ohne Daten) — nutze den Doctor als ersten Anlaufpunkt, bevor du manuell suchst.
Sanity-Check
Kurzer End-to-End-Test:
- Im Dashboard ein Test-Alert ausloesen.
- In OBS sollte das Overlay den Alert zeigen.
- Falls Connect aktiv: testweise unter OBS-Steuerung eine Szene umschalten und pruefen, ob OBS sofort reagiert.
- Bei Zweifeln: OBS-Doctor aufrufen und die Checkliste durchgehen.
Wenn alles klappt, ist die Anbindung sauber. Fuer Szenensteuerung im Detail geht es weiter mit Szenen aus Chatlix steuern.