OBS Studio
In Macro Deck enthaltenWechsle Szenen, steuere Stream, Aufnahme und Audio und reagiere auf das, was in OBS Studio passiert.
Der Dialog OBS Studio verbinden mit Konfigurationsname, Host, Port und Passwort
- Szenen, Profile und Szenensammlungen wechseln
- Streaming, Aufnahme, Replay-Puffer und virtuelle Kamera starten und stoppen
- Eingänge stummschalten, Lautstärken einstellen, Quellen und Filter schalten
- Live-Variablen für Szenen, Timecodes, FPS und verlorene Frames
- Mehrere OBS-Instanzen gleichzeitig verbinden
Die OBS-Studio-Integration verbindet Macro Deck über den WebSocket-Server, der in OBS eingebaut ist (obs-websocket 5), mit OBS. Ist die Verbindung hergestellt, können deine Tasten fast alles steuern, was du während eines Streams in OBS machst, und OBS meldet zurück, was sich ändert, sodass dein Deck immer den aktuellen Zustand zeigt.
Was du damit machen kannst
- Die Programmszene, die Vorschauszene im Studiomodus, das Profil oder die Szenensammlung wechseln.
- Streaming, Aufnahme, Replay-Puffer und virtuelle Kamera starten, stoppen oder umschalten, eine Wiederholung speichern, eine Aufnahme pausieren, die Aufnahmedatei teilen oder eine Kapitelmarke setzen.
- Eine Quelle in einer Szene ein- oder ausblenden, einen Filter aktivieren oder deaktivieren, einen Eingang stummschalten oder seine Lautstärke in Prozent oder dB ändern.
- Eine Einstellung einer Quelle ändern, zum Beispiel den Text einer Textquelle, die Datei einer Bild- oder Medienquelle oder die URL einer Browserquelle.
- Jede OBS-Ausgabe über ihren Namen starten und stoppen, auch Ausgaben, die Plugins hinzufügen.
Einige Beispiele:
- Eine Taste BRB, die zu deiner BRB-Szene wechselt und dein Mikrofon stummschaltet.
- Eine Taste Aufnahme, die die Aufnahme umschaltet und zeigt, ob OBS aufnimmt, pausiert oder gestoppt ist.
- Ein Schieberegler, der an die Variable
obs_<input>_volumedeines Musikeingangs gebunden ist, sodass das Bewegen des Reglers die Lautstärke in OBS ändert. - Ein Ablauf, der startet, wenn OBS Stream gestartet meldet, und dir eine Benachrichtigung schickt.
So verhält sich die Integration
Macro Deck hört auf die Ereignisse, die OBS sendet, daher aktualisieren sich Variablen wie die aktuelle Szene, Stummschaltungen und Filterzustände Sekundenbruchteile, nachdem du sie in OBS geändert hast. Umschalt-Tasten leuchten, solange ihr Zustand aktiv ist, auch wenn du ihn direkt in OBS änderst. Statistiken wie FPS, CPU-Auslastung, Bitrate und verlorene Frames werden alle ein bis zwei Sekunden gelesen.
Neben den festen Variablen listet die Variablenauswahl jeden Eingang, jede Szene, jedes Szenenobjekt und jeden Filter des verbundenen OBS mit Lautstärke, Stummschaltung, Sichtbarkeit oder Aktivierungszustand. Auslöser reagieren auf Szenenwechsel, Änderungen an Aufnahme und Streaming, gespeicherte Wiederholungen und Screenshots, aktiv werdende Eingänge und benutzerdefinierte Ereignisse, die deine eigenen OBS-Skripte senden.
Du kannst mehr als eine Konfiguration hinzufügen, zum Beispiel eine für deinen Streaming-PC und eine für deinen Gaming-PC. Jede Konfiguration bekommt ihre eigenen Variablen, und jede Aktion hat ein Feld Konfiguration, in dem du wählst, welches OBS sie steuert. Schließt sich OBS oder bricht das Netzwerk ab, versucht Macro Deck weiter, die Verbindung wiederherzustellen, und löst Getrennt und Verbunden aus.
Das brauchst du
- Macro Deck 3 unter Windows, macOS oder Linux
- OBS Studio 28 oder neuer (enthält obs-websocket 5)
- Den in OBS unter Tools > WebSocket Server Settings aktivierten WebSocket-Server
- Zum Starten und Stoppen von Ausgaben über ihren Namen obs-websocket 5.7 oder neuer
So richtest du sie ein
Schritt 1: WebSocket-Server in OBS aktivieren
Öffne in OBS Tools > WebSocket Server Settings und hake Enable WebSocket server an. Notiere den Server Port (standardmäßig
4455). Ist Enable Authentication angehakt, klicke auf Show Connect Info, um das Passwort zu sehen.Schritt 2: OBS Studio in Macro Deck öffnen
Klicke in Macro Deck in der Seitenleiste auf Integrationen und dann auf OBS Studio. Klicke im Tab Übersicht im Abschnitt Konfiguration auf Konfiguration hinzufügen. Der Schalter oben rechts öffnet denselben Dialog, und die Integration ist eingeschaltet, sobald die Einrichtung abgeschlossen ist.
Schritt 3: Verbindungsdaten eingeben
Fülle den Dialog OBS Studio verbinden aus:
- Konfigurationsname: ein Name deiner Wahl, zum Beispiel
Streaming PC. - Host:
127.0.0.1, wenn OBS auf demselben Computer läuft, sonst die IP-Adresse des Computers, auf dem OBS läuft. - Port: der Server-Port aus OBS, standardmäßig
4455. - Passwort: das Passwort aus OBS. Lass es leer, wenn die Authentifizierung ausgeschaltet ist.
Klicke auf Fortfahren. Macro Deck testet die Verbindung, bevor es die Konfiguration speichert.
- Konfigurationsname: ein Name deiner Wahl, zum Beispiel
Schritt 4: OBS-Aktion zu einer Taste hinzufügen
Klicke auf der Seite Deck auf die Taste, die du verwenden willst. Das Deck muss entsperrt sein: Zeigt die Schaltfläche oben rechts Sperren, ist es entsperrt. Der Editor öffnet sich mit ausgewähltem Kurzer Druck. Klicke auf + Aktion hinzufügen, wähle links im Dialog Aktion hinzufügen OBS Studio und nimm eine Aktion wie Szene festlegen. Wähle die Konfiguration und die Szene und klicke dann auf Speichern.
Schritt 5: Taste drücken
Drücke die Taste auf deinem Smartphone, Tablet oder im Web-Client. OBS wechselt zur gewählten Szene. Passiert nichts, prüfe, ob OBS läuft und die Konfiguration auf der Seite OBS Studio unter Integrationen Verbunden zeigt.
Aktionen35
Lege sie auf eine Taste oder führe sie in einem Ablauf aus.
- Szene festlegen
- Wechselt die aktive Programmszene.
- Vorschauszene festlegen
- Wechselt die Vorschauszene im Studiomodus.
- Profil festlegen
- Wechselt OBS zu einem anderen Profil.
- Szenensammlung festlegen
- Wechselt OBS zu einer anderen Szenensammlung.
- Aufnahme starten
- Startet die Aufnahme.
- Aufnahme stoppen
- Stoppt die Aufnahme.
- Aufnahme umschalten
- Startet oder stoppt die Aufnahme und zeigt, ob OBS aufnimmt, pausiert oder gestoppt ist.
- Aufnahme pausieren/fortsetzen
- Pausiert die laufende Aufnahme oder setzt sie fort.
- Stream starten
- Startet den Stream.
- Stream stoppen
- Stoppt den Stream.
- Stream umschalten
- Startet oder stoppt den Stream.
- Virtuelle Kamera starten
- Startet die virtuelle Kamera.
- Virtuelle Kamera stoppen
- Stoppt die virtuelle Kamera.
- Virtuelle Kamera umschalten
- Startet oder stoppt die virtuelle Kamera.
- Replay-Puffer starten
- Startet den Replay-Puffer.
- Replay-Puffer stoppen
- Stoppt den Replay-Puffer.
- Replay-Puffer umschalten
- Startet oder stoppt den Replay-Puffer.
- Replay-Puffer speichern
- Speichert den aktuellen Replay-Puffer auf dem Laufwerk.
- Aufnahmedatei teilen
- Beginnt eine neue Aufnahmedatei, während die Aufnahme weiterläuft.
- Aufnahmekapitel erstellen
- Fügt der gerade aufgenommenen Datei eine Kapitelmarke hinzu (nur im Format Hybrid MP4).
- Aufnahmeordner festlegen
- Legt den Ordner fest, in den OBS neue Aufnahmen schreibt.
- Ausgabe starten
- Startet eine OBS-Ausgabe über ihren Namen, auch Ausgaben, die Plugins hinzufügen.
- Ausgabe stoppen
- Stoppt eine OBS-Ausgabe über ihren Namen, auch Ausgaben, die Plugins hinzufügen.
- Ausgabe umschalten
- Startet oder stoppt eine OBS-Ausgabe über ihren Namen, auch Ausgaben, die Plugins hinzufügen.
- Ausgabestatus abrufen
- Liest in eine Variable, ob eine OBS-Ausgabe aktiv ist.
- Quellensichtbarkeit festlegen
- Blendet eine Quelle in einer Szene ein, aus oder schaltet sie um.
- Eingang stummschalten
- Schaltet einen Audioeingang stumm, hebt die Stummschaltung auf oder schaltet sie um.
- Eingangslautstärke festlegen
- Setzt, erhöht oder verringert die Lautstärke eines Audioeingangs in Prozent oder dB.
- Quellenfilter festlegen
- Aktiviert, deaktiviert oder schaltet einen Filter einer Quelle um.
- Eingangseinstellung festlegen
- Ändert eine Einstellung einer Quelle, zum Beispiel den Text einer Textquelle oder die URL einer Browserquelle.
- Eingangslautstärke abrufen
- Liest den Lautstärke-Prozentwert eines Audioeingangs in eine Variable.
- Filterstatus abrufen
- Liest in eine Variable, ob ein Quellenfilter aktiviert ist.
- Stummschaltung abrufen
- Liest in eine Variable, ob ein Audioeingang stummgeschaltet ist.
- Sichtbarkeit abrufen
- Liest in eine Variable, ob eine Quelle in einer Szene sichtbar ist.
- Studio-Modus umschalten
- Schaltet den Studiomodus ein oder aus.
Auslöser24
Eine Taste oder ein Ablauf kann auf diese Ereignisse reagieren.
- Szene geändert
- Die Programmszene (live) hat sich geändert. Auf Wunsch nur für eine Szene.
- Vorschauszene geändert
- Die Vorschauszene im Studiomodus hat sich geändert.
- Aufnahme gestartet
- OBS hat die Aufnahme gestartet.
- Aufnahme gestoppt
- OBS hat die Aufnahme gestoppt.
- Aufnahme pausiert
- Die Aufnahme wurde pausiert.
- Aufnahme fortgesetzt
- Die Aufnahme wurde fortgesetzt.
- Aufnahmedatei geändert
- Die Aufnahme hat begonnen, ist in eine neue Datei gewechselt oder wurde gestoppt, mit dem Dateipfad.
- Stream gestartet
- OBS hat das Streaming gestartet.
- Stream gestoppt
- OBS hat das Streaming gestoppt.
- Wiederholungspuffer gestartet
- Der Replay-Puffer wurde gestartet.
- Wiederholungspuffer gestoppt
- Der Replay-Puffer wurde gestoppt.
- Wiederholungspuffer gespeichert
- Ein Replay-Clip wurde auf das Laufwerk geschrieben, mit seinem Dateipfad.
- Screenshot gespeichert
- OBS hat einen Screenshot auf dem Laufwerk gespeichert, mit seinem Dateipfad.
- Virtuelle Kamera gestartet
- Die virtuelle Kamera wurde gestartet.
- Virtuelle Kamera gestoppt
- Die virtuelle Kamera wurde gestoppt.
- Studiomodus geändert
- Der Studiomodus wurde ein- oder ausgeschaltet.
- Eingangsstummschaltung geändert
- Ein Audioeingang wurde stummgeschaltet oder wieder laut geschaltet. Auf Wunsch nur für einen Eingang.
- Eingang wurde aktiv
- Ein Eingang wird in der Programmausgabe gerendert, zum Beispiel eine Webcam, die live geht.
- Eingang wurde inaktiv
- Ein Eingang wird nicht mehr in der Programmausgabe gerendert.
- Eingang wird angezeigt
- Ein Eingang wird in der Programm- oder Vorschauausgabe gerendert.
- Eingang wird nicht mehr angezeigt
- Ein Eingang wird weder in der Programm- noch in der Vorschauausgabe gerendert.
- Benutzerdefiniertes Ereignis
- Ein OBS-Skript oder -Plugin hat ein benutzerdefiniertes Ereignis gesendet. Auf Wunsch nur für einen Ereignisnamen.
- Verbunden
- Macro Deck hat sich mit OBS verbunden, und OBS ist fertig geladen.
- Getrennt
- Die Verbindung zu OBS wurde unterbrochen.
Variablen14
Zeige diese Werte auf Tasten und Widgets an oder nutze sie in Bedingungen.
obs_<configuration>_is_connected- Ob Macro Deck mit diesem OBS verbunden ist.
obs_<configuration>_current_scene- Die aktive Programmszene.
obs_<configuration>_preview_scene- Die Vorschauszene im Studiomodus.
obs_<configuration>_current_profile- Das aktive Profil.
obs_<configuration>_current_scene_collection- Die aktive Szenensammlung.
obs_<configuration>_is_recording,obs_<configuration>_recording_paused,obs_<configuration>_recording_timecode- Ob OBS aufnimmt oder pausiert ist und wie lange die Aufnahme läuft.
obs_<configuration>_is_streaming,obs_<configuration>_streaming_timecode- Ob OBS streamt und wie lange.
obs_<configuration>_virtual_camera_active,obs_<configuration>_replay_buffer_active,obs_<configuration>_studio_mode_active- Ob virtuelle Kamera, Replay-Puffer und Studiomodus eingeschaltet sind.
obs_<configuration>_fps,obs_<configuration>_max_fps,obs_<configuration>_cpu_usage- Leistungswerte, die OBS meldet.
obs_<configuration>_streaming_bitrate,obs_<configuration>_recording_bitrate- Die aktuellen Bitraten der Ausgaben in kbit/s.
obs_<configuration>_dropped_frames,obs_<configuration>_dropped_frames_percent,obs_<configuration>_skipped_frames,obs_<configuration>_skipped_frames_percent- Verlorene Frames des Streams und vom Encoder übersprungene Frames, als Anzahl und in Prozent.
obs_<configuration>_last_recording_file,obs_<configuration>_last_screenshot- Der Pfad der neuesten Aufnahmedatei und des neuesten Screenshots.
obs_<input>_volume,obs_<input>_mutedund mehr- Für jeden Eingang, den du auswählst: Lautstärke in dB (beschreibbar, sodass ein Schieberegler sie setzen kann), stummgeschaltet, aktiv, angezeigt, Audiospuren (
obs_<input>_track_1bis_6), Monitoring-Typ, Sync-Versatz und seine Einstellungen. Die Auswahl schlägt diese Namen vor, und du kannst sie ändern. obs_<scene>_<source>_visible,obs_<source>_<filter>_enabled- Ob eine Quelle in einer Szene sichtbar ist und ob ein Filter aktiviert ist. Die Auswahl schlägt diese Namen vor, und du kannst sie ändern.
Häufige Fragen
Funktioniert das, wenn OBS auf einem anderen Computer läuft?
Ja. Gib als Host die IP-Adresse des Computers ein, auf dem OBS läuft, und gib den Port (standardmäßig 4455) in der Firewall dieses Computers frei. Pfade in Aktionen wie Aufnahmeordner festlegen oder Eingangseinstellung festlegen sind Pfade auf dem Computer, auf dem OBS läuft.
Kann ich mehr als ein OBS steuern?
Ja. Füge mit Konfiguration hinzufügen eine Konfiguration pro OBS-Instanz hinzu. Jede hat ihre eigenen Variablen, und jede Aktion hat ein Feld Konfiguration, in dem du das OBS wählst, das sie steuert.
Was passiert, wenn OBS geschlossen wird oder die Verbindung abbricht?
Macro Deck versucht im Hintergrund weiter, die Verbindung wiederherzustellen, und verbindet sich erneut, sobald OBS wieder da ist. Bis dahin schlagen Aktionen mit OBS ist nicht verbunden. fehl, und die Auslöser Getrennt und Verbunden lösen aus, sodass ein Ablauf reagieren kann.
Warum schlägt eine Aktion fehl?
Die Aktion zeigt den Grund an, zum Beispiel dass eine Szene oder Quelle nicht mehr existiert, dass OBS noch eine Szenensammlung lädt oder dass OBS nicht aufnimmt (bei Aufnahmedatei teilen und Aufnahmekapitel erstellen). Hast du in OBS etwas umbenannt, wähle es in der Aktion erneut aus.
Wo wird das WebSocket-Passwort gespeichert?
Macro Deck speichert das Passwort verschlüsselt auf dem Computer, auf dem Macro Deck läuft, und verwendet es nur, um sich mit OBS zu verbinden.
Mehr in „Streaming“
Meld Studio
In Macro Deck enthaltenWechsle und bereite Szenen vor, steuere Ebenen, Effekte und Audiospuren und geh in Meld Studio live.
Streamlabs Desktop
In Macro Deck enthaltenWechsle Szenen und steuere Stream, Aufnahme und Audioquellen in Streamlabs Desktop.
Streamer.bot
In Macro Deck enthaltenFühre Streamer.bot-Aktionen aus, sende Chatnachrichten und reagiere auf jedes Ereignis, das Streamer.bot meldet.
Twitch
In Macro Deck enthaltenZeige deinen Twitch-Chat und deine Stream-Statistiken, moderiere, starte Umfragen und Werbung und reagiere auf Follows, Subs und Raids.
YouTube
In Macro Deck enthaltenZeige deinen YouTube-Livechat und deine Stream-Statistiken, ändere Titel und Tags und reagiere auf Super Chats und Mitglieder.