Boutons et déclencheurs : piloter les lumières et le matériel autour de la borne

Une borne travaille rarement seule : un bouton arcade lance la session, les flashs de studio partent au décompte, un pont Hue rallume la salle entre deux groupes. Froozbooth gère les boutons physiques sans réglage et envoie chaque étape de la session à votre matériel. Voici ce qu’il envoie, et comment.

Boutons physiques : arcade, pédale, télécommande

Branchez un bouton en USB : il fonctionne, sans rien régler. Sur l’écran d’accueil, un appui lance la session ; sur la visée, il prend la photo ou arrête la vidéo. Ailleurs, il ne fait rien : ces écrans demandent un choix qu’un bouton unique ne peut pas exprimer.

  • Encodeurs « clavier », pédales USB et télécommandes de présentation : Espace, Entrée, Page suivante et précédente, flèches, F13 à F15 ou lecture/pause.
  • Encodeurs arcade « zero delay », vus par Windows comme une manette : n’importe quel bouton.
  • Deux appuis à moins de 400 ms d’écart comptent pour un : un contact qui rebondit ne prend pas deux photos.

Déclencheurs : un webhook ou un programme à chaque événement

Pour le reste, il y a les déclencheurs. Chacun se règle dans l’administration de la borne, écoute les événements choisis, et appelle une URL ou lance un programme sur le PC de la borne.

  • WebhookUn POST HTTP avec un corps JSON, signé en HMAC-SHA256 avec votre secret. En-têtes : X-Froozbooth-Event, X-Froozbooth-Timestamp, X-Froozbooth-Signature.
  • ProgrammeUn exécutable du PC de la borne, désigné par un chemin absolu et autorisé dans la liste blanche du service matériel. Arguments nommés : --event, --session, --booth-event, --ts, --device, puis les données de l’événement.

Les 17 événements à écouter

  • Session : session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled.
  • Sorties : print.sent, print.done, share.email.sent, share.qr.shown.
  • Erreurs : error.capture, error.compose, error.print, error.camera, error.disk, error.license.

Chaque message porte une version de format (v), le nom de l’événement, un horodatage ISO 8601, l’identifiant de session, celui de l’événement, celui de la machine, et un objet data propre à l’événement.

Pensé pour une soirée en direct

  • Un déclencheur ne retarde jamais la session : sans réponse au bout de 2 secondes, la borne continue.
  • Trois nouvelles tentatives, après 0,5, 2 et 5 secondes. Plus tard, un flash tomberait après la pose.
  • Un événement de plus de 60 secondes est journalisé, pas rejoué : après un redémarrage, pas d’éclair en plein dîner.
  • Un bouton Tester envoie un événement d’essai et affiche la réponse, une heure avant l’ouverture des portes.
  • Les 200 derniers envois sont journalisés avec statut, code et latence, et s’exportent en CSV.

Recettes prêtes à l’emploi

  • Flash de studio au début du décompte, via une passerelle DMX ou Art-Net.
  • Une impulsion ou un son à chaque prise.
  • Retour à l’éclairage d’ambiance en fin de session, via un pont Philips Hue.

Appareils, imprimantes et PC : le matériel que Froozbooth pilote directement est sur la page matériel. Logiciel photobooth Canon et Nikon : appareils et imprimantes compatibles

Vous avez vu les fonctionnalités, maintenant comparez les offres et lancez votre essai. Voir le comparatif 2026 vs LumaBooth, dslrBooth, Sparkbooth, Simple Booth

Questions fréquentes

Un bouton arcade fonctionne-t-il avec Froozbooth ?

Oui. Un encodeur « clavier » ou « zero delay » branché en USB fonctionne sans réglage : un appui lance la session sur l’écran d’accueil et prend la photo sur la visée.

Froozbooth peut-il piloter des lumières DMX ou une machine à fumée ?

Par un déclencheur. Froozbooth envoie l’événement à un webhook ou à un programme, et votre passerelle DMX ou Art-Net, votre pont Hue ou votre script pilote l’appareil.

Comment vérifier qu’un webhook vient bien de la borne ?

Calculez le HMAC-SHA256 du corps brut de la requête avec votre secret et comparez-le à l’en-tête X-Froozbooth-Signature. Le champ ts, dans le corps signé, permet de refuser les requêtes anciennes.

Un déclencheur lent peut-il faire attendre les invités ?

Non. Un déclencheur dispose de 2 secondes ; au-delà, la borne continue et retente en arrière-plan.

Peut-on prendre la photo avec une pédale ou une télécommande de présentation ?

Oui. Froozbooth reconnaît sans réglage les pédales USB et les télécommandes de présentation, du moment qu’elles envoient Espace, Entrée, Page suivante ou précédente, une flèche, F13 à F15 ou lecture/pause. Un appui lance la session sur l’écran d’accueil, et prend la photo ou arrête la vidéo sur la visée. Sur les autres écrans, il ne fait rien : ils demandent un choix qu’un bouton unique ne peut pas exprimer.

Que se passe-t-il si un invité appuie deux fois sur le bouton de la borne ?

Froozbooth compte pour un seul deux appuis à moins de 400 ms d’écart : un contact qui rebondit ou un double appui rapide ne prend pas deux photos. Un appui sur un écran qui demande un choix, comme celui du mode, ne fait rien.

Quels événements de la borne peuvent déclencher un webhook ?

Froozbooth propose 17 événements : les étapes de la session (session.start, countdown.start, shot.taken, shots.done, compose.done, session.end, session.cancelled), les sorties (print.sent, print.done, share.email.sent, share.qr.shown) et les erreurs (error.capture, error.compose, error.print, error.camera, error.disk, error.license). Chaque déclencheur n’écoute que les événements que vous choisissez. Chaque message contient une version de format, le nom de l’événement, un horodatage ISO 8601, les identifiants de session, d’événement et de machine, et des données propres à l’événement.

Peut-on lancer un script sur le PC de la borne à chaque photo ?

Oui, avec un déclencheur de type programme. Froozbooth lance un exécutable du PC de la borne sur les événements choisis, comme shot.taken ; il doit être désigné par un chemin absolu et autorisé dans la liste blanche du service matériel. Il reçoit des arguments nommés (--event, --session, --booth-event, --ts, --device), puis les données de l’événement.

Comment tester un déclencheur avant l’arrivée des invités ?

Avec le bouton Test de l’administration de la borne : Froozbooth envoie un événement d’exemple et affiche la réponse. Les 200 derniers envois sont journalisés avec statut, code et latence, et s’exportent en CSV. Un événement de plus de 60 secondes est journalisé, pas rejoué : après un redémarrage, pas de flash en plein dîner.

La borne peut-elle me prévenir quand l’imprimante ou l’appareil photo tombe en panne ?

Oui, avec un déclencheur sur les événements d’erreur : error.print, error.camera, error.capture, error.compose, error.disk et error.license. Dirigez-le vers un webhook de votre propre service pour recevoir l’alerte où vous voulez. La page Machines du dashboard montre aussi l’état de chaque borne en direct, et s’installe sur l’écran d’accueil de votre téléphone.

Prêt pour votre prochain événement ?