MQTT / Home Assistant para Audio Forge
Audio Forge 1.4.4 añade integración con MQTT / Home Assistant para que puedas controlar música, ambientación y ecos desde tus automatizaciones del hogar inteligente, botones de escena y superposiciones de transmisión.
- autores
- Slashpaf
- publicado el
Audio Forge 1.4.4 presenta la integración con MQTT / Home Assistant, para que tu mesa de sonido TTRPG finalmente pueda conectarse al resto de tu configuración. Ahora puedes activar música, ambientación y efectos instantáneos 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 con la misma pulsación de botón? Ahora puedes.
Qué puede hacer la integración con MQTT
Con MQTT habilitado, Audio Forge puede:
- Publicar su estado actual (qué biblioteca está activa, si Música/Ambientación 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.
- Utilizar opcionalmente la Descubrimiento de Home Assistant para crear automáticamente entidades (botones, sensores, números, interruptores, selecciones) bajo un dispositivo “Audio Forge”.
Eso significa que puedes:
- Comenzar o pausar Música/Ambientación con un botón de Home Assistant.
- Atenuar automáticamente el volumen de la música cuando cambias de escena.
- Alternar capas de Ambientación con interruptores físicos o virtuales.
- Activar Ecos (sonidos de efecto inmediato) desde eventos de automatización.
Habilitar MQTT en Audio Forge
En la aplicación, ve a Configuración → Control Externo → Integración MQTT y:
- Activa Habilitado.
- Ingresa tu Host y Puerto de MQTT (1883 por defecto, o 8883 para TLS).
- Rellena Usuario / Contraseña si tu broker los requiere.
- Opcionalmente ajusta ID de Cliente, Tema Base (por defecto algo como
audioforge/mi-pc), QoS y si deseas retener el estado. - Activa Publicar estado y Suscribirse a comandos.
- (Opcional pero recomendado) Habilita Descubrimiento MQTT para que Home Assistant cree entidades automáticamente.
Una vez conectado, verás Audio Forge bajo los clientes de tu broker, y Home Assistant mostrará automáticamente el nuevo dispositivo (con descubrimiento) o puedes configurarlo 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 de “Batalla” en Audio Forge y ponga tus luces en rojo.
- Usa un sensor binario (como “jugadores entran a la mazmorra”) para cambiar a tu ambientación de mazmorra y disminuir 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).
- Vincula 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 comandos de Audio Forge (por ejemplo: {"command":"play","section":"Music","categoryName":"Battle"}). No necesitas escribir mucho JSON tú mismo si usas las entidades de descubrimiento integradas.
Aprende los detalles
Si quieres ver todos los temas, cargas útiles y opciones de comandos (incluyendo control de volumen, cambios de categoría y restauración de estado), consulta la guía completa:
Incluye comandos de ejemplo y una automatización de Home Assistant que puedes copiar, pegar y adaptar a tu mesa.
Obtener Audio Forge 1.4.4
Actualiza ahora y conecta Audio Forge a tu hogar inteligente:
¿Tienes preguntas o quieres compartir tus automatizaciones? Únete a la comunidad en Discord.
