Bildschirme mit Bitfocus Companion und einem Stream Deck steuern

Bitfocus Companion ist kostenlose Software, die ein Elgato Stream Deck oder die Schaltflächen in einem Webbrowser zu einem Bedienfeld für deine ganze Produktion macht. Mit der Screenbird-Verbindung in Companion schaltet ein Druck eine Szene auf allen ihren Bildschirmen live, und die Schaltfläche leuchtet in der Farbe der Szene, solange sie live ist. Zwischen diesen Momenten laufen deine Bildschirme ganz von selbst weiter.

Das brauchst du:

Companion 4.3 oder neuer.
Ein API-Token von Screenbird.
Für die Szenen-Schaltflächen: eingeschaltete Szenen und mindestens eine Szene. Wie das geht, steht in Viele Bildschirme auf einmal umschalten mit Szenen. Ohne Szenen kann Companion trotzdem Inhalte an einen Bildschirm senden und wieder stoppen.

Ein API-Token erstellen

Gehe zu Einstellungen > Verbindungen.
Klicke unter API-Tokens auf Neues API-Token.
Gib dem Token einen Namen, zum Beispiel den Namen des Veranstaltungsorts oder des Stream Decks.
Wähle unter Zugriff die Option Bildschirme und Szenen steuern.
Klicke auf Token erstellen und kopiere das Token. Du siehst es nur ein einziges Mal.

Das Token gilt in dem Team, das beim Erstellen aktiv ist. Für die Bildschirme eines anderen Teams wechselst du zuerst zu diesem Team und erstellst ein eigenes Token. Nutze pro Companion-Verbindung ein eigenes Token.

Mehr zu Tokens: API-Tokens.

Screenbird in Companion hinzufügen

Gehe in Companion zu Connections, suche nach Screenbird und füge es hinzu.
Füge das Token bei API token ein und speichere.
Öffne die Presets der Verbindung und ziehe die Schaltflächen auf dein Stream Deck.

Lass API address unverändert, es sei denn, der Screenbird-Support nennt dir eine andere Adresse.

Der Computer, auf dem Companion läuft, braucht ausgehenden Zugriff per HTTPS und sicherem WebSocket (WSS) auf Port 443 zu api.screenbird.app. Ohne funktionierende Internetverbindung funktionieren die Schaltflächen nicht.

Die Schaltflächen

Die Presets gibt es in drei Gruppen.

Scenes

Go: eine Schaltfläche pro Szene, in der Farbe der Szene.
Stop: eine Schaltfläche pro Szene, die diese Szene zurücksetzt. Sie ist dunkel, mit dem Namen der Szene in einer helleren Version ihrer Farbe.

Control

STOP ALL setzt alles zurück. Die Schaltfläche ist dunkelrot.
NEXT startet die Szene nach der, die du zuletzt gestartet hast, in der Reihenfolge von Szenen im Dashboard. Die Schaltfläche zeigt den Namen dieser Szene.

Screens

Eine stop-Schaltfläche pro Bildschirm oder Sub-Bildschirm. Sie wird dunkelrot, solange auf diesem Bildschirm eine Szene oder gesendeter Inhalt läuft.

Die Farbe einer Szenen-Schaltfläche zeigt den Zustand:

Dunkel: Die Szene ist aus.
Volle Farbe: Die Szene ist auf allen ihren Bildschirmen live.
Halb hell: Die Szene ist teilweise live. Einige ihrer Bildschirme zeigen etwas anderes, oder die Szene läuft noch von früher.
Bernstein, mit „(changed)“ im Text: Die Szene wurde bearbeitet, nachdem sie live gegangen ist. Drücke sie erneut, um die Änderungen live zu schalten.

Die Schaltflächen folgen Änderungen sofort, auch wenn jemand eine Szene im Dashboard, auf einem Smartphone oder zu einer festen Zeit startet. Eine neue Szene oder ein neuer Bildschirm erscheint von selbst in den Presets.

Aktionen

Nutze diese Aktionen auf deinen eigenen Schaltflächen:

Scene: go: Zeige die Szene auf allen ihren Bildschirmen. Hat sich die Szene geändert, seit sie live ging, schaltet ein erneuter Druck die Änderungen live.
Scene: stop: Stoppe diese Szene. Ihre Bildschirme kehren zu ihrem eigenen Inhalt zurück.
Scene: next: Wechsle zu der Szene nach der, die zuletzt aktiviert wurde.
Stop all: Stoppe alle Szenen und alle gesendeten Inhalte. Eine Bildschirmfreigabe läuft weiter.
Screen: push content: Zeige Inhalt auf einem Bildschirm oder Sub-Bildschirm, für eine bestimmte Zahl von Minuten oder bis zum Stoppen. Du wählst den Inhalt aus einer Liste mit den Dateien, Designs, Apps, Split Screens und Playlists des Teams.
Screen: stop: Stoppe gesendeten Inhalt oder eine Szene auf einem Bildschirm oder Sub-Bildschirm.

Feedbacks

Mit diesen Feedbacks änderst du das Aussehen einer Schaltfläche:

Scene is live, Scene is partly live und Scene changed since it went live.
Screen shows: eine Szene, gesendeter Inhalt, eine Bildschirmfreigabe oder normaler Inhalt.
Screen is online.

Variablen

Nutze Variablen im Text einer Schaltfläche, zum Beispiel $(screenbird:last_scene). Hast du die Verbindung umbenannt, nimm ihren Namen statt „screenbird“.

last_scene: die zuletzt aktivierte Szene.
next_scene: die Szene, die Scene: next startet.
live_scenes: die Szenen, die live sind.
screens_online und screens_total: die Zahl der Bildschirme online und die Gesamtzahl der Bildschirme.

Wenn etwas nicht funktioniert

Authentication failure: Das Token ist ungültig oder wurde widerrufen. Erstelle ein neues Token und füge es in den Einstellungen der Verbindung ein.
Insufficient permissions: Das Token hat keinen Zugriff auf Bildschirme, oder die Person, die es erstellt hat, hat selbst keinen Zugriff mehr. Erstelle ein Token mit dem Zugriff Bildschirme und Szenen steuern.
Connection failure mit einem Hinweis auf die API-Adresse: Es antwortet etwas, das nicht Screenbird ist, zum Beispiel eine WLAN-Anmeldeseite, oder die Adresse stimmt nicht. Prüfe das Netzwerk und die API address.
Waiting for the live connection, das nicht verschwindet, oder Live updates unavailable: Möglicherweise blockiert eine Firewall oder ein Proxy den WebSocket-Verkehr zu api.screenbird.app. Die Schaltflächen funktionieren weiter, aber ihre Farben aktualisieren sich erst nach einem Druck.
No active subscription: Das Screenbird-Konto ist nicht aktiv. Die Verbindung prüft das alle 5 Minuten erneut.
Keine Szenen-Schaltflächen: Szenen sind ausgeschaltet. Der Besitzer schaltet sie unter Einstellungen > Erweitert ein. Die Schaltflächen erscheinen dann von selbst, ohne dass du Companion neu starten musst.

Ein Token stoppen

Klicke neben dem Token unter Einstellungen > Verbindungen auf Widerrufen. Alles, was es nutzt, stoppt sofort. Siehe API-Tokens.