MQTT / Home Assistant per Audio Forge

Audio Forge 1.4.4 introduce l’integrazione con MQTT / Home Assistant, permettendo finalmente alla tua soundboard TTRPG di connettersi al resto del tuo setup. Ora puoi attivare musica, atmosfera e one‑shots da automazioni, interruttori a parete, pulsanti di stream deck o qualsiasi altro dispositivo in grado di pubblicare su MQTT.

Vuoi che la tua musica di battaglia, luci e macchina del fumo si attivino con la stessa pressione di un pulsante? Ora è possibile.

Cosa può fare l’integrazione MQTT

Con MQTT attivato, Audio Forge può:

• Pubblicare il suo stato attuale (quale libreria è attiva, se Musica/Atmosfera sono in esecuzione, quali categorie sono attive, volumi, ultimo Eco, 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 Echoes.
• Usare facoltativamente il Rilevamento Home Assistant per creare automaticamente entità (pulsanti, sensori, numeri, interruttori, selezioni) sotto un dispositivo “Audio Forge”.

Questo significa che puoi:

• Iniziare o mettere in pausa Musica/Atmosfera con un pulsante di Home Assistant.
• Abbassare automaticamente il volume della musica al cambio di scena.
• Attivare o disattivare i livelli di Atmosfera con interruttori fisici o virtuali.
• Attivare Echoes (suoni one‑shot) da eventi di automazione.

Abilitare MQTT in Audio Forge

Nell’app, vai su Impostazioni → Integrazione MQTT e:

1. Attiva Attivato.
2. Inserisci il tuo Host e Porta MQTT (1883 per impostazione predefinita, o 8883 per TLS).
3. Compila Nome utente / Password se il tuo broker lo richiede.
4. Regola facoltativamente Client ID, Topic Base (di default qualcosa come audioforge/my-pc), QoS, e se mantenere lo stato.
5. Attiva Pubblica stato e Sottoscrivi ai comandi.
6. (Opzionale ma consigliato) Attiva il Rilevamento MQTT per permettere a Home Assistant di creare automaticamente le entità.

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

Esempi: automazioni semplici

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

• Crea un pulsante “Battaglia” in Home Assistant che avvia una categoria musicale “Battaglia” in Audio Forge e cambia le luci in rosso.
• Usa un sensore binario (come “giocatori entrano nel dungeon”) per passare all’atmosfera del dungeon e abbassare un po’ il volume della musica.
• Collega un pulsante Stream Deck (tramite Home Assistant o un altro strumento compatibile MQTT) per attivare un Eco (es. tuono, chiusura di una porta, ruggito di drago).
• Collega la tua macchina del fumo a echi drammatici o cambi di musica facendo reagire tutto alla stessa automazione.

Sottotraccia, queste automazioni pubblicano semplicemente piccoli messaggi JSON sul topic di comando di Audio Forge (per esempio: {"command":"play","section":"Music","categoryName":"Battle"}). Non devi scrivere molto JSON da solo se usi le entità di rilevamento integrate.

Scopri i dettagli

Se desideri vedere tutti i topic, i payload e le opzioni di comando (inclusi controllo del volume, cambi di categoria e ripristino dello stato), consulta la guida completa:

Guida MQTT / Home Assistant

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

Ottieni Audio Forge 1.4.4

Aggiorna ora e connetti Audio Forge alla tua casa intelligente:

Scarica Audio Forge

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