MQTT / Home Assistant pour Audio Forge

Audio Forge 1.4.4 introduit l’intégration MQTT / Home Assistant, de sorte que votre table de mixage TTRPG peut enfin se connecter au reste de votre configuration. Vous pouvez désormais déclencher de la musique, des ambiances et des sons ponctuels à partir d’automatisations, d’interrupteurs muraux, de boutons de Stream Deck, ou de tout autre dispositif capable de publier sur MQTT.

Vous voulez que votre musique de combat, vos lumières et votre machine à fumée s’activent à la même pression de bouton ? Maintenant vous pouvez.

Ce que l’intégration MQTT peut faire

Avec MQTT activé, Audio Forge peut :

• Publier son état actuel (quelle bibliothèque est active, si la Musique/L’Ambiance jouent, quelles catégories sont actives, les volumes, le dernier Écho, 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 éventuellement le Home Assistant Discovery pour créer automatiquement des entités (boutons, capteurs, nombres, interrupteurs, sélections) sous un appareil “Audio Forge”.

Cela signifie que vous pouvez :

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

Activation de MQTT dans Audio Forge

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

1. Activez Activé.
2. Entrez votre Hôte MQTT et Port (1883 par défaut, ou 8883 pour TLS).
3. Remplissez le Nom d’utilisateur / Mot de passe si votre broker les requiert.
4. Ajustez éventuellement l’ID Client, le Sujet de Base (par défaut quelque chose comme audioforge/my-pc), le QoS, et si vous souhaitez conserver l’état.
5. Activez Publier l’état et S’abonner aux commandes.
6. (Optionnel mais recommandé) Activez Découverte MQTT pour que Home Assistant crée 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 que MQTT est activé :

• Créez un bouton “Combat” dans Home Assistant qui démarre une catégorie de musique “Combat” dans Audio Forge et rend vos lumières rouges.
• 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.
• Liez un bouton Stream Deck (via Home Assistant ou un autre outil compatible MQTT) pour déclencher un Écho (par exemple, tonnerre, claquement de porte, rugissement de dragon).
• Reliez votre machine à fumée aux Échos dramatiques ou aux changements de musique en les faisant tous répondre à la même automatisation.

En coulisses, ces automatisations ne font que publier de petits messages JSON au sujet des commandes d’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 voulez voir tous les sujets, charges utiles, et options de commande (y compris le contrôle du volume, les commutateurs de catégorie et la restauration d’état), consultez le guide complet :

Guide MQTT / Home Assistant

Il inclut des exemples de commandes et un exemple d’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.