Piloter vos écrans avec Bitfocus Companion et un Stream Deck

Bitfocus Companion est un logiciel gratuit qui transforme un Elgato Stream Deck, ou les boutons d'un navigateur web, en pupitre de commande pour toute votre production. Avec la connexion Screenbird dans Companion, une seule pression lance une scène sur tous ses écrans, et le bouton s'allume à la couleur de la scène tant qu'elle est en direct. Entre ces moments, vos écrans continuent de tourner tout seuls.

Il vous faut :

Companion 4.3 ou une version plus récente.
Un jeton API Screenbird.
Pour les boutons de scène : les scènes activées et au moins une scène. Le détail est ici : Commander plusieurs écrans à la fois avec les scènes. Sans les scènes, Companion peut quand même envoyer du contenu vers un écran et l'arrêter.

Créer un jeton API

Allez dans Paramètres > Connexions.
Sous Jetons API, cliquez sur Nouveau jeton API.
Donnez un nom au jeton, par exemple le nom du lieu ou du Stream Deck.
Sous Accès, choisissez Piloter les écrans et les scènes.
Cliquez sur Créer le jeton et copiez le jeton. Il ne s'affiche qu'une seule fois.

Le jeton fonctionne dans l'équipe active au moment où vous le créez. Pour les écrans d'une autre équipe, passez d'abord dans cette équipe et créez un jeton distinct. Utilisez un jeton par connexion Companion.

Plus d'informations sur les jetons : Jetons API.

Ajouter Screenbird dans Companion

Dans Companion, allez dans Connections, cherchez Screenbird et ajoutez-le.
Collez le jeton sous API token et enregistrez.
Ouvrez les préréglages de la connexion et faites glisser les boutons sur votre Stream Deck.

Laissez API address telle quelle, sauf si l'assistance Screenbird vous indique une autre adresse.

L'ordinateur qui exécute Companion doit pouvoir établir des connexions sortantes en HTTPS et en WebSocket sécurisé (WSS) sur le port 443 vers api.screenbird.app. Sans connexion internet fonctionnelle, les boutons ne marchent pas.

Les boutons

Les préréglages sont répartis en trois groupes.

Scenes

Go : un bouton par scène, à la couleur de la scène.
Stop : un bouton par scène, qui remet cette scène à la normale. Il est sombre, avec le nom de la scène dans une teinte claire de sa couleur.

Control

STOP ALL remet tout à la normale. Il est rouge foncé.
NEXT lance la scène qui suit celle que vous avez lancée en dernier, dans l'ordre de la page Scènes du tableau de bord. Il affiche le nom de cette scène.

Screens

Un bouton stop par écran ou sous-écran. Il passe au rouge foncé tant qu'une scène ou un contenu envoyé est affiché sur cet écran.

La couleur d'un bouton de scène indique son état :

Sombre : la scène est désactivée.
Pleine couleur : la scène est en direct sur tous ses écrans.
Demi-luminosité : la scène est partiellement en direct. Certains de ses écrans affichent autre chose, ou la scène est encore à l'écran depuis plus tôt.
Ambre, avec « (changed) » dans le texte : la scène a été modifiée après son passage en direct. Appuyez de nouveau dessus pour mettre les modifications en direct.

Les boutons suivent les changements immédiatement, y compris quand quelqu'un lance une scène depuis le tableau de bord, depuis un téléphone ou à une heure programmée. Une nouvelle scène ou un nouvel écran apparaît tout seul dans les préréglages.

Les actions

Utilisez ces actions sur vos propres boutons :

Scene: go : affiche la scène sur tous ses écrans. Si la scène a été modifiée depuis son passage en direct, un nouvel appui met les modifications en direct.
Scene: stop : arrête cette scène. Ses écrans reviennent à leur propre contenu.
Scene: next : passe à la scène qui suit celle qui a été activée en dernier.
Stop all : arrête toutes les scènes et tous les contenus envoyés. Le partage d'écran continue.
Screen: push content : affiche un contenu sur un écran ou un sous-écran, pendant un certain nombre de minutes ou jusqu'à l'arrêt. Vous choisissez le contenu dans une liste qui regroupe les fichiers, designs, applications, écrans divisés et listes de lecture de l'équipe.
Screen: stop : arrête un contenu envoyé ou une scène sur un écran ou un sous-écran.

Les retours visuels

Utilisez ces retours (feedbacks) pour modifier l'apparence d'un bouton :

Scene is live, Scene is partly live et Scene changed since it went live.
Screen shows : une scène, un contenu envoyé, un partage d'écran ou le contenu normal.
Screen is online.

Les variables

Utilisez des variables dans le texte d'un bouton, par exemple $(screenbird:last_scene). Si vous avez renommé la connexion, utilisez son nom à la place de « screenbird ».

last_scene : la scène activée en dernier.
next_scene : la scène que lance Scene: next.
live_scenes : les scènes en direct.
screens_online et screens_total : les écrans en ligne, et le nombre total d'écrans.

En cas de problème

Authentication failure : le jeton n'est pas valide ou a été révoqué. Créez un nouveau jeton et collez-le dans les paramètres de la connexion.
Insufficient permissions : le jeton n'a pas accès aux écrans, ou la personne qui l'a créé a perdu son accès. Créez un jeton avec l'accès Piloter les écrans et les scènes.
Connection failure qui mentionne l'adresse de l'API : quelque chose répond qui n'est pas Screenbird, par exemple une page de connexion Wi-Fi, ou l'adresse est incorrecte. Vérifiez le réseau et l'API address.
Waiting for the live connection qui ne disparaît pas, ou Live updates unavailable : un pare-feu ou un proxy bloque peut-être le trafic WebSocket vers api.screenbird.app. Les boutons fonctionnent toujours, mais leurs couleurs ne se mettent à jour qu'après un appui.
No active subscription : le compte Screenbird n'est pas actif. La connexion vérifie de nouveau toutes les 5 minutes.
Aucun bouton de scène : les scènes sont désactivées. Le propriétaire les active sous Paramètres > Avancé. Les boutons apparaissent alors tout seuls, sans redémarrer Companion.

Révoquer un jeton

Cliquez sur Révoquer à côté du jeton dans Paramètres > Connexions. Tout ce qui l'utilise s'arrête aussitôt. Voir Jetons API.