Makro

Führt mehrere Aktionen nacheinander aus, eine je Zeile, mit Pausen dazwischen. Dient dazu, aus einem Tastendruck eine ganze Abfolge zu machen.

Eigenschaft	Wert
Fach	Werkzeuge
Schlüssel	macro (so heißt das Plugin in Makros)
Bei frischer Installation	an
Befehle	1
Einrichtung	nicht nötig

Wofür

Aus einem Tastendruck eine Abfolge machen: Szene wechseln, Mikrofon einschalten, Musik leiser stellen, im Chat Bescheid sagen. Das ist, wonach ein Makro-Pad benannt ist. „Live gehen“ ist nicht eine Aktion, sondern vier. Ohne Makro bräuchte es vier Tasten.

Das Plugin hat eine Aktion mit einem mehrzeiligen Feld. Die Schreibweise, die Grenzen und Beispiele stehen ausführlich im Kapitel Makros. Hier die Kurzfassung.

Befehle

Befehl	Name im Makro	Felder	Passt auf
Folge von Aktionen	macro.run	steps Eine Aktion je Zeile: plugin.befehl feld=wert · warte 500 * (mehrzeilig)	Taste

* ist ein Pflichtfeld.

Kurzfassung

Eine Zeile ist ein Schritt:

plugin.befehl feld=wert feld=wert
warte 500
# eine Notiz

• plugin.befehl: Schlüssel des Plugins und Name im Makro der Aktion, beide stehen auf jeder Seite der Plugin-Referenz.
• feld=wert: der interne Name des Feldes (steht in der Tabelle Befehle in Code-Schrift vor der Beschriftung). Zahlen bleiben Zahlen. Ein Wert darf Leerzeichen enthalten, bis zum nächsten feld=.
• warte <Millisekunden> macht eine Pause. wait und pause gehen ebenfalls.
• # am Zeilenanfang ist eine Notiz, leere Zeilen werden übersprungen.

Grenzen

Grenze	Wert
Schritte	höchstens 25
eine Pause	höchstens 5 Sekunden
Wartezeit zusammen	höchstens 20 Sekunden
ein Makro in einem Makro	nicht erlaubt: Es könnte sich selbst aufrufen und nie zurückkehren

Beispiel

obs.switch_scene scene=Gaming
warte 500
audio.set_app_volume app=Spotify.exe value=20

Gut zu wissen

• Schlägt ein Schritt fehl, stoppt das Makro, und die Meldung nennt den Schritt: „Schritt 3 (audio.set_app_volume): …“.
• Ein Makro kann jede Aktion jedes aktivierten Plugins ausführen. Ist ein Plugin abgeschaltet, scheitert der Schritt mit dem Hinweis, es im Marktplatz einzuschalten.
• Ein Makro hat nichts zu verbinden: Sein Zustand ist immer bereit.
• Das Plugin ist bei einer frischen Installation an.