¶ Introduction
Ce document décrit la mise en oeuvre
QLC+ est une solution solide et très répandue pour le contrôle DMX, parfaitement adaptée au pilotage de lyres. En revanche, pour un spectacle son et lumière combinant déclenchements MQTT, son, vidéo et lumière, QLC+ ne doit pas être le cœur de la synchronisation, mais un simple exécutant DMX.
Architecture globale recommandéeDans un spectacle son et lumière, la vidéo et le son dictent le temps. QLC+ s’aligne sur ce temps.
[ Serveur MQTT ]
│
▼
[ Régie Maître / Show Control ] ◄── (Node-RED, QLab, Millumin)
│ │
▼ (MTC / LTC / OSC) ▼ (Réseau / HDMI)
[ QLC+ (DMX512) ] [ Lecteur Vidéo ]
¶ Intégration de MQTT avec QLC+
QLC+ ne supporte pas nativement le protocole MQTT. Il communique principalement via des requêtes HTTP/WebSockets ou par des protocoles réseau de régie comme OSC ou Art-Net/sACN.
Utiliser un pont intermédiaire (Node-RED ou script Python) : Node-RED reçoit les messages MQTT puis transmet les commandes à QLC+.
Protocole recommandé pour la liaison : Envoyer de l’OSC (Open Sound Control) depuis Node-RED vers QLC+.
C’est un protocole UDP très rapide, nativement supporté par l’onglet Inputs/Outputs de QLC+.
Alternative WebSocket :
Si QLC+ active son serveur web (-w), il est possible d’envoyer des commandes de contrôle en WebSocket via son API intégrée.
¶ Outils et méthodes pour synchroniser la vidéo
Deux approches principales existent selon le niveau de complexité :
¶ Option A : QLC+ pilote tout (Projet simple)
Si les fichiers vidéo sont légers et sur la même machine, QLC+ gère l’affichage vidéo direct via l’onglet Show.
Comment faire : Placer une piste vidéo et une piste lumière sur la même Timeline.
QLC+ déclenchera le fichier multimédia.
Limites : QLC+ n’est pas un media server (gestion limitée du multiprojection, du warping ou des codecs lourds).
¶ Option B : Media Server externe synchronisé (Recommandé pour un rendu pro)
Séparer la vidéo sur un logiciel dédié (Media Server) et le synchroniser avec QLC+.
Les logiciels vidéo recommandés :
QLab (macOS) / Millumin (macOS) : Références en spectacle vivant. Très stables, ils reçoivent/envoient du Timecode et de l’OSC.
Resolume Arena / TouchDesigner (Windows/macOS) : Idéaux si la vidéo nécessite du mapping avancé sur des structures ou de la génération temps réel.
Raspberry Pi avec mpv / info-beamer (Budget réduit / installation fixe) : Pilotable en réseau via scripts si les besoins sont simples.3.
Les protocoles de synchronisation lumière-vidéoMéthodePrincipeCas d’usageOSC (Open Sound Control)
Envoi de messages type /cue/1/start via réseau local.
Déclenchement au Top (Lancer la vidéo X et la scène QLC+ Y en même temps).
MTC (MIDI Timecode) / LTCSignal temporel continu (ex: 00:01:23:12).
Synchronisation frame-by-frame indispensable pour les calages millimétrés sur la musique.
Art-Net / sACN
Le logiciel vidéo contrôle directement des canaux DMX de QLC+ ou inversement.
Utilisation du flux vidéo comme source de lumière (Pixel Mapping).
¶ Recommandations techniques pour le DMX (Lyres)
Choix de l’interface DMX :
Privilégier un nœud Art-Net / sACN vers DMX (ex: Enttec ODE, DMXKing, ou boîtier open-source ESP32) connecté en Ethernet RJ45, plutôt qu’une simple interface USB-DMX.
L’Ethernet limite les décrochages et permet d’éloigner les lyres de la régie.
Câblage DMX512 :Employer du câble DMX dédié 110 Ω (pas de câble micro XLR standard).Placer impérativement une résistance de fin de ligne (120 Ω) sur la dernière lyre de la chaîne pour éviter les réflexions de signal.
Optimisation du rafraîchissement :
Les lyres consomment beaucoup de canaux (15 à 35 canaux par projecteur). Veiller à ne pas dépasser 512 canaux par univers DMX sous QLC+.
Résumé de la chaîne recommandée
- Serveur MQTT → Envoie l’événement au broker.
- Node-RED → Souscrit au topic MQTT et convertit l’ordre en commande OSC.
- Media Server (ex: QLab / Resolume) → Reçoit l’OSC, lance la vidéo et émet un MIDI Timecode (MTC).
- QLC+ → Reçoit le MTC et déroule la ligne temporelle DMX associée aux lyres.
¶ Raspberry Pi
Le raspberry Pi est le centre du spectacle, il va recevoir divers programmes :
- Mosquitto MQTT : c’est un serveur MQTT. Il permet d’envoyer et recevoir les demandes.
- Serveur Web : Apache/Php
¶ Mqtt <-> IO
Nous avons besoins de commander des animations depuis des ordres Mqtt, pour y arriver nous utilisons des relais pilotés via un ESP32 Wroom
Lien
Pourquoi ce composant ?
Historiquement ce rôle était dévolu à un Arduino Mega2560, mais ce dernier ne dispose pas de couche réseau. L’ESP32 dispose d’une couche Wifi/BlueTooth et est très bon marché. Il remplace avantageusement le couple Arduino/Ethernet HAT
Pour interagir avec les modules, capteurs ou circuits électroniques, l’ESP32 comme tout microcontrôleur possède une multitude de périphériques. Ils sont d’ailleurs beaucoup plus nombreux que sur une carte Arduino Uno classique.
L’ESP32 possède les périphériques suivants :
- 3 interfaces UART
- 2 interfaces I2C
- 3 interfaces SPI
- 16 sorties PWM
- 10 capteurs capacitifs
- 18 entrées analogiques (ADC)
- 2 sorties DAC
¶ Mqtt <-> Mad Mapper
¶ Mqtt -> QLC+ Mqtt
¶ Mqtt -> Pure Media
¶ Mqtt -> DCC Command Station
¶ Lecture Vidéo
Pour diffuser des vidéos de spectacle avec un suivi précis du timecode en temps réel et un contrôle via API (REST, WebSocket ou OSC), les serveurs médias grand public comme Jellyfin manquent de précision et d’outils de régie.
Trois solutions open source sur PC ou Raspberry Pi sont taillées pour cet usage scénique :
¶ CasparCG (La référence de régie & broadcast)
C’est un serveur média open source professionnel très puissant, conçu pour la diffusion vidéo synchrone ultra-précise et le contrôle à distance.
- Pilotage : API native via le protocole textuel AMCP (port 5250) ou via des wrappers en Node.js, Python, OSC et REST.
- Retour Timecode : Le serveur renvoie en temps réel via l’API la position exacte du curseur de lecture, la durée totale, le temps restant et les métadonnées (en images/seconde ou millisecondes).
- Usage spectacle : Support du multi-écran, gestion des canaux alpha (transparence), synchronisation parfaite et prise en charge du protocole NDI.
- Plateforme : PC (Windows / Linux).
¶ VLC Media Player via l’API HTTP / Telnet (Simple & Léger)
VLC intègre un serveur Web complet et une API JSON/REST qui permet de le transformer en lecteur distant contrôlable pour un Raspberry Pi ou un PC.
- Pilotage : API HTTP (JSON) ou interface Telnet / Socket TCP.
- Retour Timecode : En interrogeant l’endpoint /requests/status.json, VLC retourne la position exacte en secondes (time), le pourcentage de progression (position) et la durée totale (length).
- Usage spectacle : Idéal si le besoin reste simple (lancement de vidéos en plein écran sur un écran/vidéoprojecteur secondaire).
- Commandes type (API HTTP) :
- Lancer une vidéo : GET /requests/status.json?command=in_play&input=file:///chemin/video.mp4
- Récupérer le timecode : GET /requests/status.json
- Plateforme : PC (Linux, Windows, macOS) et Raspberry Pi (Raspbian).
¶ MPV avec IPC Socket (Ultra-précis & très léger)
MPV est un lecteur vidéo extrêmement rapide, très populaire en régie vidéo open source grâce à son socket IPC (Inter-Process Communication).
- Pilotage : Contrôle via un socket JSON-IPC (WebSocket / Unix Socket) ou via le protocole OSC (Open Sound Control).
- Retour Timecode : Tu peux observer (observe_property) ou demander à tout moment des propriétés comme time-pos (position actuelle en secondes avec décimales), time-remaining ou percent-pos.
- Usage spectacle : Aucun habillage d’interface, démarrage instantané, prise en charge fluide du 4K sur Raspberry Pi 4/5.
- Exemple de commande JSON via Socket :
{ "command": ["get_property", "time-pos"] } - Plateforme : PC (Linux, Windows) et Raspberry Pi.
¶ Tableau comparatif
| Solution | Précision Timecode | Complexité d’intégration API | Poids / Hardware |
|---|---|---|---|
| MPV (IPC Socket) | Frame-accurate (Très haute) | Moyenne (JSON over Socket / OSC) | Light (Idéal Pi) |
| VLC (API HTTP) | Seconde près (Moyenne) | Facile (Requêtes REST JSON) | Moyen |
| CasparCG | Frame-accurate (Pro Broadcast) | Moyenne à Élevée (AMCP / Node) | Lourd (PC puissant) |
Recommandation :
- Sur un Raspberry Pi ou un petit PC : MPV avec son socket IPC ou VLC via API HTTP pour la simplicité.
- Pour une régie spectacle complexe (multi-flux, fondu, grille de déclenchement) : CasparCG.
¶ Installation MPV
apt install mpv
nano ~/.config/mpv/mpv.conf
# Activer l'accélération matérielle
hwdec=auto
# Garder la fenêtre au premier plan (optionnel)
ontop=yes
fullscreen=yes
idle=yes
input-ipc-server=/tmp/mpvsocket
apt install socat
echo '{ "command": ["playlist-next"] }' | piped - /tmp/mpvsocket
echo '{ "command": ["loadfile", "/chemin/vers/votre/video.mp4", "replace"] }' | socat - /tmp/mpvsocket
Interroger le statut (savoir où en est le « time »)
Pour récupérer la position actuelle de la vidéo (le temps écoulé en secondes), interrogez la propriété time-pos :
echo '{ "command": ["get_property", "time-pos"] }' | socat - /tmp/mpvsocket
Exemple de réponse retournée par MPV :
{"data":42.158412,"error":"success"}
- Autres requêtes de statut utiles
Obtenir la durée totale de la vidéo :
echo '{ "command": ["get_property", "duration"] }' | socat - /tmp/mpvsocket
Obtenir le pourcentage de lecture effectué :
echo '{ "command": ["get_property", "percent-pos"] }' | socat - /tmp/mpvsocket
Savoir si la vidéo est actuellement en pause (vrai/faux) :
echo '{ "command": ["get_property", "pause"] }' | socat - /tmp/mpvsocket
¶ Video
Pour pouvoir intégrer facilement le flux vidéo d’une caméra dans une page HTML, la règle d’or est d’acheter une caméra qui supporte le protocole RTSP (Real-Time Streaming Protocol) ou le protocole ONVIF. Les caméras chinoises ultra bas de gamme « 100 % cloud » (comme Z-IOT Cam, Tuya/Smart Life basiques ou YCC365) verrouillent le flux pour forcer l’usage de leur application ou l’abonnement au cloud.
Voici les meilleures options bon marché, fiables et compatibles HTML :
¶ Reolink (Ex: Reolink E1 / E1 Pro) — Le meilleur choix technique
C’est la marque grand public la plus appréciée des développeurs et passionnés de domotique.
- Prix : ~30 € à 40 €
- Compatibilité : Propose un flux RTSP natif et un flux HTTP/MJPEG directement accessible via une URL.
- Intégration HTML :
Le flux MJPEG peut être intégré directement dans une balise HTML<img src="http://IP_CAMERA/cgi-bin/api.cgi?cmd=Snap...">sans aucun plugin ni conversion.
Le flux RTSP s’intègre en HTML5 via des wrappers légers comme WebRTC ou go2rtc.
¶ TP-Link Tapo (Ex: Tapo C200 / C100) — Le meilleur rapport qualité/prix
Les caméras Tapo sont très bon marché et intègrent une option officielle pour créer un compte local ONVIF/RTSP.
- Prix : ~20 € à 25 €
- Compatibilité : Flux RTSP natif activable en 2 minutes dans l’application Tapo (Menu Paramètres de la caméra > Paramètres avancés > Compte de la caméra).
- URL du flux : rtsp://admin:mot_de_passe@IP_CAMERA:554/stream1 (Qualité HD) ou /stream2 (Qualité SD).
¶ Sonoff (Ex: Sonoff CAM Slim) — L’option alternative domotique
- Prix : ~20 €
- Compatibilité : Supporte le protocole RTSP directement dans le firmware d’origine.
- Intégration HTML : Très simple via la conversion du flux RTSP.
¶ ⚠️ Comment afficher du RTSP dans une page HTML5 ?
Les navigateurs web modernes (Chrome, Firefox, Edge) ne lisent pas le protocole rtsp:// en direct dans une balise <video>. Il y a deux méthodes simples pour l’intégrer dans ta page web :
¶ Option A : Convertir le flux RTSP en WebRTC / MSE (Recommandé - Sans latence)
Utilise le serveur open-source ultra-léger go2rtc ou MediaMTX (s’installe en 1 clic sur PC, Raspberry Pi ou Docker) :
- Tu donnes ton lien RTSP à go2rtc.
- go2rtc te fournit directement un code d’intégration HTML (iFrame ou composant WebRTC) prêt à être collé dans ta page.
¶ Option B : La méthode MJPEG (NATIVE)
Si tu choisis une caméra comme Reolink, elle génère directement une suite d’images JPEG via une URL HTTP. Tu peux l’intégrer directement dans ta page :
<!-- Intégration directe sans aucun serveur intermédiaire -->
<img src="http://admin:password@192.168.1.XX/cgi-bin/mjpg/video.cgi" width="640" height="480" />
¶ En résumé
Si tu veux la simplicité absolue sans serveur intermédiaire, prends une Reolink E1. Si tu veux le prix le plus bas pour streamer du RTSP via un petit outil comme go2rtc, prends une TP-Link Tapo C200.
¶ Intégration Loco
Pour intégrer une caméra Wi-Fi dans une locomotive à l’échelle HO (), le critère absolu devient l’encombrement physique, l’alimentation électrique et la gestion de la chauffe.
Les caméras du commerce (comme les Tapo ou Reolink) sont beaucoup trop volumineuses, même débosselées.
Voici les meilleures solutions techniques pour le monde ferroviaire miniature :
¶ 1. La solution reine : Le module ESP32-CAM
C’est la solution la plus économique, la plus compacte et la plus personnalisable pour le HO.
- Encombrement : L’ensemble carte + capteur fait environ (rentre facilement dans un wagon de queue, une voiture passagers ou une grosse motrice Diesel/Vapeur).
- Flux vidéo HTML natif : L’ESP32 génère son propre serveur web et livre directement un flux MJPEG accessible en HTTP. Tu l’intègres directement dans ta page web :
<img src="http://192.168.1.XX:81/stream" width="100%" /> - Coût : environ .
¶ 2. La solution Ultra-Micro : Module AIO FPV (Analogique ou Wi-Fi)
Si tu es très limité en place (ex: motrice électrique étroite) :
- Module caméra Wi-Fi miniature : On trouve des modules caméras Wi-Fi d’action cam / drone sans boîtier (ex: ESP32-S3-Eye ou modules génériques type DIY Wi-Fi Mini Camera module).
- Caméra FPV 5,8 GHz + Récepteur USB : Très utilisé par les modélistes. La caméra émet en hertzien (zéro latence) vers un petit récepteur USB branché sur ton PC/Raspberry Pi, qui réinjecte ensuite le flux vidéo dans ta page HTML.
¶ 3. Gestion de l’alimentation électrique ( / DCC vers )
C’est le point critique dans une locomotive : le courant des rails n’est pas du continu propre. En Analogique ( DC) : Le courant varie avec la vitesse et s’annule à l’arrêt.En Digital (DCC) : Le courant est un signal carré alternatif d’environ .Le schéma d’alimentation obligatoire :
[Rails HO (DCC/DC)] ──► [Pont de diodes] ──► [Condensateur 1000µF] ──► [Convertisseur Step-Down 5V] ──► [ESP32-CAM]
- Pont de diodes (Pont de Graetz) : Redresse le courant quelle que soit la polarité/sens de marche de la loco.
- Condensateur de filtrage ( à ) : Essentiel pour faire « tampon » et éviter que la caméra ne redémarre à chaque micro-coupure de contact sur les aiguillages.
- Regulateur Step-Down (type MP1584 ou LM2596 mini) : Abaisse la tension des rails () à un continu et propre pour la caméra.
Astuces d’intégration en HO
- Refroidissement : L’ESP32-CAM et l’émetteur Wi-Fi chauffent. Ne ferme pas complètement la caisse de la locomotive sans laisser de discrètes ouïes d’aération (sur le toit ou sous le châssis).
- Lentille sur nappe : Le capteur OV2640 de l’ESP32-CAM est relié par une petite nappe flexible. Tu peux fixer la carte dans le corps de la motrice et faire dépasser uniquement la lentille par le pare-brise de la cabine de conduite.