MQTT / Home Assistant per Audio Forge

Audio Forge 1.4.4 introduce l’integrazione MQTT / Home Assistant, quindi la tua soundboard TTRPG può finalmente collegarsi al resto del tuo setup. Ora puoi attivare musica, ambientazione e suoni immediati tramite automazioni, interruttori a parete, pulsanti su deck di streaming o qualsiasi altra cosa che possa pubblicare su MQTT.

Vuoi che la tua musica da battaglia, luci e macchina del fumo si attivino con la pressione dello stesso pulsante? Ora è possibile.

Cosa può fare l’integrazione MQTT

Con MQTT abilitato, Audio Forge può:

• Pubblicare il suo stato attuale (quale libreria è attiva, se la Musica/Ambientazione sono in esecuzione, quali categorie sono attive, volumi, ultimo Echo, ecc.).
• Esporre comandi semplici che puoi inviare da Home Assistant o Node‑RED per riprodurre, mettere in pausa, fermare, cambiare libreria, impostare il volume e attivare gli Echi.
• Utilizzare facoltativamente Home Assistant Discovery per creare automaticamente entità (pulsanti, sensori, numeri, interruttori, selezioni) sotto un dispositivo “Audio Forge”.

Questo significa che puoi:

• Iniziare o mettere in pausa Musica/Ambientazione con un pulsante Home Assistant.
• Abbassare automaticamente il volume della musica quando cambi scena.
• Attivare i livelli di Ambientazione con interruttori fisici o virtuali.
• Attivare gli Echi (suoni immediati) da eventi di automazione.

Abilitare MQTT in Audio Forge

Nell’app, vai a Impostazioni → Controllo esterno → Integrazione MQTT e:

1. Attiva Abilitato.
2. Inserisci il tuo Host e Porta MQTT (1883 di default, o 8883 per TLS).
3. Compila Nome utente / Password se il tuo broker lo richiede.
4. Facoltativamente regola Client ID, Topic di base (di default qualcosa come audioforge/my-pc), QoS, e se mantenere lo stato.
5. Attiva Pubblica stato e Sottoscrivi a comandi.
6. (Opzionale ma consigliato) Abilita MQTT Discovery per lasciare che Home Assistant crei le entità automaticamente.

Una volta connesso, vedrai Audio Forge sotto i client del tuo broker e Home Assistant mostrerà automaticamente il nuovo dispositivo (con discovery) o potrai collegarlo manualmente con sensori e pulsanti MQTT.

Esempi: automazioni semplici

Ecco alcune idee su cosa puoi fare una volta abilitato MQTT:

• Crea un pulsante “Battaglia” in Home Assistant che avvia una categoria musicale “Battaglia” in Audio Forge e trasforma le tue luci in rosso.
• Usa un sensore binario (come “giocatori entrano nel dungeon”) per passare alla tua ambientazione da dungeon e abbassare un po’ il volume della musica.
• Collega un pulsante Stream Deck (tramite Home Assistant o un altro strumento compatibile con MQTT) per attivare un Echo (ad es., tuoni, porta sbattente, ruggito di drago).
• Collega la tua macchina del fumo a Echi drammatici o cambiamenti musicali facendo in modo che tutto risponda alla stessa automazione.

Dietro le quinte, queste automazioni pubblicano solo piccoli messaggi JSON al topic di comando di Audio Forge (ad esempio: {"command":"play","section":"Music","categoryName":"Battle"}). Non hai bisogno di scrivere molto JSON da solo se utilizzi le entità di rilevamento integrate.

Scopri i dettagli

Se vuoi vedere tutti i topic, i payload e le opzioni di comando (incluso il controllo del volume, interruttori di categoria e ripristino dello stato), consulta la guida completa:

Guida MQTT / Home Assistant

Include comandi di esempio e un’automazione campione di Home Assistant che puoi copiare-incollare e adattare al tuo tavolo.

Ottieni Audio Forge 1.4.4

Aggiorna ora e collega Audio Forge alla tua casa intelligente:

Scarica Audio Forge

Hai domande, o vuoi condividere le tue automazioni? Unisciti alla comunità su Discord.