MQTT / Home Assistant pour Audio Forge

Audio Forge 1.4.4 introduit l’intégration MQTT / Home Assistant, permettant ainsi à votre table de mixage TTRPG de s’intégrer enfin au reste de votre installation. Vous pouvez désormais déclencher de la musique, de l’ambiance et des one-shots à partir des automatisations, des interrupteurs muraux, des boutons de stream deck ou de tout autre élément pouvant publier sur MQTT.

Vous voulez que votre musique de bataille, vos lumières et votre machine à fumée se déclenchent sur la même pression de bouton ? Maintenant, c’est possible.

Ce que l’intégration MQTT peut faire

Avec MQTT activé, Audio Forge peut :

• Publier son état actuel (quelle bibliothèque est active, si Musique/Ambiance sont en cours, quelles catégories sont actives, volumes, dernier Echo, etc.).
• Exposer des commandes simples que vous pouvez envoyer depuis Home Assistant ou Node-RED pour jouer, mettre en pause, arrêter, changer de bibliothèque, régler le volume et déclencher des Échos.
• Utiliser facultativement la découverte Home Assistant pour créer automatiquement des entités (boutons, capteurs, nombres, interrupteurs, sélecteurs) sous un appareil “Audio Forge”.

Cela signifie que vous pouvez :

• Démarrer ou mettre en pause Musique/Ambiance avec un bouton Home Assistant.
• Atténuer automatiquement le volume de la musique lorsque vous changez de scène.
• Basculer les couches d’Ambiance avec des interrupteurs physiques ou virtuels.
• Déclencher des Échos (sons ponctuels) à partir d’événements automatisés.

Activer MQTT dans Audio Forge

Dans l’application, allez dans Paramètres → Intégration MQTT et :

1. Activez Activé.
2. Entrez votre Hôte et Port MQTT (1883 par défaut, ou 8883 pour TLS).
3. Remplissez Nom d’utilisateur / Mot de passe si votre broker l’exige.
4. Ajustez facultativement l’ID client, le sujet de base (par défaut quelque chose comme audioforge/my-pc), QoS, et s’il faut conserver l’état.
5. Activez Publier l’état et S’abonner aux commandes.
6. (Optionnel mais recommandé) Activez la Découverte MQTT pour permettre à Home Assistant de créer automatiquement des entités.

Une fois connecté, vous verrez Audio Forge sous les clients de votre broker, et Home Assistant affichera soit automatiquement le nouvel appareil (avec la découverte) soit vous pourrez le connecter manuellement avec des capteurs et des boutons MQTT.

Exemples : automatisations simples

Voici quelques idées de ce que vous pouvez faire une fois MQTT activé :

• Créez un bouton “Bataille” dans Home Assistant qui démarre une catégorie musicale “Bataille” dans Audio Forge et met vos lumières en rouge.
• Utilisez un capteur binaire (comme “les joueurs entrent dans le donjon”) pour passer à votre ambiance de donjon et baisser un peu le volume de la musique.
• Reliez un bouton de Stream Deck (via Home Assistant ou un autre outil compatible MQTT) pour déclencher un Echo (par exemple, tonnerre, claquement de porte, rugissement de dragon).
• Associez votre machine à fumée aux Échos dramatiques ou aux changements de musique en faisant répondre tout à la même automatisation.

En coulisse, ces automatisations publient simplement de petits messages JSON sur le sujet de commande Audio Forge (par exemple : {"command":"play","section":"Music","categoryName":"Battle"}). Vous n’avez pas besoin d’écrire beaucoup de JSON vous-même si vous utilisez les entités de découverte intégrées.

Apprenez les détails

Si vous souhaitez voir tous les sujets, charges utiles et options de commande (y compris le contrôle de volume, les commutateurs de catégorie et la restauration d’état), consultez le guide complet :

Guide MQTT / Home Assistant

Il inclut des commandes exemples et une automatisation Home Assistant que vous pouvez copier-coller et adapter à votre table.

Obtenez Audio Forge 1.4.4

Mettez à jour maintenant et connectez Audio Forge à votre maison intelligente :

Télécharger Audio Forge

Des questions ou envie de partager vos automatisations ? Rejoignez la communauté sur Discord.