Makros

Ein Makro macht aus einem Tastendruck eine ganze Abfolge: Szene wechseln, Mikrofon einschalten, Musik leiser stellen, im Chat Bescheid sagen. Ohne Makro bräuchte „live gehen“ vier Tasten.

Das Makro ist ein Plugin: Makro. Es hat genau eine Aktion, Folge von Aktionen, mit einem mehrzeiligen Feld.

So legst du ein Makro an

1. Ziehe aus der Plugin-Leiste die Aktion Folge von Aktionen (Plugin Makro) auf eine Taste oder Kachel.
2. Im Dialog steht ein großes Textfeld. Schreibe dort eine Aktion pro Zeile.
3. Speichern.

Eine Zeile ist ein Schritt

plugin.befehl feld=wert feld=wert

• plugin ist der Schlüssel des Plugins, befehl der Name im Makro der Aktion. Beide stehen in der Plugin-Referenz auf der Seite des Plugins, in der Spalte Name im Makro (zum Beispiel obs.switch_scene).
• Danach folgen die Felder der Aktion als feld=wert. Geschrieben wird der interne Name des Feldes, nicht die Beschriftung aus dem Dialog (siehe unten).
• Zahlen bleiben Zahlen. value=20 kommt als 20 an, nicht als Text „20“.
• Ein Wert darf Leerzeichen enthalten, bis zum nächsten feld=: label=Kamera 2.

Für eine Pause schreibst du warte und die Zeit in Millisekunden:

warte 500

(wait und pause gehen auch.) Eine Zeile, die mit # beginnt, ist eine Notiz. Leere Zeilen werden übersprungen.

Ein Beispiel

# Gleich geht's los
obs.switch_scene scene=Gaming
warte 500
audio.set_app_volume app=Spotify.exe value=20
discord.send_message message=Ich bin live!

1. Wechselt in OBS zur Szene „Gaming“.
2. Wartet eine halbe Sekunde.
3. Stellt Spotify auf 20 Prozent.
4. Schreibt „Ich bin live!“ in den Discord-Kanal (die Webhook-URL steht in den Einstellungen des Discord-Plugins).

Die Namen der Felder

In der Oberfläche stehen bei jeder Aktion verständliche Beschriftungen („Szenenname“). Das Makro braucht dagegen den internen Namen des Feldes („scene“). Auf den Seiten der Plugin-Referenz steht er in der Tabelle Befehle in der Spalte Felder, in Code-Schrift vor der Beschriftung:

scene Szenenname *

Daraus wird im Makro obs.switch_scene scene=Gaming. Ein Stern heißt Pflichtfeld. Felder ohne Stern darfst du weglassen.

Plugin	Aktion	So steht es im Makro
OBS Studio	Szene wechseln	obs.switch_scene scene=Gaming
Lautstärke	Programm-Lautstärke setzen	audio.set_app_volume app=Spotify.exe value=20
Tastatur	Tastenkürzel senden	keyboard.hotkey combo=ctrl+shift+m
Allgemein	Webseite öffnen	system.open_url url=multiversedeck.dev
Discord	Nachricht in Kanal posten	discord.send_message message=Hallo zusammen
Zähler	Zähler hochzählen	counter.increment name=Tode

Grenzen

Eine Taste ist eine Taste, kein Programm. Darum gelten feste Grenzen:

Grenze	Wert
Schritte je Makro	höchstens 25
eine einzelne Pause	höchstens 5 Sekunden
Wartezeit zusammen	höchstens 20 Sekunden
ein Makro in einem Makro	nicht erlaubt (es könnte sich selbst aufrufen)

Überschreitest du eine Grenze, meldet die Software es mit der Nummer der Zeile.

Wenn etwas schiefgeht

Schlägt ein Schritt fehl, stoppt das Makro und die Meldung nennt den Schritt:

Schritt 3 (audio.set_app_volume): Spotify.exe spielt gerade keinen Ton

Ein Schritt mit einem abgeschalteten Plugin scheitert mit dem Hinweis, dass es im Marktplatz einzuschalten ist. Ein Makro, das ein Plugin ohne Einrichtung aufruft (zum Beispiel Home Assistant ohne Adresse), meldet dessen Einrichtungshinweis.

Fehler beim Lesen des Makros nennen die Zeile:

• „Zeile 2: erwartet wird plugin.befehl, gelesen wurde …“
• „Zeile 4: ein Makro darf kein Makro aufrufen“
• „Zeile 1: warte braucht genau eine Zahl in Millisekunden“
• „das Makro ist leer“

Tipps

• Teste Schritt für Schritt. Lege erst die einzelnen Aktionen auf Tasten, prüfe jede, und schreibe sie dann in ein Makro.
• Setze nach Aktionen, die Zeit brauchen (Szenenwechsel, Programmstart), eine kurze Pause, bevor der nächste Schritt davon abhängt.
• Ein Makro kann mehr: Es nimmt jede Aktion jedes aktivierten Plugins, auch Ordner öffnen oder Tastenkürzel senden.

---

Weiter: Rezepte · Plugin Makro