Zum Hauptinhalt springen

Befehle & Snapshots

Ein Macro ist ein gespeicherter Befehl oder Ablauf. Dasselbe Macro kannst du einer Gerätetaste, einem Encoder, einer Stream-Deck-Taste oder einem Timeline-Cue zuweisen. Änderst du das Macro, nutzen alle diese Belegungen sofort den neuen Inhalt.

Macro zuweisen​

  1. Öffne die Belegung, zum Beispiel eine Taste oder einen Encoder, und dann das Macro-Feld.
  2. Wähle ein vorhandenes Macro aus der Bibliothek, Quick-Create für einen Einzelbefehl oder Multi-Step für einen Ablauf mit mehreren Schritten.
  3. Richte den Befehl ein, wie in den Abschnitten unten beschrieben, und speichere mit Save Changes.

In der Bibliothek kannst du Macros suchen, bearbeiten, testen und löschen. Geeignete eigene Macros lassen sich auch duplizieren.

Test führt aus

Test sendet den Befehl wirklich. Prüfe vorher, welches Ziel ausgewählt ist und ob dadurch Licht, Ton oder Video starten können.

Einzelbefehle​

  1. Wähle im Editor das Protokoll und seine Einstellungen.
  2. Unter Select device stehen die installierten Plugins. Ihre Felder bauen den Befehl für dein Zielgerät zusammen. Gibt es kein passendes Plugin, trägst du die Werte selbst ein.
  3. Wähle Save Changes und bestätige den Namen im Dialog.

Hast du den Editor aus einer Belegung heraus geöffnet, wird das neue Macro dieser Belegung gleich zugewiesen.

Min Time Between Go (s) legt fest, wie schnell dasselbe Macro erneut ausgelöst werden darf. Das schützt vor versehentlichem Doppeldrücken. Es ist keine Wartezeit innerhalb des Ablaufs.

MIDI​

MIDI-Editor mit den Ausgaben USB1, USB2 und RTP
EinstellungBedeutung
Output: USB1 / USB2 / RTPAusgabewege für diesen Schritt, einzeln wählbar. RTP setzt aktiviertes RTP-MIDI voraus. USB 2 muss als MIDI-Geräteport verfügbar sein.
ChannelMIDI-Kanal 1–16
NoteNote und Velocity. Send Note Off on release beendet die Note beim Loslassen.
Control ChangeController-Nummer und Wert. Absolute setzt einen Wert, Relative + / − ändert ihn schrittweise.
Fade bei CCÜberblendet zwischen den eingestellten A- und B-Werten in der angegebenen Zeit (Millisekunden).
Program ChangeProgrammnummer. Prüfe, wie dein Zielgerät seine Programme nummeriert.
SysExHex-Bytes des gerätespezifischen Befehls, etwa F0 … F7

Ein MIDI-Plugin kann die gerätespezifischen Felder übernehmen. Die Auswahl der Ausgabewege gilt auch dann.

OSC​

OSC-Befehl mit Ziel- und Befehlsfeldern

Wähle ein gespeichertes Target oder trag unter Custom target IP und Port selbst ein. Send to backup target sendet zusätzlich an ein zweites Ziel, etwa an einen Backup-Rechner. Unter Use QLab addressing for this step stehen Workspace ID und optionaler Passcode bereit. Ein QLab-Scan kann die Host-Werte übernehmen.

Ohne Plugin setzt du Address, Type und Value. Als Typ stehen kein Argument, String, Integer, Float und Double zur Wahl. Der Typ muss zu dem passen, was das Ziel erwartet: "1" als Text und 1 als Zahl sind verschiedene Argumente.

Relative Werte​

Mit Relative value control sendet ein OSC-Befehl keinen festen Wert, sondern ändert den aktuellen Wert schrittweise, etwa einen Fader am Mischpult in 0,05er-Schritten. Die Option erscheint bei Typ Integer oder Float ohne Plugin.

OSC-Befehl mit Relative value control und Feedback-Einstellungen
  1. Type auf Integer oder Float stellen und Relative value control einschalten. Das Feld Value heißt jetzt Starting value.
  2. Direction wählen: Increase oder Decrease.
  3. Step size, Minimum und Maximum eintragen. Der Startwert muss zwischen Minimum und Maximum liegen.
  4. Für einen Encoder belegst du RIGHT > mit Increase und < LEFT mit Decrease, am schnellsten über das Encoder-Richtungspaar.

Ohne Feedback merkt sich die FrenschPress den zuletzt gesendeten Wert und rechnet von dort weiter. Nach einem Neustart beginnt sie wieder beim Startwert. Ändert jemand den Wert direkt am Gerät, bekommt die FrenschPress das nicht mit.

Feedback (optional): Mit Value source → Device feedback rechnet die FrenschPress vom Wert aus, den das Gerät zurückmeldet. Dafür muss das Gerät an die IP der FrenschPress und ihren OSC Listen Port antworten, mit derselben Skala wie der Befehl.

FeldBedeutungStandard
Feedback addressAdresse, unter der das Gerät den Wert meldet. Leer: dieselbe wie der Befehl.–
Query commandOptionaler Befehl, der den Wert abfragt, z. B. /ch/01/mix/fader–
Feedback argumentWelches Argument der Antwort den Wert enthält, ab 0 gezählt0
RefreshWhen stale: neu abfragen, wenn der Wert älter als Stale after ist. Initial sync, then live updates: einmal abfragen, danach nur mitlesen. Before every adjustment: vor jedem Schritt abfragen (braucht Query command).When stale
Stale after (ms)Ab wann ein gemeldeter Wert als veraltet gilt30000
Reply wait (ms)Wie lange die FrenschPress auf die Antwort wartet100
Reply to query source portFür Geräte, die an den Absender-Port antworten statt an einen festen Portaus

Fehlt gültiges Feedback oder ist es veraltet, lässt die FrenschPress den Schritt aus, statt einen falschen Wert zu senden. Relative Werte lassen sich nicht mit Use second command, Enable release command oder QLab-Adressierung kombinieren.

HTTP​

Wähle ein Target oder Host/IP und Port. Setze dann Method, Path und bei Bedarf Headers und Payload.

  • Methoden: GET, POST, PUT und DELETE.
  • Headers: einer pro Zeile, im Format Header-Name: Wert.
  • Payload: Text oder JSON. Ein eingetragener Payload wird auch bei GET gesendet.

Welche Werte nötig sind, bestimmt dein Zielgerät.

TCP​

TCP-Befehl mit Alternate- und Release-Payload

Wähle ein Target oder Host und Port. Data enthält, was gesendet wird. Ohne Send as binary geht der Inhalt als Text hinaus. Mit Send as binary werden Hex-Werte in Bytes umgesetzt. Ein Plugin kann diese Daten aus lesbaren Gerätefeldern erzeugen.

Toggle alternate TCP payload sendet bei jedem zweiten Druck die Alternate-Daten. Deren Binary-Einstellung folgt dem Hauptbefehl. Send release payload sendet beim Loslassen und hat eine eigene Binary-Auswahl. Haupt-, Alternate- und Release-Aktion können jeweils aus Plugin-Feldern entstehen.

Eingeschaltete Alternate- und Release-Felder müssen vollständig ausgefüllt sein. Öffnest du den Befehl später wieder, zeigt der Editor die gespeicherten Plugin-Einstellungen an.

Art-Net & sACN​

Lichtbefehl mit Channel / Level und Zusatzaktionen
EinstellungArt-NetsACN
Universe0–327671–63999
UnicastZiel-IP oder gespeichertes TargetZiel-IP oder gespeichertes Target
Ohne UnicastBroadcast an 255.255.255.255Multicast für das Universe
Priority–1–200, Standard 200
Channel / LevelKanäle und ProzentwerteKanäle und Prozentwerte
Fade Mode / Fade TimeÜberblendung zwischen aus und den ZielwertenÜberblendung zwischen aus und den Zielwerten

Channel / Level nutzt die Schreibweise, die du vom Lichtpult kennst:

1-12@50, 34+36+37@30, 120-130@100

Das setzt Kanal 1 bis 12 auf 50 %, die Kanäle 34, 36 und 37 auf 30 % und Kanal 120 bis 130 auf 100 %. Die Werte sind 0–100 %, keine DMX-Rohwerte 0–255. Der Fade bestimmt nur die Zeit bis zum Ziel, die eingetragenen Zielwerte bleiben gleich.

Momentary bump​

Wird die Option angeboten, wählst du unter Send release action den Eintrag Momentary bump. Solange du die Taste hältst, ist die Lichtaktion aktiv. Beim Loslassen sendet die FrenschPress die passende Rückaktion. So setzt du einen Lichtakzent genau für die Dauer des Tastendrucks. Die Option gibt es nur, wenn Toggle alternate action aus ist.

Encoder-Richtungspaar​

Belegst du eine Drehbewegung, kann Also map the opposite direction erscheinen. Damit legst du die Gegenrichtung gleich mit an, zum Beispiel Pegel hoch und Pegel runter. Prüfe vor dem Speichern den Hinweis, welches zweite Bedienelement belegt wird. Für Art-Net/sACN auf Encoder-Push gilt stattdessen der Master-Fader.

Zusatzaktionen​

  • Toggle alternate action wechselt bei aufeinanderfolgenden Tastendrücken zwischen Hauptaktion und Alternate-Aktion.
  • Send release action löst beim Loslassen eine zusätzliche Aktion aus.

Der Editor zeigt diese Optionen nur für passende Protokolle und Belegungen. Bei MIDI und OSC gibt es dafür eigene Second- und Release-Felder, bei TCP die oben beschriebenen Payload-Felder.

Bei HTTP ändern die Zusatzaktionen nur den Payload. Target, Methode, Pfad und Headers kommen vom Hauptbefehl.

Switch Set bietet zusätzlich Restore previous set selection on release. Das gewählte Set gilt, solange du die Taste hältst. Beim Loslassen kehren die vorherigen Sets zurück. So erreichst du vorübergehend eine zweite Belegungsebene.

Für einen vollständigen An-/Aus-Ablauf mit mehreren Schritten nutzt du die getrennten Sequenzen im Multi-Step-Editor.

Multi-Step​

Multi-Step-Editor
  1. Name und Beschreibung eintragen.
  2. Schritte hinzufügen und jeden Schritt im Protokolleditor einrichten.
  3. Die Reihenfolge bei Bedarf per Drag-and-drop ändern.
  4. Mit Save Changes übernehmen.
SequenzWann sie läuft
On Pressnormaler Tastendruck
On Next Pressjeder zweite Druck, abwechselnd mit On Press
On Releasebeim Loslassen

On Next Press und On Release schaltest du im Editor ein.

Neben den Protokollen aus den Abschnitten oben gibt es diese Schrittarten:

SchrittWirkung
Delaywartet die angegebene Zeit in Millisekunden bis zum nächsten Schritt
Button Mapping Switch / Switch Setschaltet die ausgewählten Gerätetasten oder Encoder auf Set A, B oder C
Variablesetzt Name und Wert einer Gerätevariablen
TimeCodesteuert den MTC Master oder den internen Timecode

Snapshots​

Ein Snapshot speichert empfangene Art-Net- oder sACN-Kanalwerte für bis zu zehn Universen. Damit spielst du eine vorbereitete Lichtstimmung ab, ohne dass das Pult weiterlaufen muss.

Snapshot-Editor mit Universe-Bereich, Fade, Trigger Mode und Kanalbearbeitung
  1. Wähle im Macro-Picker die Snapshot-Erstellung für Art-Net oder sACN.
  2. Trag Universe Start und bei Bedarf Universe End ein. Art-Net beginnt bei 0, sACN bei 1. Höchstens zehn Universen.
  3. Setze Unicast und Ziel-IP nach Bedarf.
  4. Leg Fade Duration (ms) fest, bei sACN zusätzlich Priority.
  5. Wähle den Trigger Mode:
    • Toggle schaltet bei jedem Druck ein und aus.
    • Temp wirkt, solange du hältst, und stellt beim Loslassen den aktuellen externen Eingang wieder her.
  6. Erstelle den Snapshot und weise ihn zu.
  7. Lass die gewünschte Stimmung vom Pult ankommen und halte die belegte Taste fünf Sekunden. Die Taste blinkt dreimal grün, wenn die Aufnahme gespeichert ist, und dreimal rot, wenn sie fehlgeschlagen ist.

Ignore recorded zeros lässt Kanäle, die bei der Aufnahme auf 0 standen, unter Kontrolle des Pults. Das betrifft auch absichtlich auf 0 gesetzte Kanäle. Bei sACN muss der Empfänger Prioritäten pro Adresse unterstützen, bei Art-Net HTP-Merging.

Hold to re-record erlaubt, später per langem Halten neu aufzunehmen. Schalte es aus, wenn ein lange gehaltener Temp-Look die gespeicherte Stimmung nicht überschreiben soll.

Prüfen und korrigieren​

Monitor zeigt die gespeicherten Werte, ohne den Snapshot auszulösen. Wähle ein Universe. Non-zero only blendet Kanäle mit 0 aus. Refresh liest den gespeicherten Stand neu.

Snapshot Monitor mit gespeicherten Kanälen

Um einzelne Kanäle zu korrigieren, musst du nicht neu aufnehmen:

  1. Öffne den vorhandenen Snapshot zum Bearbeiten. Recorded content zeigt eine Zusammenfassung.
  2. Wähle das Universe.
  3. Trag unter Levels to apply die Werte ein, zum Beispiel 1-12@50, 20@100.
  4. Wähle Apply.

Nur diese Kanäle ändern sich, alle anderen behalten ihren gespeicherten Wert. Apply schreibt die Korrektur sofort.

Snapshot-Macros lassen sich nicht duplizieren, weil die Aufnahme zum ursprünglichen Macro gehört. Sichere wichtige Stimmungen mit einem Backup.

Wenn es nicht klappt​

SymptomUrsacheAbhilfe
MIDI kommt über RTP nicht anRTP-MIDI ist nicht aktiviertRTP-MIDI einschalten, dann erneut testen
MIDI kommt über USB 2 nicht anUSB 2 arbeitet als USB-Host für Stream Deck oder LTC-DongleIn den Einstellungen Enable USB Host support ausschalten und Save & Restart USB 2 wählen
OSC-Ziel reagiert nicht, obwohl die Adresse stimmtArgumenttyp passt nicht, etwa Text statt ZahlType auf den Typ setzen, den das Ziel erwartet
Speichern geht nichtEingeschaltete Alternate- oder Release-Felder sind unvollständig, oder Plugin-Felder laden nochFelder ausfüllen oder ausschalten; warten, bis die Plugin-Felder geladen sind
Macro löst bei schnellem Drücken nur einmal ausMin Time Between Go (s) blockiert die WiederholungWert verringern
Snapshot wurde ungewollt überschriebenTemp-Look lange gehalten, Hold to re-record ist anHold to re-record ausschalten
Duplicate fehlt bei einem SnapshotSnapshot-Macros lassen sich nicht duplizierenStimmung per Backup sichern