Zum Hauptinhalt springen

OSC-Steuerung

Über OSC steuerst du die FrenschPress von außen: aus QLab, einer Lichtkonsole, Companion oder einem eigenen Skript. Du schickst die Befehle per UDP an die IP-Adresse der FrenschPress, auf den OSC Listen Port.

ParameterWert
Namespace/fpress
ProtokollOSC über UDP
Port53001 (Standard)
ZielIP-Adresse der FrenschPress
Hinweis

Den Port änderst du in den Settings oder direkt am Stream Deck. Auf demselben Port empfängt die FrenschPress auch das QLab-Feedback.

Befehlsübersicht​

Die Spalte Gespeichert zeigt, ob die FrenschPress die Änderung speichert. Befehle mit „Nein“ wirken nur zur Laufzeit.

BefehlArgumenteGespeichert
/fpress/mode1, 2, 3Ja
/fpress/setA, B, C + optionale MaskeJa
/fpress/presetPreset-ID (String)Ja
/fpress/buttonTaste + optionale AktionNein
/fpress/macroMacro-Name oder -ID + optionale AktionNein
/fpress/timeline/armTimeline-SelektorJa
/fpress/timeline/disarmTimeline-SelektorJa
/fpress/timeline/arm_all–Ja
/fpress/timeline/disarm_all–Ja
/fpress/ledr g b oder target r g bNein
/fpress/led/release– oder targetNein
/fpress/varname wertNein
/fpress/var/clear– oder nameNein
/fpress/streamdeck/buttonrow col [action]Nein
/fpress/streamdeck/feedbackbutton stateNein
/fpress/streamdeck/feedback/allstateNein
/fpress/streamdeck/feedback/clear–Nein
/fpress/query– oder GruppeNein

/fpress/mode​

Wechselt den Betriebsmodus. Zahl und Name sind gleichwertig.

WertModus
1 / "qlab"QLab Mode
2 / "macro" / "custom"Custom Mode (Macros)
3 / "companion"Companion Mode
/fpress/mode 1
/fpress/mode 2
/fpress/mode 3

/fpress/set​

Wechselt das aktive Button-Set. Der Befehl wirkt nur im Custom Mode.

Erstes Argument: das Ziel-Set.

WertSet
"A" / 1Set A
"B" / 2Set B
"C" / 3Set C

Zweites Argument (optional): eine Maske. Sie legt fest, welche Bedienelemente auf das neue Set wechseln. Ohne Maske wechseln alle.

/fpress/set "A"
/fpress/set "B"
/fpress/set "C" "stop,go,pause"
/fpress/set "A" 7

Maskenverzeichnis​

Die Maske ist eine Integer-Bitmaske, ein Selector-String oder "all". Im Selector-String trennst du die Tokens mit ,, ;, | oder Leerzeichen.

Selector-TokenBitmask
stop, 01 << 0
go, 11 << 1
pause, 21 << 2
enc, encoder, push, 31 << 3
left, prev, ccw, 41 << 4
right, next, cw, 51 << 5
push_left, combo_left, combo_prev, 61 << 6
push_right, combo_right, combo_next, 71 << 7
all0xFF
/fpress/set "B" "stop,go,pause"
/fpress/set "C" "all"
/fpress/set "A" 255
/fpress/set "A" 7

/fpress/preset​

Lädt ein Preset. Der Befehl erwartet die Preset-ID, nicht den Anzeigenamen. Die ID findest du im Preset-Picker der Weboberfläche.

Preset-TypFormat
User-Preset"mein-preset-12ab"
Plugin-Preset"pluginId:presetId"
Leeren"empty"
/fpress/preset "my-user-preset-12ab"
/fpress/preset "osc-qlab-basics:transport"
/fpress/preset "empty"

/fpress/button​

Löst eine Taste der FrenschPress aus, als hättest du sie am Gerät gedrückt. So bedienst du auch Macros mit getrennter Press- und Release-Aktion aus der Ferne.

Erstes Argument: die Taste.

WertTaste
"stop" / 0STOP
"go" / "play" / 1GO
"pause" / 2PAUSE

Zweites Argument (optional): die Aktion. Standard ist "tap".

AktionWirkung
"tap" / "trigger" / "go"Drücken und sofort loslassen
"press" / "on" / "1"Nur drücken (Taste bleibt logisch gehalten)
"release" / "off" / "0"Nur loslassen
/fpress/button "go"
/fpress/button "stop" "press"
/fpress/button "stop" "release"
/fpress/button 1 "tap"
warnung

Wenn du press sendest, sende danach auch release. Eine logisch gehaltene Taste blockiert sonst Release-Sequenzen und Toggle-Zustände.


/fpress/macro​

Startet ein Macro über seinen Namen oder seine ID. Das Macro muss dafür keiner Taste zugewiesen sein.

Erstes Argument: der exakte Macro-Name oder die Macro-ID. Passt ein Name auf mehrere Macros, lehnt die FrenschPress den Befehl ab. Nimm in dem Fall die ID.

Zweites Argument (optional): die Aktion. Standard ist "trigger".

AktionWirkung
"trigger" / "tap" / "start"Macro einmal ausführen
"on" / "press" / "1"Snapshot-Macro einschalten; bei allen anderen Macros wie trigger
"off" / "release" / "0"Snapshot-Macro ausschalten
"toggle"Snapshot-Macro umschalten
/fpress/macro "Haus AN"
/fpress/macro "Haus AN" "toggle"
/fpress/macro "macro-7f3a" "trigger"
hinweis

off, release und toggle gibt es nur für Snapshot-Macros (Art-Net/sACN-DMX-Snapshots). Nur sie haben einen dauerhaften Ein/Aus-Zustand.


/fpress/timeline/arm & /fpress/timeline/disarm​

Schaltet eine einzelne Timeline scharf oder entschärft sie.

Argument: der Timeline-Selektor. Drei Formen sind möglich:

FormBeispiel
Sichtbare Nummer aus dem Dropdown"1"
Anzeigename"Main Timeline"
Interne ID"main"
/fpress/timeline/arm "1"
/fpress/timeline/arm "Main Timeline"
/fpress/timeline/disarm "main"

/fpress/timeline/arm_all & /fpress/timeline/disarm_all​

Schaltet alle Timelines auf einmal scharf oder entschärft sie. Ohne Argumente.

/fpress/timeline/arm_all
/fpress/timeline/disarm_all
hinweis

Die Befehle sind idempotent. Ist der Zustand schon erreicht, schreibt die FrenschPress nichts ins Dateisystem. Änderungen an allen Timelines speichert sie atomar.


/fpress/led​

Setzt eine RGB-Farbe zur Laufzeit, für alle LEDs oder für eine einzelne. Die Farbe wird nicht gespeichert.

Wertebereich: 0–255 pro Kanal

Targets:

TargetBeschreibung
"all" / "*" / 0Alle LEDs
"stop" / "btn0" / "button0" / 1Stop-Taste
"go" / "btn1" / "button1" / 2Go-Taste
"pause" / "btn2" / "button2" / 3Pause-Taste
"encoder" / "enc" / "push" / "btn3" / 4Encoder
/fpress/led 255 0 0
/fpress/led "all" 255 0 0
/fpress/led "stop" 255 0 0
/fpress/led "go" 0 255 0
/fpress/led "pause" 255 140 0
/fpress/led "encoder" 0 80 255

Die Farbe bleibt, bis ein weiteres /fpress/led sie ändert oder /fpress/led/release sie freigibt. Modus- und Feedback-Farben laufen im Hintergrund weiter. Nach dem Release siehst du wieder die aktuelle Farbe.

/fpress/led/release​

Gibt die gesetzten Farben frei. Die LEDs zeigen danach wieder ihre aktuelle Live-Farbe. Ohne Argument gibst du alle frei, mit Target nur dieses. Die Targets sind dieselben wie bei /fpress/led.

Alias: /fpress/led/clear

/fpress/led/release
/fpress/led/release "all"
/fpress/led/release "stop"

/fpress/var​

Schreibt eine Variable auf der FrenschPress. Stream-Deck-Beschriftungen mit $name zeigen ihren Wert an.

ArgumentBedeutung
1Name – 1–24 Zeichen aus A-Z, a-z, 0-9, _
2Wert – String, Integer, Float oder Bool
/fpress/var "cue" "Blackout"
/fpress/var "ch" 12
/fpress/var "level" 0.5
/fpress/var "armed" true

Zahlen werden als Text abgelegt: Integer dezimal, Float mit drei Nachkommastellen, Bool als 1 oder 0. Über HTTP passiert dasselbe, beide Wege speichern also denselben Wert.

Werte über 48 Zeichen schneidet die FrenschPress ohne Warnung ab. Sie hält bis zu 64 Variablen. Ist die Tabelle voll, weist sie neue Namen ab.

Reservierte Namen

Namen mit sys_ am Anfang gehören dem Gerät (sys_mode, sys_cue, sys_tc …). Die FrenschPress weist sie hier ab und meldet das. Die vollständige Liste steht unter Variablen.

/fpress/var/clear​

Löscht Variablen: mit Argument eine, ohne Argument alle.

/fpress/var/clear "cue"
/fpress/var/clear

Eine Beschriftung mit einer gelöschten Variable verliert nur diesen $name. Aus CUE $cue wird CUE . Der gespeicherte Beschriftungstext bleibt, wie er ist.


Stream Deck über OSC​

Diese Befehle wirken nur, wenn ein Stream Deck angeschlossen ist.

/fpress/streamdeck/button​

Löst eine Deck-Taste aus. Row und Column zählen ab 0.

Beide Schreibweisen sind gleichwertig:

/fpress/streamdeck/button 1 2
/fpress/streamdeck/button/1/2

Als letztes Argument kannst du eine Aktion mitgeben. Standard ist "tap".

AktionWirkung
"tap" / "trigger" / "go"Drücken und loslassen
"press" / "on" / "1"Nur drücken
"release" / "off" / "0"Nur loslassen
/fpress/streamdeck/button 0 0 "tap"
/fpress/streamdeck/button/0/0 "press"
/fpress/streamdeck/button/0/0 "release"
hinweis

Tasten, die für die Timecode-Anzeige reserviert sind, und die Tools-Taste führen auch über OSC keine Macros aus.

/fpress/streamdeck/feedback​

Setzt die Feedback-Farbe einer Deck-Taste von außen. So zeigst du zum Beispiel den Zustand eines anderen Systems auf dem Deck an.

Zustandswerte:

WertBedeutung
1, "on", "true", "active", trueActive-/Feedback-Farbe erzwingen
0, "off", "false", "idle", falseIdle-Farbe erzwingen
"clear", "auto", "local", "release"Override aufheben, die lokale Logik übernimmt wieder

Floats zwischen 0.0 und 1.0 werden bei 0.5 gerundet.

Adressierung per Tastennummer (1–32, zählt ab 1):

/fpress/streamdeck/feedback 5 1
/fpress/streamdeck/feedback/5 1
/fpress/streamdeck/5/feedback 1

Adressierung per Raster (Row/Column, zählt ab 0):

/fpress/streamdeck/feedback/1/2 1
/fpress/streamdeck/1/2/feedback "clear"

/fpress/streamdeck/feedback/all​

Setzt alle Tasten auf denselben Zustand.

/fpress/streamdeck/feedback/all 1
/fpress/streamdeck/feedback/all "clear"

/fpress/streamdeck/feedback/clear​

Hebt alle OSC-Overrides auf. Ohne Argumente.

/fpress/streamdeck/feedback/clear

/fpress/query​

Fragt den Zustand der FrenschPress ab. Sie antwortet mit einer oder mehreren /fpress/status/…-Nachrichten, und zwar an Adresse und Port, von denen die Anfrage kam. Dein Empfänger lauscht also auf dem Port, von dem er gesendet hat.

/fpress/query
/fpress/query "mode"

Ohne Argument kommen alle vier Antworten. Mit einem Gruppennamen (device, mode, set oder qlab) kommt nur diese eine.

Antworten​

NachrichtArgumente
/fpress/status/deviceGerätename · Firmware-Version · MAC-Adresse · IP-Adresse
/fpress/status/modeMode (qlab / macro / companion) · QLab-Transport (osc / msc) · interner Transport-Code
/fpress/status/setAktives Button-Set (A / B / C) · Set je Taste als Buchstabenfolge
/fpress/status/qlabLäuft ein Cue (0/1) · Pausiert (0/1) · QLab-Feedback abonniert (0/1)
hinweis

Pro Absender antwortet die FrenschPress höchstens einmal alle 100 ms. Schnellere Anfragen verwirft sie. Anfragen von ihrer eigenen Adresse ignoriert sie.

Companion

Steuerst du die FrenschPress aus Bitfocus Companion, musst du diese Befehle nicht selbst bauen. Das Companion-Modul übernimmt Abfrage und Auswertung.


Kurzreferenz​

/fpress/mode 2
/fpress/set "B"
/fpress/set "B" "stop,go,pause"
/fpress/preset "my-user-preset-12ab"
/fpress/preset "osc-qlab-basics:transport"
/fpress/button "go"
/fpress/button "stop" "press"
/fpress/macro "Haus AN" "toggle"
/fpress/timeline/arm "Main Timeline"
/fpress/timeline/disarm_all
/fpress/led "stop" 255 0 0
/fpress/led 255 80 0
/fpress/led/release
/fpress/var "cue" "Blackout"
/fpress/var/clear
/fpress/streamdeck/button/0/0
/fpress/streamdeck/feedback/1/2 1
/fpress/streamdeck/feedback/clear
/fpress/query
/fpress/query "qlab"

Wenn es nicht klappt​

SymptomUrsacheAbhilfe
Kein Befehl kommt anFalscher Port oder falsche IP-AdressePort in den Settings prüfen (Standard 53001) und an die IP-Adresse der FrenschPress senden.
/fpress/set bewirkt nichtsDie FrenschPress ist nicht im Custom ModeVorher /fpress/mode 2 senden.
/fpress/macro wird abgelehntDer Name passt auf mehrere MacrosDie Macro-ID statt des Namens senden.
Eine Taste reagiert nach press nicht mehr normalDas release fehlt/fpress/button … "release" senden.
/fpress/var wird abgewiesenName beginnt mit sys_ oder alle 64 Plätze sind belegtAnderen Namen wählen oder mit /fpress/var/clear aufräumen.
Auf /fpress/query kommt keine AntwortEmpfänger lauscht auf dem falschen Port oder Anfragen kommen schneller als alle 100 msAuf dem Absende-Port lauschen und Abfragen langsamer senden.