Vos lumières
répondent à tout le reste
MyStrow ouvre une API HTTP dès son lancement. Une box domotique, un Stream Deck, un script ou une tâche planifiée peuvent alors lancer une mémoire, un effet, une couleur ou un noir, sans toucher à la console.
Une adresse, des commandes simples
Au démarrage, MyStrow ouvre une petite porte d'entrée sur l'ordinateur : http://127.0.0.1:8765/api/. N'importe quel programme installé sur ce même ordinateur peut y envoyer une commande, et MyStrow l'exécute exactement comme si vous aviez appuyé sur le pad de l'AKAI.
Les commandes tiennent dans l'adresse elle-même. Pour lancer la mémoire 1.1 : une requête POST vers /api/memory/1.1. Pour faire le noir : POST /api/blackout. Les réponses sont en JSON, ce que savent lire tous les outils d'automatisation.
Il n'y a rien à activer. MyStrow doit simplement être ouvert, avec votre show chargé.
Nouveau dans la 3.2.20 : l'accès par le réseau local. Une case dans Connexion › Contrôle › API réseau rend l'API joignable depuis les autres appareils du réseau (box domotique, serveur, tablette), protégée par une clé. Voir plus bas.
Quatre façons de s'en servir
Domotique et installations fixes
Bar, salle des fêtes, maison équipée : un bouton KNX « mode fête » lance l'ambiance, un autre remet l'éclairage normal. Le client n'ouvre jamais MyStrow.
Stream Deck et boutons programmables
Une touche par mémoire, une touche pour le noir, une pour l'effet stroboscope. Idéal en régie de streaming ou à côté d'une table de mixage.
Ambiances programmées
Avec le planificateur de tâches de Windows : la vitrine passe en ambiance chaude à 18 h, en noir à 23 h, tous les jours, sans personne.
Vos propres outils
Un script Python, une application maison, un automate de spectacle : tout ce qui sait envoyer une requête HTTP peut piloter vos lumières.
Les commandes
Toutes les adresses commencent par http://127.0.0.1:8765 sur le PC lui-même, ou par http://<IP-du-PC>:8765 depuis le réseau (avec la clé). Les commandes qui agissent sont en POST, celles qui lisent l'état sont en GET.
| Commande | Ce qu'elle fait | Exemple |
|---|---|---|
| POST /api/memory/{c.r} | Lance une mémoire, de 1.1 à 8.8 (colonne.rangée). | /api/memory/2.3 |
| POST /api/effect/{nom} | Lance un effet par son nom (majuscules indifférentes), ou bascule un bouton d'effet de 0 à 7. | /api/effect/Strobe%20Classique |
| POST /api/speed/{0-100} | Vitesse des effets. | /api/speed/70 |
| POST /api/stop_effects | Coupe tous les effets en cours. | |
| POST /api/level/{fader}/{0-100} | Niveau d'un fader de groupe, de 0 à 7 (le premier fader est le 0). Accepte aussi +10 ou -10. | /api/level/0/80 |
| POST /api/mute/{fader}/{0|1} | Coupe (1) ou rétablit (0) un fader. | /api/mute/3/1 |
| POST /api/projectors | Couleur, niveau, strobe ou coupure de projecteurs précis. Corps JSON, voir l'exemple plus bas. | |
| POST /api/blackout | Noir complet : faders, effets et strobe. | |
| POST /api/play · /next · /prev | Lecture/pause, média suivant, média précédent de la playlist. | |
| POST /api/goto/{ligne} | Lance une ligne précise de la playlist (la première est la 0). | /api/goto/4 |
| POST /api/cartouche/{0-3} | Déclenche une des quatre cartouches. | /api/cartouche/0 |
| POST /api/go · /goback | Mémoire suivante ou précédente en mode GO. | |
| GET /api/state | État complet en cours. | |
| GET /api/memories | Les 64 mémoires : enregistrée ou vide, active ou non, couleur. | |
| GET /api/effects | La liste de vos effets, y compris ceux que vous avez créés. | |
| GET /api/sequences · /cartouches | Le contenu de la playlist et des cartouches. |
Une erreur ne passe pas en silence. Une commande mal formée ou un nom d'effet inconnu renvoie un code d'erreur avec un message clair (« Effet inconnu : … (voir GET /api/effects) »). Votre automate sait donc si la commande a vraiment été exécutée.
Tester en trente secondes
Ouvrez MyStrow avec votre show, puis l'invite de commandes de Windows (ou le Terminal sur Mac). L'outil curl y est déjà installé.
Lancer une mémoire
curl -X POST http://127.0.0.1:8765/api/memory/1.1
MyStrow répond {"ok": true} et la mémoire 1.1 s'allume, sur les projecteurs comme sur l'écran.
Lancer un effet par son nom
curl -X POST http://127.0.0.1:8765/api/effect/Strobe%20Classique
Les espaces du nom s'écrivent %20. La liste exacte de vos effets : curl http://127.0.0.1:8765/api/effects.
Mettre des projecteurs en couleur
Dans PowerShell, pour passer les deux premiers projecteurs du patch en bleu :Invoke-RestMethod -Method Post -Uri http://127.0.0.1:8765/api/projectors -ContentType "application/json" -Body '{"events":[{"type":"proj_color","idxs":[0,1],"color":"#0040ff"},{"type":"proj_level","idxs":[0,1],"value":100}]}'
Les projecteurs sont numérotés dans l'ordre du patch, le premier est le 0.
Faire le noir
curl -X POST http://127.0.0.1:8765/api/blackout
Le conseil qui simplifie tout : préparez vos ambiances en mémoires dans MyStrow (couleurs, effets, lyres), puis ne faites appeler que des mémoires par l'extérieur. Vous réglez l'ambiance une fois, à l'œil, et la domotique se contente de dire « mémoire 1.1 ».
Un « mode fête » sur un bouton KNX
Le cas typique : un intégrateur équipe une salle ou une maison de projecteurs DMX, pilotés par MyStrow sur un mini-PC. Le client, lui, veut seulement appuyer sur un bouton de sa domotique pour passer en mode fête, choisir une couleur ou tout éteindre.
Dans tous les cas, commencez par enregistrer une mémoire par scénario dans MyStrow : 1.1 = mode fête, 1.2 = ambiance douce, 1.3 = blanc chaud… La domotique n'aura qu'à appeler la bonne mémoire, ou /api/blackout pour tout éteindre. Faites aussi démarrer MyStrow avec Windows (raccourci dans le dossier Démarrage) : le PC redémarre, les lumières restent pilotables.
Méthode directe : l'API réseau (MyStrow 3.2.20 et plus)
Ouvrir l'API au réseau local
Dans MyStrow : Connexion › Contrôle › API réseau, cochez « Autoriser l'accès depuis le réseau local ». La fenêtre affiche l'adresse à utiliser (par exemple http://192.168.1.50:8765/api/) et la clé. Si Windows demande l'autorisation du pare-feu, acceptez pour les réseaux privés.
Envoyer la clé avec chaque requête
Au choix : l'en-tête Authorization: Bearer <clé>, l'en-tête X-API-Key: <clé>, ou ?key=<clé> à la fin de l'adresse. Sans la bonne clé, MyStrow répond 401 et n'exécute rien.
Exemple avec Home Assistant
Dans configuration.yaml, une commande par scénario :rest_command:
mystrow_fete:
url: "http://192.168.1.50:8765/api/memory/1.1"
method: POST
headers:
Authorization: "Bearer VOTRE_CLÉ"
Appelez ensuite rest_command.mystrow_fete depuis une automatisation, un bouton du tableau de bord ou un appui KNX remonté dans Home Assistant.
Tester depuis le bouton
Un appui, et l'ambiance part. Le retour d'état (une LED sur le bouton, par exemple) peut se faire en lisant GET /api/memories, avec la clé lui aussi.
Une clé compromise ? Le bouton « Nouvelle clé » de la même fenêtre en crée une autre : l'ancienne cesse aussitôt de fonctionner. Sur le PC lui-même, aucune clé n'est demandée : le Stream Deck et l'extension Claude continuent de marcher sans rien changer.
Autre méthode : Node-RED sur le PC de MyStrow
Avec une version de MyStrow antérieure à la 3.2.20, ou si vous préférez garder l'API fermée au réseau, installez un traducteur sur le même PC que MyStrow. Node-RED, gratuit, est parfait pour ça : il existe des modules KNX/IP prêts à l'emploi (par exemple node-red-contrib-knx-ultimate).
Installer Node-RED sur le même PC
Ajoutez-y un module KNX, configuré sur votre passerelle KNX/IP. Créez une adresse de groupe par scénario dans ETS.
Relier chaque adresse à une commande
Pour chaque scénario : un nœud KNX qui écoute l'adresse de groupe, suivi d'un nœud http request en POST vers http://127.0.0.1:8765/api/memory/1.1. Pour l'arrêt, la même chose vers /api/blackout.
Si votre box (Home Assistant, Jeedom, serveur logique) est sur une autre machine, Node-RED sur le PC de MyStrow sert de relais : un nœud http in reçoit la requête de la box par le réseau, un nœud http request la transmet à MyStrow.
💡 Et le Raspberry Pi ? MyStrow fonctionne sur Windows et sur Mac, pas encore sur Raspberry. Pour une installation fixe, un mini-PC Windows sans ventilateur, branché sur l'interface DMX, est discret et fiable.
Stream Deck et tâches planifiées
🎛 Stream Deck
Installez depuis le store d'Elgato un plugin qui envoie des requêtes HTTP (« API Ninja », par exemple). Chaque touche reçoit une adresse : POST http://127.0.0.1:8765/api/memory/1.1, /api/blackout, /api/next…
⏰ Planificateur de tâches
Dans Windows, créez une tâche qui démarre à l'heure voulue, avec comme programme curl.exe et comme arguments -X POST http://127.0.0.1:8765/api/memory/1.2. Une tâche par ambiance.
Ce que l'API ne fait pas
- Elle n'est pas sur Internet. Par défaut, elle n'écoute que sur l'ordinateur (127.0.0.1). Ouverte au réseau local (3.2.20), elle exige une clé de chaque appareil. Ne l'exposez pas sur Internet en ouvrant un port de votre box.
- Une page web ne peut pas faire le noir. Les commandes sensibles (noir, projecteurs, vitesse, arrêt des effets) sont refusées quand elles viennent d'un navigateur.
- Elle ne modifie pas votre show. Aucune commande n'efface une mémoire, ne touche au patch ou à vos réglages : seulement des commandes de jeu.
- MyStrow doit être ouvert. Si le logiciel est fermé, la commande n'aboutit pas : votre automate reçoit une erreur de connexion.
Une question d'intégration ? Écrivez-nous à contact en décrivant votre installation (domotique, nombre de projecteurs, scénarios voulus) : on vous aide à choisir les bonnes commandes.
Branchez vos lumières sur le reste
Installez MyStrow, enregistrez vos ambiances, et envoyez votre première commande.