Device Mode

Auf der Seite Device Mode legst du fest, wie die FrenschPress arbeitet: als QLab-Fernbedienung (QLab Mode), mit eigenen Macros (Custom Mode) oder als Surface für Bitfocus Companion (Companion Mode).

Der Moduswechsel wirkt sofort. Neben den Einstellungen des aktiven Modus sitzt der Regler LED Brightness. Save Settings speichert die Formular-Einstellungen des aktiven Modus. Am Gerät wechselst du den Modus mit einer Tastenkombination.

QLab Mode

Im QLab Mode steuert die FrenschPress QLab: per MIDI Show Control (MSC) über USB oder per OSC über das Netzwerk.

LED-Farben im QLab Mode:

• Alle drei Tasten leuchten standardmäßig weiß (#FFFFFF). Die Farbe stellst du unter LED Color ein.
• PAUSE leuchtet orange, solange pausiert ist. Das gilt auch bei MSC.
• GO leuchtet grün, solange Cues laufen. Dafür braucht die FrenschPress das OSC-Feedback von QLab, also eine Netzwerk-Verbindung.

USB-Verbindung (MIDI MSC)

Die FrenschPress ist Plug & Play: per USB mit dem QLab-Rechner verbinden, fertig. Beide USB-Ports übertragen MSC, solange sie als MIDI-Geräteport laufen. Im USB-Host-Modus steht USB 2 dafür nicht zur Verfügung.

Feld	Bedeutung
LED Color	Farbe der Tasten-LEDs im QLab Mode
Device ID	MSC-Ziel-ID. 0–126 adressiert ein bestimmtes Gerät, 127 ist All-Call.
Checkboxen bei STOP und PAUSE	Sperren die Taste oder geben sie wieder frei

Änderungen übernimmst du mit Save Settings.

Netzwerk-Verbindung (OSC)

Voraussetzungen:

• In QLab ist OSC aktiviert. Wie das geht, steht in der QLab-Dokumentation. Ohne OSC in QLab funktionieren weder der OSC-Modus noch der Scan.
• Für den QLab-Rechner ist ein Target angelegt, bei Bedarf ein zweites für den Backup-Rechner (siehe Network Targets & Plugins).

Manuell einrichten:

1. Network Control aktivieren.
2. Im Dropdown das Target für das Master-System wählen.
3. Optional ein zweites Target für das Backup-System wählen.

Im OSC-Modus zeigen die Tasten-LEDs den Cue-Zustand (Playing, Paused) als Feedback.

Automatisch einrichten (QLab/GoButton Scan)

1. Im Tools-Menü Tools & device → QLab/GoButton Scan wählen. Ein blaues Lauflicht zeigt, dass der Scan läuft.
2. Grünes Blinken: Das Setup war erfolgreich. Rotes Blinken: Es wurde kein passender QLab-Host gefunden.
3. Verlangt der Workspace einen Passcode oder eine Workspace ID, trägst du sie anschließend am jeweiligen Target ein.

Alternativ hältst du im QLab Mode den Encoder fünf Sekunden gedrückt. Das wechselt zwischen MSC und OSC. Beim Wechsel zu OSC startet die Suche; findet sie keinen Host, bleibt MSC aktiv. Wenn du nur neu suchen willst, ohne den Transport zu wechseln, nimm den Scan im Tools-Menü.

---

Custom Mode

Im Custom Mode belegst du jede Taste und jede Encoder-Geste selbst, mit bis zu drei Belegungen pro Bedienelement (Button-Sets). Komplette Belegungen speicherst du als Preset und lädst sie wieder.

Die Weboberfläche zeigt die FrenschPress als Gerätebild: den Encoder mit seinen Gesten LEFT, RIGHT und PUSH und die drei Tasten mit ihrem LED-Rahmen. Ein Klick auf eine Taste oder eine Encoder-Geste öffnet den Dialog zum Belegen. Auf der Streamdeck-Seite funktioniert das Belegen nach demselben Prinzip.

Controller-Ansicht

Bereich	Funktion
Preset-Auswahl in der rechten Spalte	Preset wählen, Save as Preset und Update Preset (siehe Presets)
Default Target	Vorausgewähltes Target für neue Netzwerk-Befehle, daneben Manage targets (siehe Einzelbefehl)
SET A / SET B / SET C	Wechselt das aktive Button-Set des Geräts. Das aktive Set ist hervorgehoben.
Gerätebild	Die acht Bedienelemente: < LEFT, RIGHT >, PUSH + LEFT, PUSH + RIGHT, PUSH, STOP, GO und PAUSE

Jedes Bedienelement zeigt seinen Namen und darunter das Macro, das im aktiven Set darauf liegt, oder Unassigned. STOP, GO und PAUSE tragen einen Rahmen in ihrer LED-Farbe für das aktive Set.

Belegen per Klick

1. Oben das Set wählen, das du bearbeiten willst: SET A, SET B oder SET C. Das Gerätebild zeigt dann dessen Belegung.
2. Auf eine Taste oder Encoder-Geste klicken. Der Dialog öffnet sich, betitelt mit Bedienelement und Set, z. B. GO · Set B.
3. Macro wählen und bei STOP, GO und PAUSE die LED-Farbe einstellen.
4. Mit Save übernehmen.

Der Dialog belegt immer das aktive Set.

Feld	Funktion
Macro	Derselbe Macro-Picker wie überall: vorhandenes Macro wählen oder über Quick-Create / Multi-Step ein neues anlegen (siehe Befehle erstellen)
LED colour	Nur bei STOP, GO und PAUSE. Die Farbe wirkt schon beim Auswählen live auf der Taste. Save übernimmt sie, Cancel stellt die vorherige Farbe wieder her.

Live-Anzeige

Die Ansicht spiegelt, was am Gerät passiert:

• Gehaltene Tasten (STOP, GO, PAUSE, PUSH) leuchten auf, solange sie gedrückt sind.
• Encoder-Drehungen blitzen kurz bei der jeweiligen Richtung auf, mit gedrücktem Encoder bei PUSH + LEFT / PUSH + RIGHT.
• Belegungen und Set-Wechsel, die am Gerät, am Stream Deck, über OSC oder aus grandMA3 kommen, erscheinen sofort.

Besondere Zustände

Zustand	Darstellung
Gegenläufiges Paar	Bilden < LEFT und RIGHT > ein Paar (Hoch- und Runter-Richtung desselben Werts), bekommen beide Felder einen Rahmen in Akzentfarbe, und von jedem führt eine Linie zum Encoder. Dasselbe gilt für PUSH + LEFT und PUSH + RIGHT.
Lichtmacro auf PUSH	Liegt ein Art-Net- oder sACN-Macro auf PUSH, ist das Drehen ein Master-Fader. < LEFT und RIGHT > sind dann gesperrt und öffnen keinen Dialog.

Smartphone

Auf dem Smartphone bleiben Gerätebild und Belegungsdialog bedienbar. Die Einstellungen stehen unter der Controller-Ansicht. Mit SET A / SET B / SET C wählst du wie am Rechner das Set, das du bearbeitest.

Belegen direkt am Stream Deck

Mit angeschlossenem Stream Deck belegst du STOP, GO, PAUSE und den Encoder auch ohne Browser: im On-Deck-Menü MAP wählen, dann die Taste am Gerät drücken oder den Encoder drehen.

Presets

Ein Preset bündelt die Macro-Belegungen aller Tasten und des Encoders, optional mit LED-Farben. Presets lädst du aus dem Preset-Picker, exportierst und importierst sie oder speicherst die aktuelle Belegung als eigenes User-Preset.

Preset auf Set (A/B/C) anwenden

Enthält ein Preset weniger als drei Button-Sets, fragt beim Anwenden ein Set-Picker-Dialog, in welchen Slot es kommt. So bleiben die Belegungen der anderen Sets erhalten.

Preset enthält	Optionen im Dialog
1 Set	Set A · Set B · Set C. Das Preset wird in den gewählten Slot kopiert.
2 Sets	A+B · B+C. Das Preset beginnt im gewählten Slot.
3 Sets	Kein Dialog. Alle drei Sets werden direkt überschrieben.

tipp

Presets aus dem Plugin-Repository (z. B. TC Master Clock) enthalten oft nur ein oder zwei Sets. Mit dem Set-Picker setzt du sie in eine bestehende Belegung ein, ohne den Rest zu verlieren.

Button-Sets (A / B / C)

Jede Taste und jede Encoder-Geste hat drei Belegungen: die Button-Sets A, B und C. Welche Funktion eine Taste auslöst, hängt vom aktiven Set ab. Funktion und LED-Farbe stellst du pro Taste und Set einzeln ein.

In der Controller-Ansicht wechselst du das Set über SET A / SET B / SET C. Das Gerätebild zeigt dann Belegung und LED-Farben dieses Sets. Wie du das Set am Gerät oder per OSC wechselst, steht unter Button Set wechseln.

Standard-LED-Farben im Custom Mode:

Button-Set	Standardfarbe
Set A	Gold #ffb300
Set B	Cyan #00c0ff
Set C	Magenta #ff00c3

Verfügbare Befehlsarten

Protokoll	Befehle
MIDI	Note, ControlChange, ProgramChange & SysEx über USB und RTP-MIDI (Apple MIDI)
OSC	Open Sound Control, optional mit QLab-Passcode
HTTP	GET, POST, PUT, DELETE
TCP	OSC, MIDI, RAW Socket
Art-Net	DMX-Werte mit Universe/Channel, optional Fade, Unicast/Broadcast
sACN	DMX-Werte mit Universe/Channel, optional Fade, Unicast/Multicast
Delay	Wartezeit zwischen Macro-Schritten in Millisekunden
Snapshot	Art-Net/sACN-DMX-Recorder für max. 10 Universen
TimeCode	MTC-Transport oder interner Timecode (siehe Timecode)
Switch Set	Ausgewählte Gerätetasten auf Set A/B/C umschalten
Variable	Schreibt eine Variable auf dem Gerät, nur im Multi-Step-Editor

Snapshot prüfen (Snapshot Monitor)

Ein Snapshot-Macro nimmt die gerade anliegenden Art-Net-/sACN-Werte auf. Was darin gelandet ist, zeigt der Snapshot Monitor, ohne dass du den Snapshot auslöst. So prüfst du vor der Show, ob er das enthält, was er soll.

1. In der Macro-Library oder im Macro-Editor neben dem Snapshot-Macro auf Monitor klicken.
2. Oben das Universe wählen, falls der Snapshot mehrere aufgenommen hat.
3. Optional Non-zero only aktivieren. Kanäle auf 0 werden ausgeblendet, übrig bleibt, was der Snapshot wirklich stellt.

Einrichtung, Aufnahme und gezielte Korrekturen stehen unter Snapshots.

Encoder als Master-Fader

Liegt auf dem Encoder-Push ein Art-Net- oder sACN-Macro (ein normales oder ein Snapshot-Macro), wird das Drehen zum Master-Fader für genau dieses Macro. Der Druck schaltet das Macro weiterhin an und aus.

Dafür gibt es keine Einstellung, die Funktion folgt aus der Belegung. Liegt ein Lichtmacro auf dem Push, ist Drehen ein Pegel. Liegt keins dort, macht Drehen wieder das, was zugewiesen ist.

Verhalten
Pegel gehört zum Macro	Ein Wechsel des Button-Sets ändert den eingestellten Pegel nicht.
Nach Neustart	Jedes Macro startet wieder mit voller Helligkeit.
Drehen im ausgeschalteten Zustand	Auf der Leitung ändert sich nichts, der Pegel wird aber gemerkt. Beim nächsten Einschalten fährt das Macro auf den eingestellten Wert.
Drehen während eines Fades	Der Fade läuft weiter, der Master skaliert ihn mit.
Andere Macros auf denselben Kanälen	Es gilt weiter HTP: Ein heruntergedimmtes Macro verliert gegen ein helleres.

Art-Net und sACN fehlen in den Dreh-Dropdowns

Weil der Drehweg dann vergeben ist, erscheinen Art-Net- und sACN-Macros nicht in den Auswahlfeldern für Encoder-Drehung. Die beiden Drehfelder sind ausgegraut, sobald ein Lichtmacro auf dem Push liegt. Push + Drehen bleibt frei belegbar, das ist eine andere Geste.

Ein bereits gespeichertes Macro auf einem Drehfeld bleibt sichtbar und lässt sich entfernen.

Das gilt genauso für die Encoder eines Stream Deck +. Dort kann die zugehörige Taste den Pegel als Fade-Balken anzeigen.

Button Set wechseln

Zum Wechseln zwischen den Button-Sets gibt es das Macro Switch Set. Du weist es einer beliebigen Taste zu und legst fest, ob es einzelne Tasten oder alle zusammen umschaltet. Ein entsprechend konfigurierter Encoder-Push kann so durch die drei Sets rotieren: A → B → C → A.

Per OSC geht es ebenfalls: /fpress/set "B" an die IP der FrenschPress senden (siehe OSC).

Befehle erstellen

1. Im Gerätebild auf das gewünschte Bedienelement klicken.
2. Im Dialog das Feld Macro öffnen. Die Library erscheint.
3. Ein vorhandenes Macro wählen oder über Quick-Create ein neues anlegen.
4. In Quick-Create das Protokoll wählen und einen Einzelbefehl erstellen oder ein Multi-Step Macro wählen.

Aktionen an einem Eintrag

Ein Klick auf den Eintrag selbst weist das Macro dem Bedienelement zu, für das du den Picker geöffnet hast. Rechts an jedem Eintrag sitzen kleine Schaltflächen:

Schaltfläche	Wirkung
Edit	Öffnet das Macro im passenden Editor
Duplicate	Legt eine Kopie an und öffnet sie zum Bearbeiten. Nur bei eigenen Macros unter Custom.
Test	Führt das Macro einmal aus, ohne es zuzuweisen
Delete	Löscht das Macro

Macro duplizieren

Duplicate ist der kurze Weg zu einer Variante eines bestehenden Macros, etwa demselben Ablauf auf einem anderen Kanal oder für ein anderes Target.

1. Duplicate am gewünschten Macro drücken.
2. Die Kopie öffnet sich sofort im passenden Editor: Einzelbefehl-Dialog oder Multi-Step-Editor, je nach Macro.
3. Anpassen und speichern. Erst beim Speichern entsteht die Kopie auf dem Gerät. Sie wird dann der Taste, dem Encoder oder der Deck-Taste zugewiesen, von der aus du den Picker geöffnet hast.

Eigenschaft	Was die Kopie mitbringt
Name	<Name> Copy, bei Bedarf mit angehängter Zahl, damit kein Name doppelt vorkommt
Inhalt	Alle Schritte, Parameter und Sequenzen (On Press, On Next Press, On Release) identisch
Zähler	Verwendungszähler und „zuletzt benutzt“ starten bei null. Die Kopie ist ein neues Macro, keine Fortsetzung.

Nicht überall vorhanden

Duplicate erscheint nur bei eigenen Macros in der Kategorie Custom. Gerätebibliotheken sind kuratierte Sammlungen, eine Kopie gehört in die eigenen Macros. Snapshot-Macros haben ebenfalls kein Duplicate: Ihre aufgezeichneten DMX-Werte hängen an der Macro-ID, die eine Kopie nicht mitnehmen kann.

Einzelbefehl

1. Bei Netzwerk-Macros links das Target wählen.
2. Rechts unter Select device ein installiertes Plugin oder einen eigenen Befehl wählen. Das Plugin zeigt die passenden Felder und setzt die nötigen Werte ein.
3. Optional das Macro direkt testen und eine „Time between Go“ einstellen. Sie verhindert unbeabsichtigte Doppelauslösungen.
4. Im Editor Save Changes drücken und den Namen bestätigen.

Das Macro ist jetzt der Taste zugewiesen und in der Library unter Custom gespeichert. Die frühere Blueprint-Auswahl gibt es nicht mehr. Alle Felder erklärt die Seite Befehle & Snapshots.

Default Target: Das hier gewählte Target ist beim Erstellen von Befehlen schon vorausgewählt. Ist für dieses Target außerdem ein Default Plugin gesetzt, ist auch dieses vorausgewählt.

Multi-Step Macro

1. Im Dialog Name und Beschreibung des neuen Macros eintragen.
2. Im Step-Editor darunter die Befehlsfolge einrichten. Die Reihenfolge der Steps änderst du per Drag & Drop.
3. Mit Save Changes speichern.

Das Macro ist der Taste zugewiesen und liegt in der Library unter Custom oder unter dem gesetzten Gerätenamen.

Sequenzen: Press, Next Press, Release

Ein Multi-Step-Macro kann drei getrennte Schrittfolgen enthalten. Nur On Press ist Pflicht, die beiden anderen schaltest du über eine Checkbox im Editor hinzu.

Sequenz	Wann sie läuft	Typischer Einsatz
On Press	Beim normalen Tastendruck	Der Standardfall
On Next Press	Bei jedem zweiten Druck, abwechselnd mit On Press	Toggle: an/aus, Licht auf/ab, Mute/Unmute
On Release	Beim Loslassen der Taste	Button-Up-Aktionen, Aufräumen, Momentary-Verhalten

---

Companion Mode

Im Companion Mode arbeitet die FrenschPress als Satellite-Surface für Bitfocus Companion. Beschriftungen und Farben kommen dann aus Companion.

1. In Companion prüfen, dass der Satellite-Listen-Port auf 16622 steht. Die Weboberfläche verwendet diesen Port fest.
2. Verbindung herstellen: entweder die Companion IP eintragen und mit Save Settings speichern, oder die gefundene FrenschPress in Companion unter Surfaces einrichten.
3. In Companion Startseite und Zuordnung der Surface festlegen.

Connection setup in der Weboberfläche erklärt die Verbindung noch einmal Schritt für Schritt.

LEDs: Solange kein Companion-Host verbunden ist, blinken die LEDs rot. Mit Verbindung zeigen sie die Farben aus Companion. Ohne Feedback aus Companion bleiben sie aus (schwarz).

Die Controller-Vorschau zeigt die Button-Texte, die von Companion ankommen:

Anzeige	Bedeutung
Waiting for Companion	Es ist noch kein Text angekommen.
No text label	Companion liefert für dieses Feld keine Beschriftung.

Die Vorschau ist nur eine Anzeige. Eigene Macros weist du im Custom Mode zu. Ein angeschlossenes Stream Deck kann unabhängig davon lokal arbeiten oder über Stream Deck as Companion surface an Companion übergeben werden (siehe Stream Deck als Companion-Surface).

---

Timecode & Timeline

MTC Master, die MTC-Bridge zwischen den USB-Ports, Art-Net-Timecode und die zeitgesteuerte Timeline haben eine eigene Sektion:

• Timecode Übersicht: MTC Master als Macro-Schritt, Bridge, Live-Anzeige, LED-Feedback
• Art-Net Timecode: Aktivierung, Health-Monitor, Quick Tuning, Transport
• Timeline: Macros framegenau auf Timecode auslösen

---

Stream Deck

Ist ein Stream Deck am USB-Host-Port angeschlossen, erscheint eine eigene Seite Streamdeck. Die Tastenbelegung dort nutzt denselben Macro-Picker wie der Custom Mode, kennt aber keine Button-Sets: ein Macro pro Bedienelement. Siehe Stream Deck konfigurieren.

Tasten belegst du auch direkt am Deck: eine unbelegte Taste 2 Sekunden halten oder im On-Deck-Menü MAP wählen.

---

HID Mode

Statt als MIDI-Gerät kann sich die FrenschPress als USB-Tastatur und -Maus anmelden. Solange HID Mode aktiv ist, sind USB-MIDI und Macros abgeschaltet. Siehe HID Mode.

---

Wenn es nicht klappt

Symptom	Ursache	Abhilfe
Scan blinkt rot	Kein passender QLab-Host gefunden	In QLab OSC aktivieren und den Scan wiederholen. Sonst die Targets manuell einrichten.
Nach dem Encoder-Halten bleibt MSC aktiv	Beim Wechsel zu OSC wurde kein Host gefunden	Wie oben: OSC in QLab prüfen, dann erneut wechseln oder scannen
GO leuchtet nicht grün, obwohl Cues laufen	Kein OSC-Feedback, z. B. bei MSC über USB	Netzwerk-Verbindung (OSC) einrichten
LEDs blinken im Companion Mode rot	Kein Companion-Host verbunden	Companion IP und den Satellite-Port 16622 in Companion prüfen
Companion wird beim Moduswechsel am Gerät übersprungen	Kein Companion-Host eingetragen	Companion IP eintragen und mit Save Settings speichern
< LEFT und RIGHT > öffnen keinen Dialog	Auf PUSH liegt ein Art-Net- oder sACN-Macro, Drehen ist der Master-Fader	Gewollt. Für eine andere Belegung das Lichtmacro vom Push nehmen.
Tasten senden kein MIDI und lösen keine Macros aus	HID Mode ist aktiv	HID Mode in den Einstellungen abschalten