Bitfocus Companion
Cliqer integreert met Bitfocus Companion, de populaire opensourcesoftware voor knopbediening bij live producties. De Cliqer-module wordt automatisch geïnstalleerd zodra Cliqer Companion op je systeem detecteert, dus je hoeft niets handmatig in te stellen.
Zo werkt het
Cliqer draait twee loopbackservers waarmee de module verbinding maakt: een HTTP-actie-API op 127.0.0.1:24601 voor knopacties en een WebSocket op 127.0.0.1:9052 die live timerupdates en de app-status streamt voor feedbacks en variabelen.
Installatie
Companion installeren
Installeer Bitfocus Companion en start het minstens één keer
Cliqer starten
Start Cliqer: de app plaatst de Cliqer-module in de modulemap van Companion
Een Cliqer-verbinding toevoegen
Herstart Companion één keer zodat de module wordt ingelezen en voeg daarna een Cliqer-verbinding toe (deze wijst naar 127.0.0.1, actie-API-poort 24601)
Beschikbare acties
De module biedt 19 acties, gegroepeerd per categorie:
| Categorie | Acties |
|---|---|
| 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 (kies inbeller 1-9), Clear Program (naar zwart) |
| Control | Stop Screen Share, Toggle Program NDI Output, Toggle Timer NDI Output |
Feedbacks
Feedbacks passen het uiterlijk van een knop aan op basis van de live status. De module definieert 11 feedbacks:
| Feedback | Actief wanneer |
|---|---|
| Timer Running | De timer telt actief |
| Timer Stopped | De timer is gepauzeerd |
| Timer Green (Talk Phase) | De timer loopt en er is nog ruim tijd |
| Timer Overtime | De timer is in aftelmodus voorbij 0:00 |
| Timer Yellow (Warning Phase) | De timer nadert zijn limiet of is gepauzeerd |
| Timer Red Flash (At Zero / Overtime) | Knippert wanneer de timer nul bereikt / in overtijd gaat |
| Caller On Air (Program) | De geselecteerde inbeller is live op de programmabus |
| Caller Connected | Op de geselecteerde inbellerplek is een inbeller verbonden |
| Screen Share Active | Er staat een schermdeling op de programmafeed |
| Program NDI Output Active | De programma-NDI-uitvoer staat aan |
| Timer NDI Output Active | De timer-NDI-uitvoer staat aan |
Variabelen
De module stelt 14 variabelen beschikbaar voor gebruik in knopteksten en triggers. Verwijs ernaar via het verbindingslabel, bijvoorbeeld $(Cliqer:timer_display) als de verbinding Cliqer heet:
| Variabele | Beschrijving | Voorbeeld |
|---|---|---|
timer_display | Huidige timerwaarde (MM:SS) | 14:30 |
timer_minutes | Minutendeel | 14 |
timer_seconds | Secondendeel | 30 |
timer_state | Timerstatus | running / stopped |
preset1_label … preset4_label | Presetduren (MM:SS) | 05:00 |
program_caller | Naam van de inbeller die nu op programma staat | Jane |
callers_count | Verbonden inbellers | 3 |
viewers_count | Publiek / kijkers | 128 |
presenters_count | Verbonden presentatoren | 2 |
room_id | Huidige ruimte-ID | ABC123 |
room_url | Deelbare link naar de ruimte | https://cliqer.io/ABC123 |
Presets
De module wordt geleverd met kant-en-klare knoppresets, zodat je een bedieningspaneel bouwt door simpelweg te slepen. Ze zijn gegroepeerd in dezelfde categorieën als de acties: Click, Timer, Presets, Callers en Control. Zet ze op een Companion-pagina voor directe bediening van slides, timer, inbellers en uitvoer.
Platformondersteuning
| Platform | Locatie automatische installatie |
|---|---|
| macOS | ~/Library/Application Support/companion/modules/ |
| Windows | %APPDATA%\companion\modules\ |
De module wordt in die map geplaatst in een submap cliqer-cliqer-<version> (bijvoorbeeld cliqer-cliqer-1.2.2). Wanneer Cliqer een update installeert, verwijdert de app eerst de map van de vorige versie, zodat alleen de huidige versie overblijft.
Probleemoplossing
Module verschijnt niet in Companion
- Zorg dat Companion is geïnstalleerd en minstens één keer is gestart vóór Cliqer
- Companion scant zijn modulemap alleen bij het opstarten, dus herstart Companion één keer na de eerste start van Cliqer, waarna het verbindingstype Cliqer verschijnt
- De knop Refresh modules in Companion vernieuwt de online store, niet de lokale modulemap, dus herstart Companion om een net geïnstalleerde module zichtbaar te maken
Acties worden niet uitgevoerd
- Controleer of de verbinding naar
127.0.0.1wijst op actie-API-poort24601 - Houd de standaardpoort van de module aan: Cliqer biedt de actie-API aan op
24601 - Er kan maar één Cliqer-instantie de lokale poorten op een computer gebruiken, zie de Stream Deck-notities
Timerfeedbacks of variabelen worden niet bijgewerkt
- De live feed met timer en app-status gebruikt de loopback-WebSocket op poort
9052, dus Companion moet op dezelfde computer draaien als Cliqer - Slide- en timeracties kunnen via HTTP nog steeds slagen, ook als de feed niet verbonden is; reageren knoppen wel maar blijven feedbacks statisch, controleer dan de verbindingsstatus in Companion
Zie ook: Stream Deck-integratie · Timer