Bitfocus Companion
Cliqer lässt sich in Bitfocus Companion integrieren, die beliebte Open-Source-Software zur Tastensteuerung für Live-Produktionen. Das Cliqer-Modul wird automatisch installiert, sobald Cliqer Companion auf Ihrem System erkennt, eine manuelle Einrichtung entfällt also.
So funktioniert es
Cliqer betreibt zwei Loopback-Server, mit denen sich das Modul verbindet: eine HTTP-Aktions-API auf 127.0.0.1:24601 für Tastenaktionen und einen WebSocket auf 127.0.0.1:9052, der Live-Timer-Updates und den App-Status für Feedbacks und Variablen streamt.
Einrichtung
Companion installieren
Installieren Sie Bitfocus Companion und starten Sie es mindestens einmal
Cliqer starten
Starten Sie Cliqer, es legt das Cliqer-Modul im Modulordner von Companion ab
Cliqer-Verbindung hinzufügen
Starten Sie Companion einmal neu, damit es das Modul erkennt, und fügen Sie dann eine Cliqer-Verbindung hinzu (sie verweist auf 127.0.0.1, Port der Aktions-API 24601)
Verfügbare Aktionen
Das Modul bietet 19 Aktionen, nach Kategorien gruppiert:
| Kategorie | Aktionen |
|---|---|
| Click | Left Click, Right Click |
| Timer | Start / Pause Timer, Reset Timer, +1 / +2 / +5 Minutes, −1 / −2 / −5 Minutes |
| Presets | Timer Preset 1 / 2 / 3 / 4 (5, 10, 15, 20 Minuten) |
| Callers | Caller to Program (Anrufer 1-9 wählen), Clear Program (Schnitt auf Schwarz) |
| Control | Stop Screen Share, Toggle Program NDI Output, Toggle Timer NDI Output |
Feedbacks
Feedbacks ändern das Aussehen einer Taste anhand des Live-Status. Das Modul definiert 11 Feedbacks:
| Feedback | Aktiv, wenn |
|---|---|
| Timer Running | Der Timer aktiv zählt |
| Timer Stopped | Der Timer pausiert ist |
| Timer Green (Talk Phase) | Der Timer läuft und noch reichlich Zeit bleibt |
| Timer Overtime | Der Timer im Countdown-Modus 0:00 überschritten hat |
| Timer Yellow (Warning Phase) | Der Timer sich seinem Limit nähert oder pausiert ist |
| Timer Red Flash (At Zero / Overtime) | Blinkt, wenn der Timer null erreicht bzw. in die Überziehung läuft |
| Caller On Air (Program) | Der ausgewählte Anrufer live auf dem Program-Bus ist |
| Caller Connected | Auf dem ausgewählten Anrufer-Slot ein Anrufer verbunden ist |
| Screen Share Active | Eine Bildschirmfreigabe auf dem Program-Feed liegt |
| Program NDI Output Active | Der Program-NDI-Ausgang eingeschaltet ist |
| Timer NDI Output Active | Der Timer-NDI-Ausgang eingeschaltet ist |
Variablen
Das Modul stellt 14 Variablen für Tastentexte und Trigger bereit. Sprechen Sie sie über die Verbindungsbezeichnung an, zum Beispiel $(Cliqer:timer_display), wenn die Verbindung Cliqer heißt:
| Variable | Beschreibung | Beispiel |
|---|---|---|
timer_display | Aktueller Timerwert (MM:SS) | 14:30 |
timer_minutes | Minutenanteil | 14 |
timer_seconds | Sekundenanteil | 30 |
timer_state | Timerstatus | running / stopped |
preset1_label … preset4_label | Preset-Dauern (MM:SS) | 05:00 |
program_caller | Name des Anrufers, der aktuell auf dem Programm ist | Jane |
callers_count | Verbundene Anrufer | 3 |
viewers_count | Publikum / Zuschauer | 128 |
presenters_count | Verbundene Vortragende | 2 |
room_id | Aktuelle Raum-ID | ABC123 |
room_url | Teilbarer Raumlink | https://cliqer.io/ABC123 |
Presets
Das Modul enthält fertige Tasten-Presets, mit denen Sie per Drag-and-drop eine Bedienoberfläche aufbauen, gruppiert in dieselben Kategorien wie die Aktionen: Click, Timer, Presets, Callers und Control. Ziehen Sie sie auf eine Companion-Seite, um Folien, Timer, Anrufer und Ausgänge sofort zu steuern.
Plattformunterstützung
| Plattform | Speicherort der automatischen Installation |
|---|---|
| macOS | ~/Library/Application Support/companion/modules/ |
| Windows | %APPDATA%\companion\modules\ |
Das Modul wird in einem Ordner cliqer-cliqer-<version> in diesem Verzeichnis abgelegt (zum Beispiel cliqer-cliqer-1.2.2). Wenn Cliqer ein Update installiert, entfernt es zuerst den Ordner der vorherigen Version, sodass nur die aktuelle Version übrig bleibt.
Fehlerbehebung
Modul erscheint nicht in Companion
- Stellen Sie sicher, dass Companion installiert ist und vor Cliqer mindestens einmal gestartet wurde
- Companion durchsucht seinen Modulordner nur beim Start, starten Sie Companion daher nach dem ersten Start von Cliqer einmal neu, dann erscheint der Verbindungstyp Cliqer
- Die Schaltfläche Refresh modules in Companion aktualisiert den Online-Store, nicht den lokalen Modulordner, starten Sie Companion daher neu, damit ein frisch installiertes Modul angezeigt wird
Aktionen werden nicht ausgelöst
- Prüfen Sie, ob die Verbindung auf
127.0.0.1mit dem Aktions-API-Port24601zeigt - Behalten Sie den Standardport des Moduls bei: Cliqer stellt die Aktions-API auf
24601bereit - Nur eine Cliqer-Instanz kann die lokalen Ports auf einem Rechner belegen, siehe die Hinweise zu Stream Deck
Timer-Feedbacks oder Variablen werden nicht aktualisiert
- Der Live-Feed für Timer und App-Status nutzt den Loopback-WebSocket auf Port
9052, daher muss Companion auf demselben Computer wie Cliqer laufen - Folien- und Timer-Aktionen können über HTTP weiterhin erfolgreich sein, auch wenn der Feed nicht verbunden ist. Wenn Tasten also auslösen, Feedbacks aber statisch bleiben, prüfen Sie den Verbindungsstatus in Companion
Siehe auch: Stream-Deck-Integration · Timer