OBS Studio Verbindung

~5 Min

Was du lernst

• OBS WebSocket-Server aktivieren und konfigurieren
• Streamer.bot mit OBS verbinden (Port + Passwort)

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: docs.streamer.bot/guide/stream-apps/obs-studio

Voraussetzungen

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

Für ältere OBS-Versionen (älter als v28) 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
   • Message: OBS Scene: %currentScene%
4. 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 älter als v28
• 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 OBS-Commands:

Sub-Action	Pfad
Set Active Scene	OBS Studio > Scenes > 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 > Set Recording State
Streaming (Start/Stop)	OBS Studio > Streaming > Set Streaming State
Get Current Scene	OBS Studio > Scenes > Get Current Scene
Get Status	OBS Studio > General > 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

Verwandt

• !brb Scene-WechselErster OBS-Command nach dem Setup.
• Source-Toggle via RewardOBS-Source per Channel-Points ein-/ausblenden.
• InstallationStreamer.bot installieren und Twitch verbinden.

Quellen

• OBS WebSocket Guide
• OBS Studio Download
• Sub-Action Inventar