Zum Inhalt

OBS Studio Verbindung

Bevor OBS-Sub-Actions funktionieren, muss Streamer.bot mit OBS via WebSocket verbunden sein. Einmaliger Setup, danach läuft alles automatisch beim Streamer.bot-Start.

Doku: https://docs.streamer.bot/guide/stream-apps/obs-studio

Voraussetzungen

Komponente Version Wo
OBS Studio v28.0+ (mit eingebautem WebSocket v5) https://obsproject.com
Streamer.bot v1.0.4+ bereits installiert

Für ältere OBS-Versionen (<28) brauchst du das obs-websocket-4.9.1-compat Plugin separat. Empfehlung: einfach OBS auf v28+ aktualisieren.

OBS-WebSocket aktivieren

In OBS:

  1. Tools → WebSocket Server Settings
  2. Häkchen Enable WebSocket server
  3. Server Port: 4455 (Default)
  4. Enable Authentication: Empfehlung JA (auch lokal)
  5. Server Password: Notier dir das Passwort, brauchst du in SB
  6. Apply klicken

Verbindung in Streamer.bot anlegen

  1. Im Streamer.bot UI links auf Tab Stream Apps
  2. Sub-Tab OBS wählen
  3. Rechtsklick im OBS-Pane → Add Connection

Felder ausfüllen:

Feld Wert
Name Local OBS (oder wie du willst)
Version WebSocket v5 (für OBS 28+)
Host 127.0.0.1 (lokales OBS)
Port 4455
Password (das OBS-Passwort von oben)
Auto Connect aktiv
Reconnect aktiv

Save. Streamer.bot verbindet sich sofort. Im Status-Pane unten siehst du den OBS-Status:

  • ✅ Connected — alles gut, alle OBS Sub-Actions funktionieren
  • ❌ Disconnected — Port/Passwort prüfen

Verbindung testen

Erste Action zum Testen:

  1. Neue Action [Test] OBS Connection
  2. Sub-Action: OBS Studio → Get Current Scene
  3. Sub-Action: Twitch → Chat → Send Message to Channel
  4. Message: OBS Scene: %currentScene%
  5. Action Test Trigger

Wenn du die aktuelle Scene-Name in deinem Chat siehst — funktioniert.

Connection-Auswahl in Sub-Actions

Bei jeder OBS Sub-Action gibt's das Feld Connection:

Wert Bedeutung
Default Die erste/einzige Connection (üblich)
Any Alle konfigurierten Connections (wenn du mehrere OBS-Instanzen hast)
<Name> Spezifische Connection beim Namen

Für 99% der Setups: Default.

Multi-PC-Setup (Streaming-PC + Gaming-PC)

Wenn OBS auf einem anderen PC läuft als Streamer.bot:

  1. Im OBS-PC: WebSocket-Server aktivieren wie oben
  2. In SB-PC die Connection mit Host = 192.168.x.x (LAN-IP des OBS-PCs) konfigurieren
  3. Firewall auf OBS-PC öffnen: TCP 4455 von SB-PC zulassen

Häufige Fallen

  • Wrong version selected — OBS 28+ braucht WebSocket v5. v4.9 nur bei OBS <28
  • Firewall blockt 4455 — Lokale Verbindung ist meist OK, aber Multi-PC braucht Firewall-Regel
  • OBS Studio "Portable Mode" mit mehreren Instanzen — jede braucht eigenen Port (4455, 4456, ...)
  • Passwort falsch — Server-Settings in OBS und Connection in SB müssen exakt matchen
  • OBS startet nach SB — Auto-Connect + Reconnect aktiv lassen, dann verbindet SB sobald OBS verfügbar ist

Sub-Action-Pfade (Übersicht)

Häufig genutzt in den Commands unten:

Sub-Action Pfad
Set Active Scene OBS Studio → Set Active Scene
Set Source Visibility State OBS Studio → Sources → Set Source Visibility State
Set Replay Buffer State OBS Studio → Replay → Set Replay Buffer State
Take Screenshot OBS Studio → Take Screenshot
Recording (Start/Stop) OBS Studio → Recording
Streaming (Start/Stop) OBS Studio → Streaming
Get Current Scene OBS Studio → Get Current Scene
Get Status OBS Studio → Get Status
Set Browser Source URL OBS Studio → Sources → Set Browser Source URL
Set GDI Text OBS Studio → Sources → Set GDI Text
Set Media Source File OBS Studio → Sources → Set Media Source File
Set Source Mute State OBS Studio → Sources → Set Source Mute State
Set Source Filter State OBS Studio → Sources → Set Source Filter State

Quellen