Je schermen bedienen met Bitfocus Companion en een Stream Deck

Bitfocus Companion is gratis software die een Elgato Stream Deck, of de knoppen in een webbrowser, verandert in een bedieningspaneel voor je hele productie. Met de Screenbird-koppeling in Companion zet één druk op de knop een scene live op al zijn schermen, en de knop licht op in de kleur van de scene zolang die live is. Tussen die momenten draaien je schermen gewoon zelf door.

Dit heb je nodig:

  • Companion 4.3 of nieuwer.
  • Een API-token van Screenbird.
  • Voor de scene-knoppen: Scenes aangezet en minstens één scene. Hoe dat werkt, lees je in Veel schermen tegelijk omzetten met Scenes. Zonder Scenes kan Companion nog wel content naar een scherm sturen en die weer stoppen.

Een API-token maken

  1. Ga naar Instellingen > Koppelingen.
  2. Klik onder API-tokens op Nieuw API-token.
  3. Geef het token een naam, bijvoorbeeld de naam van de locatie of van de Stream Deck.
  4. Kies onder Toegang voor Schermen en scenes bedienen.
  5. Klik op Token maken en kopieer het token. Je ziet het maar één keer.

Het token werkt in het team dat actief is op het moment dat je het maakt. Voor de schermen van een ander team schakel je eerst naar dat team en maak je een apart token. Gebruik één token per Companion-koppeling.

Meer over tokens: API-tokens.

Screenbird toevoegen in Companion

  1. Ga in Companion naar Connections, zoek Screenbird en voeg het toe.
  2. Plak het token bij API token en sla op.
  3. Open de presets van de koppeling en sleep de knoppen naar je Stream Deck.

Laat API address staan zoals het is, tenzij de support van Screenbird je een ander adres geeft.

De computer waarop Companion draait, heeft uitgaande toegang nodig via HTTPS en beveiligde WebSocket (WSS) op poort 443 naar api.screenbird.app. Zonder werkende internetverbinding werken de knoppen niet.

De knoppen

De presets zijn verdeeld in drie groepen.

Scenes

  • Go: één knop per scene, in de kleur van de scene.
  • Stop: één knop per scene die die scene weer normaal zet. De knop is donker, met de naam van de scene in een lichtere versie van zijn kleur.

Control

  • STOP ALL zet alles weer normaal. De knop is donkerrood.
  • NEXT start de scene na de scene die je als laatste startte, in de volgorde van Scenes in het dashboard. De knop toont de naam van die scene.

Screens

  • Eén stop-knop per scherm of sub-scherm. De knop wordt donkerrood zolang er een scene of gestuurde content op dat scherm staat.

De kleur van een scene-knop vertelt je de status:

  • Donker: de scene staat uit.
  • Volle kleur: de scene is live op al zijn schermen.
  • Half licht: de scene is deels live. Sommige schermen tonen iets anders, of de scene staat nog van eerder in beeld.
  • Amber, met "(changed)" in de tekst: de scene is aangepast nadat hij live ging. Druk er opnieuw op om de wijzigingen live te zetten.

De knoppen volgen wijzigingen direct, ook als iemand een scene start in het dashboard, op een telefoon of op een ingesteld tijdstip. Een nieuwe scene of een nieuw scherm verschijnt vanzelf in de presets.

Acties

Gebruik deze acties op je eigen knoppen:

  • Scene: go: toon de scene op al zijn schermen. Is de scene veranderd sinds hij live ging, dan zet je met nog een druk de wijzigingen live.
  • Scene: stop: stop deze scene. Zijn schermen gaan terug naar hun eigen content.
  • Scene: next: ga naar de scene na de scene die als laatste is geactiveerd.
  • Stop all: stop alle scenes en alle gestuurde content. Een gedeeld scherm blijft doorlopen.
  • Screen: push content: toon content op één scherm of sub-scherm, voor een aantal minuten of totdat je stopt. Je kiest de content uit een lijst met de bestanden, ontwerpen, apps, split screens en afspeellijsten van het team.
  • Screen: stop: stop gestuurde content of een scene op één scherm of sub-scherm.

Feedbacks

Met deze feedbacks verander je het uiterlijk van een knop:

  • Scene is live, Scene is partly live en Scene changed since it went live.
  • Screen shows: een scene, gestuurde content, een gedeeld scherm of normale content.
  • Screen is online.

Variabelen

Gebruik variabelen in knoptekst, bijvoorbeeld $(screenbird:last_scene). Heb je de koppeling hernoemd, gebruik dan die naam in plaats van "screenbird".

  • last_scene: de scene die als laatste is geactiveerd.
  • next_scene: de scene die Scene: next start.
  • live_scenes: de scenes die live zijn.
  • screens_online en screens_total: het aantal schermen online en het totale aantal schermen.

Als er iets niet werkt

  • Authentication failure: het token is ongeldig of ingetrokken. Maak een nieuw token en plak het in de instellingen van de koppeling.
  • Insufficient permissions: het token heeft geen toegang tot schermen, of degene die het maakte, heeft zelf geen toegang meer. Maak een token met toegang Schermen en scenes bedienen.
  • Connection failure met een melding over het API-adres: er antwoordt iets wat Screenbird niet is, bijvoorbeeld een wifi-inlogpagina, of het adres klopt niet. Controleer het netwerk en het API address.
  • Waiting for the live connection die niet verdwijnt, of Live updates unavailable: een firewall of proxy blokkeert mogelijk WebSocket-verkeer naar api.screenbird.app. De knoppen werken dan nog wel, maar hun kleuren verversen pas na een druk.
  • No active subscription: het Screenbird-account is niet actief. De koppeling controleert dit elke 5 minuten opnieuw.
  • Geen scene-knoppen: Scenes staat uit. De eigenaar zet het aan onder Instellingen > Geavanceerd. De knoppen verschijnen dan vanzelf, zonder dat je Companion hoeft te herstarten.

Een token stoppen

Klik naast het token in Instellingen > Koppelingen op Intrekken. Alles wat het token gebruikt, stopt direct. Zie API-tokens.

© screenbird.app