Companion-Modul
Mit dem FrenschPress-Modul für Bitfocus Companion wird die Richtung umgedreht: Nicht die FrenschPress bedient Companion, sondern Companion bedient die FrenschPress.
| Weg | Wer bedient wen | Beschrieben unter |
|---|---|---|
| Companion Mode / Satellite | Die FrenschPress (und optional ein Stream Deck daran) ist eine Bedienfläche für Companion | Companion Mode, Stream Deck als Companion-Surface |
| Companion-Modul | Companion steuert die FrenschPress | diese Seite |
Beides lässt sich auch kombinieren: Companion kann eine FrenschPress als Fläche nutzen und eine andere als Gerät steuern.
Typische Anwendung: Ein Show-Button in Companion soll gleichzeitig das Video starten und die FrenschPress auf Set B umschalten, ihre LEDs einfärben oder eine Timeline scharf schalten.
Installation
Das Modul wird als Paketdatei (.tgz) mitgeliefert. In Companion die Modul-Verwaltung öffnen und das Paket dort installieren. Sobald das Modul über den Bitfocus-Modulstore verfügbar ist, entfällt dieser Schritt – dann reicht die Suche nach FrenschPress.
Verbindung einrichten
In Companion eine neue Connection anlegen und FrenschConnection FrenschPress wählen.
| Feld | Bedeutung |
|---|---|
| Discovered devices | Liste der FrenschPress-Geräte, die sich im Netzwerk ankündigen. Eine Auswahl füllt Host und Port automatisch aus. |
| Host | IP-Adresse oder Hostname des Geräts |
| Port | Der OSC-Eingangsport des Geräts, Standard 53001 |
| HTTP port | Wird nur benutzt, um die Preset-Liste des Geräts zu lesen. Standard 80, kein Login nötig. |
| Poll device status | Holt regelmäßig den Gerätezustand. Aus bedeutet: keine Variablen und keine Feedbacks – das Modul sendet dann nur. |
| Poll interval (ms) | Abstand der Abfragen, Standard 1000 |
Das Modul spricht OSC über UDP. Companion und FrenschPress müssen sich also im selben Netzwerk erreichen können.
Actions
| Action | Was sie macht |
|---|---|
| Set mode | Wechselt zwischen QLab, Custom und Companion |
| Switch button set | Schaltet auf Set A, B oder C – optional nur für ausgewählte Tasten |
| Apply preset | Lädt ein Preset. Die Liste wird vom Gerät geholt; ein Preset kann auch als Name oder über eine Variable angegeben werden. Optional in ein bestimmtes Set. |
| Press a FrenschPress button | Löst STOP, GO oder PAUSE virtuell aus – als tap, press oder release |
| Run a macro | Startet ein Macro über Name oder ID. on, off und toggle wirken auf Snapshot-Macros. |
| Arm timeline / Disarm timeline | Schaltet eine Timeline scharf oder unscharf – über Nummer, Name oder ID |
| Arm all timelines / Disarm all timelines | Dasselbe für alle Timelines auf einmal |
| Set LED colour | Färbt eine LED (STOP, GO, PAUSE oder alle) mit dem Farbwähler |
| Release LED override | Gibt die LED wieder frei – sie zeigt danach ihre normale Farbe |
| Stream Deck: press a key | Löst eine Taste des angeschlossenen Stream Decks über Reihe und Spalte aus |
| Stream Deck: set key feedback | Setzt den Zustand einer Deck-Taste: einzelne Taste, Reihe/Spalte, alle Tasten oder alles zurück auf lokal |
Feedbacks
| Feedback | Wird wahr, wenn |
|---|---|
| Mode is | Das Gerät im gewählten Mode ist |
| Button set is | Das gewählte Set aktiv ist – wahlweise für die ganze FrenschPress oder für eine einzelne Taste |
| QLab has running cues | In QLab mindestens ein Cue läuft |
| QLab is paused | QLab pausiert ist |
Variablen
$(frenschpress:…) – Gerätename, Firmware-Version, MAC-Adresse, IP-Adresse, Mode, QLab-Transport, aktives Button-Set, Set je Taste sowie die QLab-Zustände (laufend, pausiert, Feedback abonniert).
Mitgelieferte Buttons (Presets)
Fertige Companion-Buttons mit passenden Feedbacks: Mode QLab / Macro / Companion, Set A / B / C, STOP / GO / PAUSE, QLab running, QLab paused sowie zwei LED-Buttons (Farbe halten, solange gedrückt – und Freigabe).
Wenn nichts ankommt
| Symptom | Prüfen |
|---|---|
| Keine Variablen, keine Feedbacks | Ist Poll device status eingeschaltet? |
| Verbindung bleibt rot | Host und Port – der Port muss dem OSC-Eingangsport des Geräts entsprechen |
| Preset-Liste leer | HTTP-Port stimmt nicht, oder das Gerät ist über HTTP nicht erreichbar |
| Zustand aktualisiert sich träge | Poll-Intervall verkleinern (Minimum 250 ms) |
Die FrenschPress beantwortet Statusabfragen höchstens alle 100 ms je Absender. Ein Poll-Intervall unter 250 ms bringt deshalb nichts.