MQTT / Home Assistant voor Audio Forge

Audio Forge 1.4.4 introduceert MQTT / Home Assistant integratie, zodat je TTRPG soundboard eindelijk kan aansluiten op de rest van je setup. Je kunt nu muziek, ambiance en one-shots activeren vanuit automatiseringen, muurschakelaars, stream deck knoppen of alles wat naar MQTT kan publiceren.

Wil je dat je gevechtsmuziek, lichten en rookmachine op dezelfde knopdruk afgaan? Nu kan het.

Wat de MQTT integratie kan doen

Met MQTT ingeschakeld kan Audio Forge:

• Zijn huidige status publiceren (welke bibliotheek actief is, of Muziek/Ambiance spelen, welke categorieën actief zijn, volumes, laatste Echo, enz.).
• Eenvoudige commando’s toegankelijk maken die je van Home Assistant of Node-RED kunt verzenden om af te spelen, pauzeren, stoppen, bibliotheek wijzigen, volume instellen en Echoes activeren.
• Optioneel gebruik maken van Home Assistant Discovery om entiteiten (knoppen, sensoren, cijfers, schakelaars, selecties) automatisch te creëren onder een “Audio Forge” apparaat.

Dat betekent dat je:

• Muziek/Ambiance kunt starten of pauzeren met een Home Assistant knop.
• Muziekvolume automatisch kunt laten vervagen wanneer je van scène verandert.
• Ambiance lagen kunt schakelen met fysieke of virtuele schakelaars.
• Echoes (one-shot geluiden) kunt activeren vanuit automatiseringsevenementen.

MQTT inschakelen in Audio Forge

Ga in de app naar Instellingen → Externe Bediening → MQTT Integratie en:

1. Zet Ingeschakeld aan.
2. Voer je MQTT Host en Port in (1883 standaard, of 8883 voor TLS).
3. Vul Gebruikersnaam / Wachtwoord in als je broker deze vereist.
4. Pas optioneel Client ID, Basisonderwerp (standaard iets als audioforge/my-pc), QoS, en of je status wilt behouden aan.
5. Zet Publiceer status en Abonneer op commando’s aan.
6. (Optioneel maar aanbevolen) Schakel MQTT Discovery in om Home Assistant automatisch entiteiten te laten creëren.

Zodra je bent verbonden, zie je Audio Forge onder de clients van je broker, en Home Assistant zal het nieuwe apparaat automatisch tonen (met discovery) of je kunt het handmatig aansluiten met MQTT sensoren en knoppen.

Voorbeelden: eenvoudige automatiseringen

Hier zijn een paar ideeën van wat je kunt doen zodra MQTT is ingeschakeld:

• Maak een “Slagveld” knop in Home Assistant die een “Slagveld” muziekbibliotheek in Audio Forge start en je lichten rood maakt.
• Gebruik een binaire sensor (zoals “spelers betreden kerker”) om naar je kerker ambiance te schakelen en het muziekvolume wat te verlagen.
• Koppel een Stream Deck knop (via Home Assistant of een andere MQTT-capabele tool) om een Echo te activeren (bijv. donder, deurklap, drakenbrul).
• Verbind je rookmachine aan dramatische Echo’s of muziekveranderingen door alles op dezelfde automatisering te laten reageren.

Intern publiceren deze automatiseringen eenvoudig kleine JSON-berichten naar het Audio Forge commando onderwerp (bijvoorbeeld: {"command":"play","section":"Music","categoryName":"Battle"}). Je hoeft niet veel JSON zelf te schrijven als je de ingebouwde discovery entiteiten gebruikt.

Leer de details

Als je alle onderwerpen, payloads en commando-opties wilt zien (inclusief volumeregeling, categorie schakelaars en statusherstel), bekijk dan de volledige gids:

MQTT / Home Assistant gids

Het bevat voorbeeldcommando’s en een voorbeeld Home Assistant automatisering die je kunt kopiëren, plakken en aanpassen aan je tafel.

Haal Audio Forge 1.4.4

Update nu en verbind Audio Forge met je slimme huis:

Download Audio Forge

Vragen, of wil je je automatiseringen delen? Doe mee met de community op Discord.