Stream Deck & Companion

Des boutons physiques pour la régie : deux approches, selon que vous voulez juste déclencher des actions ou avoir aussi les retours d'état.

Option A — Actions HTTP directes (sans rien installer)

Le Stream Deck sait appeler une URL. Ajoutez une action « Ouvrir une URL » (ou « Website ») par bouton, avec l'URL de commande v1 :

http://localhost:4141/api/v1/{clé}/start
http://localhost:4141/api/v1/{clé}/pause
http://localhost:4141/api/v1/{clé}/adjust?ms=60000      # +1 min
http://localhost:4141/api/v1/{clé}/adjust?ms=-60000     # −1 min
http://localhost:4141/api/v1/{clé}/next
http://localhost:4141/api/v1/{clé}/message/set?text=Il reste 5 minutes&flash=1
http://localhost:4141/api/v1/{clé}/message/clear
http://localhost:4141/api/v1/{clé}/blackout?on=1
http://localhost:4141/api/v1/{clé}/onair?on=1

Les anciennes URL en /api/v0/… continuent de fonctionner à l'identique : aucune configuration existante n'est à refaire.

Option B — Module Bitfocus Companion (retours d'état inclus)

Un module dédié est fourni dans le dossier integrations/companion/ du projet. Il ajoute :

• toutes les actions (démarrer, pause, ±1 min, suivant, message, écran noir, ON AIR) ;
• des retours d'état colorés sur les boutons : vert = timer en cours, orange = seuil atteint, rouge = dépassement, rouge = ON AIR ;
• des variables affichables sur les boutons : temps restant ($(chronoregie:remaining)), titre courant, intervenant, timer suivant.

Installation (manuelle, hors-ligne)

1. Dans Companion : Settings → Developer, notez le « Developer modules path ».
2. Copiez-y le dossier integrations/companion/ sous le nom companion-module-chronoregie.
3. Redémarrez Companion, ajoutez la connexion « ChronoRégie » et renseignez l'adresse du serveur et la clé API de la salle.

Le détail complet est dans le README.md du module. Le module n'est pas publié sur le dépôt Companion : installation locale uniquement, dans l'esprit 100 % hors-ligne du produit.

Bonnes pratiques

• La limite de l'API est de 100 requêtes / minute / clé — largement suffisante pour un usage au bouton (le module Companion consomme 1 requête / seconde de suivi).
• Si le Stream Deck et la régie sont sur deux machines, remplacez localhost par l'adresse IP locale de la machine régie.
• Prévoyez un bouton « status » (/api/v1/{clé}/status) pour vérifier la liaison sans rien déclencher.