MQTT / Home Assistant für Audio Forge

Audio Forge 1.4.4 fügt MQTT / Home Assistant-Integration hinzu, sodass Sie Musik, Atmosphäre und Echos von Ihren Smart Home-Automatisierungen, Szenenknöpfen und Stream-Overlays aus steuern können.

Audio Forge 1.4.4 führt die MQTT / Home Assistant-Integration ein, sodass Ihr TTRPG-Soundboard endlich in den Rest Ihrer Einrichtung integriert werden kann. Sie können jetzt Musik, Atmosphäre und Einzeltöne von Automatisierungen, Wandschaltern, Stream Deck-Tasten oder allem, was zu MQTT veröffentlichen kann, auslösen.

Möchten Sie, dass Ihre Kampfmusik, Lichter und Nebelmaschine auf denselben Knopfdruck reagieren? Jetzt können Sie es.

Was die MQTT-Integration kann

Mit aktivierter MQTT kann Audio Forge:

  • Seinen aktuellen Zustand veröffentlichen (welche Bibliothek aktiv ist, ob Musik/Atmosphäre gespielt wird, welche Kategorien aktiv sind, Lautstärken, letztes Echo usw.).
  • Einfache Befehle bereitstellen, die Sie von Home Assistant oder Node‑RED senden können, um abzuspielen, zu pausieren, zu stoppen, die Bibliothek zu wechseln, die Lautstärke einzustellen und Echos auszulösen.
  • Optional Home Assistant Discovery nutzen, um automatisch Entitäten (Tasten, Sensoren, Zahlen, Schalter, Auswahlmöglichkeiten) unter einem “Audio Forge”-Gerät zu erstellen.

Das bedeutet, Sie können:

  • Musik/Atmosphäre mit einem Home Assistant-Knopf starten oder pausieren.
  • Die Musiklautstärke automatisch verringern, wenn Sie die Szene wechseln.
  • Atmosphäreschichten mit physischen oder virtuellen Schaltern umschalten.
  • Echos (Einzelgeräusche) von Automatisierungsereignissen auslösen.

Aktivieren von MQTT in Audio Forge

Gehen Sie in der App zu Einstellungen → MQTT-Integration und:

  1. Schalten Sie Aktiviert ein.
  2. Geben Sie Ihren MQTT-Host und Port ein (standardmäßig 1883 oder 8883 für TLS).
  3. Geben Sie Benutzername / Passwort ein, wenn Ihr Broker sie benötigt.
  4. Optional können Sie Client ID, Basis-Topic (standardmäßig etwas wie audioforge/my-pc), QoS und ob der Zustand beibehalten werden soll, anpassen.
  5. Schalten Sie Zustand veröffentlichen und Befehle abonnieren ein.
  6. (Optional, aber empfohlen) Aktivieren Sie MQTT Discovery, um Home Assistant automatisch Entitäten erstellen zu lassen.

Sobald die Verbindung hergestellt ist, sehen Sie Audio Forge unter den Clients Ihres Brokers und Home Assistant zeigt entweder das neue Gerät automatisch an (mit Discovery) oder Sie können es manuell mit MQTT-Sensoren und -Tasten verbinden.

Beispiele: einfache Automatisierungen

Hier sind einige Ideen, was Sie tun können, wenn MQTT aktiviert ist:

  • Erstellen Sie einen „Kampf“-Knopf in Home Assistant, der eine „Kampf“-Musikkategorie in Audio Forge startet und Ihre Lichter rot einfärbt.
  • Verwenden Sie einen Binärsensor (wie „Spieler betreten Dungeon“), um zu Ihrer Dungeon-Atmosphäre zu wechseln und die Musiklautstärke etwas zu verringern.
  • Verknüpfen Sie eine Stream Deck-Taste (über Home Assistant oder ein anderes MQTT-fähiges Tool), um ein Echo (z.B. Donner, Türknallen, Drachengebrüll) auszulösen.
  • Koppeln Sie Ihre Nebelmaschine an dramatische Echos oder Musikwechsel, indem Sie alles auf dieselbe Automatisierung reagieren lassen.

Im Hintergrund veröffentlichen diese Automatisierungen einfach kleine JSON-Nachrichten auf das Audio Forge-Befehlsthema (zum Beispiel: {"command":"play","section":"Music","categoryName":"Battle"}). Sie müssen nicht viel JSON selbst schreiben, wenn Sie die eingebauten Discovery-Entitäten verwenden.

Erfahren Sie die Details

Wenn Sie alle Themen, Nutzlasten und Befehlsoptionen sehen möchten (einschließlich Lautstärkeregelung, Kategoriewechsel und Wiederherstellung des Zustands), sehen Sie sich den vollständigen Leitfaden an:

MQTT / Home Assistant-Leitfaden

Er enthält Beispielbefehle und eine Beispiel-Home Assistant-Automatisierung, die Sie kopieren und an Ihren Tisch anpassen können.

Holen Sie sich Audio Forge 1.4.4

Aktualisieren Sie jetzt und verbinden Sie Audio Forge mit Ihrem Smart Home:

Audio Forge herunterladen

Haben Sie Fragen oder möchten Sie Ihre Automatisierungen teilen? Treten Sie der Community auf Discord bei.