MQTT / Home Assistant para Audio Forge

Audio Forge 1.4.4 introduce la integración con MQTT / Home Assistant, por lo que tu soundboard de TTRPG finalmente puede conectarse al resto de tu configuración. Ahora puedes activar música, ambiente y sonidos de un solo uso desde automatizaciones, interruptores de pared, botones de stream deck, o cualquier otra cosa que pueda publicar en MQTT.

¿Quieres que tu música de batalla, luces y máquina de niebla se activen al presionar el mismo botón? Ahora puedes.

Lo que puede hacer la integración con MQTT

Con MQTT habilitado, Audio Forge puede:

• Publicar su estado actual (qué biblioteca está activa, si la Música/Ambiente están reproduciéndose, qué categorías están activas, volúmenes, último eco, etc.).
• Exponer comandos simples que puedes enviar desde Home Assistant o Node‑RED para reproducir, pausar, detener, cambiar de biblioteca, ajustar el volumen y activar Ecos.
• Usar opcionalmente el descubrimiento de Home Assistant para crear entidades automáticamente (botones, sensores, números, interruptores, selectores) bajo un dispositivo “Audio Forge”.

Eso significa que puedes:

• Comenzar o pausar Música/Ambiente con un botón de Home Assistant.
• Atenuar el volumen de música automáticamente cuando cambies de escena.
• Alternar capas de Ambiente con interruptores físicos o virtuales.
• Activar Ecos (sonidos de un solo uso) desde eventos de automatización.

Habilitar MQTT en Audio Forge

En la aplicación, ve a Configuración → Integración MQTT y:

1. Activa Habilitado.
2. Ingresa tu Host y Puerto de MQTT (1883 por defecto, o 8883 para TLS).
3. Completa con Nombre de usuario / Contraseña si tu broker los requiere.
4. Opcionalmente ajusta ID del cliente, Tema base (por defecto algo como audioforge/my-pc), QoS, y si deseas retener el estado.
5. Activa Publicar estado y Suscribirse a comandos.
6. (Opcional pero recomendado) Habilita el Descubrimiento de MQTT para que Home Assistant cree entidades automáticamente.

Una vez conectado, verás Audio Forge entre los clientes de tu broker, y Home Assistant mostrará el nuevo dispositivo automáticamente (con descubrimiento) o puedes integrarlo manualmente con sensores y botones MQTT.

Ejemplos: automatizaciones simples

Aquí tienes algunas ideas de lo que puedes hacer una vez que MQTT está habilitado:

• Crea un botón de “Batalla” en Home Assistant que inicie una categoría de música “Batalla” en Audio Forge y encienda tus luces en rojo.
• Usa un sensor binario (como “jugadores entran a la mazmorra”) para cambiar al ambiente de la mazmorra y bajar un poco el volumen de la música.
• Vincula un botón de Stream Deck (a través de Home Assistant u otra herramienta compatible con MQTT) para activar un Eco (por ejemplo, trueno, golpe de puerta, rugido de dragón).
• Enlaza tu máquina de niebla a Ecos dramáticos o cambios de música haciendo que todo responda a la misma automatización.

En el fondo, estas automatizaciones solo publican pequeños mensajes JSON al tema de comando de Audio Forge (por ejemplo: {"command":"play","section":"Música","categoryName":"Batalla"}). No necesitas escribir mucho JSON tú mismo si utilizas las entidades de descubrimiento integradas.

Aprende los detalles

Si deseas ver todos los temas, cargas útiles y opciones de comando (incluyendo control de volumen, cambios de categoría y restauración de estado), consulta la guía completa:

Guía de MQTT / Home Assistant

Incluye comandos de ejemplo y una automatización de Home Assistant que puedes copiar-pegar y adaptar a tu mesa.

Obtén Audio Forge 1.4.4

Actualiza ahora y conecta Audio Forge a tu hogar inteligente:

Descargar Audio Forge

¿Tienes preguntas o quieres compartir tus automatizaciones? Únete a la comunidad en Discord.