OBS Studio

Steuert OBS Studio über obs-websocket: Szenen wechseln, Aufnahme und Stream starten, Quellen ein- und ausblenden.

Eigenschaft	Wert
Fach	Streaming & Chat
Schlüssel	obs (so heißt das Plugin in Makros)
Bei frischer Installation	aus (im Marktplatz einschalten)
Befehle	10
Einrichtung	3 Felder

Wofür

OBS Studio per Taste steuern: Szenen wechseln, Aufnahme und Stream starten und beenden, Quellen ein- und ausblenden, das Mikrofon stumm schalten, den Replay-Puffer speichern. Die Kacheln für Aufnahme und Stream leuchten, solange aufgenommen oder gesendet wird.

Das Plugin spricht mit OBS über obs-websocket (Fassung 5). Die ist ab OBS Studio 28 fest eingebaut.

Einrichten

Zuerst in OBS:

1. Öffne in OBS das Menü Werkzeuge (englisch Tools) und den Eintrag WebSocket Server Settings.
2. Schalte Enable WebSocket server ein.
3. Notiere den Server Port (Vorgabe 4455) und vergib unter Enable Authentication ein Passwort.

Dann in der Software: Plugins → OBS Studio → Aktivieren → Einrichten, Speichern.

Feld	Hinweis
Host	Beispiel: localhost
Port	Beispiel: 4455
Passwort	geheim: wird nach dem Speichern nie wieder angezeigt

• Host: localhost, wenn OBS auf demselben PC läuft. Läuft OBS auf einem anderen Rechner (etwa ein zweiter Stream-PC), trägst du dessen Adresse ein. Dann muss der Port dort erreichbar sein.
• Port: der Port aus OBS, normalerweise 4455.
• Passwort: das Passwort aus OBS. Es wird nach dem Speichern nie wieder angezeigt.

Sobald OBS läuft und die Angaben stimmen, steht der Zustand auf verbunden. Ohne laufendes OBS steht er auf getrennt. Das Plugin versucht es dann immer wieder (zuerst jede Sekunde, später im Abstand von bis zu 30 Sekunden), sodass du OBS einfach später starten kannst.

Befehle

Befehl	Name im Makro	Felder	Passt auf
Szene wechseln	obs.switch_scene	scene Szenenname *	Taste
Aufnahme umschalten	obs.toggle_record	—	Taste; die Kachel zeigt den Zustand
Stream umschalten	obs.toggle_stream	—	Taste; die Kachel zeigt den Zustand
Mikro stumm/laut	obs.toggle_mute	input Audioquelle *	Taste
Virtuelle Kamera umschalten	obs.toggle_virtual_cam	—	Taste
Replay-Puffer umschalten	obs.toggle_replay_buffer	—	Taste
Replay speichern	obs.save_replay	—	Taste
Studio-Modus umschalten	obs.toggle_studio_mode	—	Taste
Quelle ein-/ausblenden	obs.set_scene_item	scene Szene * source Quelle * visible Sichtbar (true/false)	Taste
Mikro stumm setzen	obs.set_mute	input Audioquelle * muted Stumm (true/false) *	Taste

* ist ein Pflichtfeld.

• Szene wechseln: Der Szenenname muss genau so geschrieben sein wie in OBS.

• Aufnahme umschalten, Stream umschalten: starten oder beenden. Die Kachel leuchtet, solange das läuft.

• Mikro stumm/laut und Mikro stumm setzen: Bei Audioquelle steht der Name der Quelle in OBS, zum Beispiel „Mic/Aux“. Das Umschalten wechselt zwischen stumm und laut, Mikro stumm setzen setzt ausdrücklich: Stumm ist true (stumm) oder false (laut).

  Bekannte Einschränkung in Version 0.9.5: Bei Mikro stumm setzen wird jeder eingetragene Text als „stumm“ gewertet, auch false. Zum Einschalten des Tons nimm Mikro stumm/laut (umschalten). Bei Quelle ein-/ausblenden gilt das Feld Sichtbar dagegen richtig (true/false, auch ja/nein, an/aus, 1/0).

• Quelle ein-/ausblenden: Szene und Quelle nennen, wo die Quelle liegt. Sichtbar ist true oder false. Leer schaltet um (an wird aus und umgekehrt).

• Virtuelle Kamera, Replay-Puffer und Studio-Modus umschalten schalten die jeweilige Funktion um. Replay speichern schreibt den Puffer in eine Datei. Der Replay-Puffer muss in OBS eingeschaltet sein (Einstellungen → Ausgabe → Replay-Puffer).

Zustand auf der Kachel

Stream und Aufnahme melden ihren Zustand, daran leuchten die beiden Kacheln. Das gilt nur bei bestehender Verbindung: Was OBS tut, wenn niemand hinsieht, weiß das Plugin nicht. Eine dunkle Kachel ist ehrlicher als eine, die den Stand von vorhin behauptet. Nach einem Wiederverbinden liest das Plugin alles neu.

Für das Stummschalten einer Quelle gibt es keinen Zustand: Der Schlüssel hängt am Befehl, nicht an seinen Feldern, und ein einziges „stumm“ wäre die Auskunft über irgendeine Quelle, die Kachel meint aber genau eine.

Beispiele

obs.switch_scene scene=Gaming
obs.toggle_record
obs.set_scene_item scene=Gaming source=Kamera visible=true

Mehr unter Rezepte.

Gut zu wissen

• Das Plugin ist bei einer frischen Installation aus: Schalte es unter Plugins ein.
• „OBS is not connected“ heißt: Es besteht keine Verbindung. Prüfe, ob OBS läuft, ob der WebSocket-Server eingeschaltet ist und ob Host, Port und Passwort stimmen.
• Eine Quelle wird in OBS über eine Nummer innerhalb der Szene angesprochen. Die kann niemand tippen, deshalb schlägt das Plugin sie anhand der Namen selbst nach.