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
- Öffne die Belegung, zum Beispiel eine Taste oder einen Encoder, und dann das Macro-Feld.
- Wähle ein vorhandenes Macro aus der Bibliothek, Quick-Create für einen Einzelbefehl oder Multi-Step für einen Ablauf mit mehreren Schritten.
- 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 sendet den Befehl wirklich. Prüfe vorher, welches Ziel ausgewählt ist und ob dadurch Licht, Ton oder Video starten können.
Einzelbefehle
- Wähle im Editor das Protokoll und seine Einstellungen.
- 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.
- 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
| Einstellung | Bedeutung |
|---|---|
| Output: USB1 / USB2 / RTP | Ausgabewege für diesen Schritt, einzeln wählbar. RTP setzt aktiviertes RTP-MIDI voraus. USB 2 muss als MIDI-Geräteport verfügbar sein. |
| Channel | MIDI-Kanal 1–16 |
| Note | Note und Velocity. Send Note Off on release beendet die Note beim Loslassen. |
| Control Change | Controller-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 Change | Programmnummer. Prüfe, wie dein Zielgerät seine Programme nummeriert. |
| SysEx | Hex-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
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.
- Type auf Integer oder Float stellen und Relative value control einschalten. Das Feld Value heißt jetzt Starting value.
- Direction wählen: Increase oder Decrease.
- Step size, Minimum und Maximum eintragen. Der Startwert muss zwischen Minimum und Maximum liegen.
- Für einen Encoder belegst du
RIGHT >mit Increase und< LEFTmit 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.
| Feld | Bedeutung | Standard |
|---|---|---|
| Feedback address | Adresse, unter der das Gerät den Wert meldet. Leer: dieselbe wie der Befehl. | – |
| Query command | Optionaler Befehl, der den Wert abfragt, z. B. /ch/01/mix/fader | – |
| Feedback argument | Welches Argument der Antwort den Wert enthält, ab 0 gezählt | 0 |
| Refresh | When 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 gilt | 30000 |
| Reply wait (ms) | Wie lange die FrenschPress auf die Antwort wartet | 100 |
| Reply to query source port | Für Geräte, die an den Absender-Port antworten statt an einen festen Port | aus |
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
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
| Einstellung | Art-Net | sACN |
|---|---|---|
| Universe | 0–32767 | 1–63999 |
| Unicast | Ziel-IP oder gespeichertes Target | Ziel-IP oder gespeichertes Target |
| Ohne Unicast | Broadcast an 255.255.255.255 | Multicast für das Universe |
| Priority | – | 1–200, Standard 200 |
| Channel / Level | Kanäle und Prozentwerte | Kanä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
- Name und Beschreibung eintragen.
- Schritte hinzufügen und jeden Schritt im Protokolleditor einrichten.
- Die Reihenfolge bei Bedarf per Drag-and-drop ändern.
- Mit Save Changes übernehmen.
| Sequenz | Wann sie läuft |
|---|---|
| On Press | normaler Tastendruck |
| On Next Press | jeder zweite Druck, abwechselnd mit On Press |
| On Release | beim Loslassen |
On Next Press und On Release schaltest du im Editor ein.
Neben den Protokollen aus den Abschnitten oben gibt es diese Schrittarten:
| Schritt | Wirkung |
|---|---|
| Delay | wartet die angegebene Zeit in Millisekunden bis zum nächsten Schritt |
| Button Mapping Switch / Switch Set | schaltet die ausgewählten Gerätetasten oder Encoder auf Set A, B oder C |
| Variable | setzt Name und Wert einer Gerätevariablen |
| TimeCode | steuert 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.
- Wähle im Macro-Picker die Snapshot-Erstellung für Art-Net oder sACN.
- Trag Universe Start und bei Bedarf Universe End ein. Art-Net beginnt bei 0, sACN bei 1. Höchstens zehn Universen.
- Setze Unicast und Ziel-IP nach Bedarf.
- Leg Fade Duration (ms) fest, bei sACN zusätzlich Priority.
- 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.
- Erstelle den Snapshot und weise ihn zu.
- 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.
Um einzelne Kanäle zu korrigieren, musst du nicht neu aufnehmen:
- Öffne den vorhandenen Snapshot zum Bearbeiten. Recorded content zeigt eine Zusammenfassung.
- Wähle das Universe.
- Trag unter Levels to apply die Werte ein, zum Beispiel
1-12@50, 20@100. - 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
| Symptom | Ursache | Abhilfe |
|---|---|---|
| MIDI kommt über RTP nicht an | RTP-MIDI ist nicht aktiviert | RTP-MIDI einschalten, dann erneut testen |
| MIDI kommt über USB 2 nicht an | USB 2 arbeitet als USB-Host für Stream Deck oder LTC-Dongle | In den Einstellungen Enable USB Host support ausschalten und Save & Restart USB 2 wählen |
| OSC-Ziel reagiert nicht, obwohl die Adresse stimmt | Argumenttyp passt nicht, etwa Text statt Zahl | Type auf den Typ setzen, den das Ziel erwartet |
| Speichern geht nicht | Eingeschaltete Alternate- oder Release-Felder sind unvollständig, oder Plugin-Felder laden noch | Felder ausfüllen oder ausschalten; warten, bis die Plugin-Felder geladen sind |
| Macro löst bei schnellem Drücken nur einmal aus | Min Time Between Go (s) blockiert die Wiederholung | Wert verringern |
| Snapshot wurde ungewollt überschrieben | Temp-Look lange gehalten, Hold to re-record ist an | Hold to re-record ausschalten |
| Duplicate fehlt bei einem Snapshot | Snapshot-Macros lassen sich nicht duplizieren | Stimmung per Backup sichern |