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, sfeer en éénmalige geluiden activeren vanuit automatiseringen, wandschakelaars, streamdeckknoppen of iets anders dat kan publiceren naar MQTT.

Wil je dat je gevechtsmuziek, lichten en rookmachine op dezelfde knopdruk worden geactiveerd? Nu kan dat.

Wat de MQTT-integratie kan doen

Met MQTT ingeschakeld, kan Audio Forge:

• Zijn huidige status publiceren (welke bibliotheek actief is, of Muziek/Sfeer wordt afgespeeld, welke categorieën actief zijn, volumes, laatste Echo, etc.).
• Eenvoudige commando’s beschikbaar stellen die je kunt verzenden vanuit Home Assistant of Node-RED om af te spelen, te pauzeren, te stoppen, de bibliotheek te wijzigen, het volume in te stellen en Echo’s te activeren.
• Optioneel Home Assistant Discovery gebruiken om automatisch entiteiten aan te maken (knoppen, sensoren, nummers, schakelaars, selecties) onder een “Audio Forge”-apparaat.

Dat betekent dat je kunt:

• Muziek/Sfeer starten of pauzeren met een Home Assistant knop.
• Het volume van de muziek automatisch laten afnemen wanneer je van scène verandert.
• Sfeerlagen schakelen met fysieke of virtuele schakelaars.
• Echo’s (éénmalige geluiden) activeren vanuit automatiseringsgebeurtenissen.

MQTT inschakelen in Audio Forge

Ga in de app naar Instellingen → MQTT-integratie en:

1. Zet Ingeschakeld aan.
2. Voer je MQTT Host en Port in (standaard 1883 of 8883 voor TLS).
3. Vul Gebruikersnaam / Wachtwoord in als je broker ze nodig heeft.
4. Pas optioneel Client ID, Basis Onderwerp (standaard iets als audioforge/my-pc), QoS, en of de status moet worden behouden aan.
5. Zet Status publiceren en Abonneren op commando’s aan.
6. (Optioneel maar aanbevolen) Zet MQTT Discovery aan om Home Assistant automatisch entiteiten te laten creëren.

Zodra verbonden, zie je Audio Forge onder de clients van je broker, en Home Assistant toont automatisch het nieuwe apparaat (met discovery) of je kunt het handmatig koppelen 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 “Gevecht” knop in Home Assistant die een “Gevecht” muziekcategorie in Audio Forge start en je lichten rood maakt.
• Gebruik een binaire sensor (zoals “spelers betreden kerker”) om je kerkerambiance te schakelen en de muziek iets te dempen.
• Koppel een Stream Deck-knop (via Home Assistant of een andere MQTT-compatibele tool) om een Echo te activeren (bijv. donder, dichtslaande deur, brullende draak).
• Verbind je rookmachine met dramatische Echo’s of muziekveranderingen door alles op dezelfde automatisering te laten reageren.

Onder de motorkap publiceren deze automatiseringen gewoon kleine JSON-berichten naar het Audio Forge-opdrachtonderwerp (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-overgangen en statusherstel), bekijk de volledige gids:

MQTT / Home Assistant gids

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

Haal Audio Forge 1.4.4

Update nu en verbind Audio Forge met je smart home:

Download Audio Forge

Heb je vragen, of wil je je automatiseringen delen? Word lid van de community op Discord.