Matterbridge

Matterbridge es un addon que permite exponer los dispositivos de Home Assistant hacia controladores Matter externos como Alexa, Google Home o Apple HomeKit. Todo funciona de forma local, sin pasar por la nube, sin abrir puertos y totalmente gratis (sin Nabu Casa).

Nota alternativa

Existe otra opción llamada Matter Hub (fork de RiDDiX) que ofrece funcionalidad similar. Ambas soluciones pueden coexistir si quieres usar ambas.

Warning

Matter requiere que IPv6 esté activado en la red local. Los controladores Matter (Echo, Google Nest, etc.) usan IPv6 para descubrir y comunicarse con el bridge. Si IPv6 está bloqueado o desactivado, el emparejamiento fallará.

Requisitos previos

Es necesario un controlador compatible con el estándar Matter según la plataforma que se vaya a usar:

Instalación del addon

Hay que añadir el repositorio de Matterbridge a la tienda de complementos de Home Assistant y luego instalarlo.

Note

Se recomienda activar también Mostrar en el panel lateral para acceder a Matterbridge directamente desde la barra lateral de Home Assistant.

Instalación del plugin matterbridge-hass

Una vez instalado el addon, hay que abrir la interfaz de Matterbridge y añadir el plugin matterbridge-hass, que es el que permite la comunicación con Home Assistant.

Token de seguridad

Para vincular Matterbridge con Home Assistant es necesario generar un token de acceso de larga duración:

  1. Ir al perfil de usuario en Home Assistant
  2. Ir a la pestaña de Seguridad
  3. Bajar hasta Tokens de acceso de larga duración y crear uno nuevo
  4. Copiar el token generado y pegarlo en la configuración de Matterbridge

Selección de dispositivos con etiquetas

Para no exponer todos los dispositivos, se recomienda crear una etiqueta (label) llamada matterbridge y asignarla solo a las entidades que se quieran controlar por voz (luces, termostatos, persianas...).

En la configuración de Matterbridge se filtra para que solo se sincronicen las entidades que tengan esa etiqueta.

Vincular con controladores

Vinculación con Google Home

Consulta los pasos detallados en Vincular con Google Home.

Vinculación con Alexa

Consulta los pasos detallados en Vincular con Alexa.

Note

Si el dispositivo Alexa (Echo) está apagado o desenchufado, todos los dispositivos vinculados aparecerán como "No disponible" en la app de Alexa. Esto es normal ya que el Echo actúa como controlador Matter; en cuanto se encienda volverán a estar disponibles.

Note

¿Por qué aparecen 2 dispositivos al emparejar? Matterbridge expone por defecto dos interruptores virtuales de control: Update Matterbridge y Restart Matterbridge. Si no los necesitas puedes desactivarlos desde la configuración del plugin matterbridge-hass.

Añadir una segunda plataforma

Si más adelante quieres vincular Matterbridge con una segunda plataforma (por ejemplo, añadir Google Home cuando Alexa ya está configurada, o viceversa), consulta Añadir una segunda plataforma de voz.

Para vincular con Apple HomeKit, no se usa Matterbridge sino la integración nativa de Home Assistant. Consulta Vincular con Apple HomeKit.

Añadir nuevos dispositivos tras la conexión inicial

Una vez que Matterbridge ya está vinculado con Alexa, para que un nuevo dispositivo aparezca en Alexa basta con:

  1. Añadir el dispositivo en Home Assistant y comprobar que funciona correctamente
  2. Asignarle la etiqueta matterbridge
  3. Abrir la app de Alexa e ir a Dispositivos → Descubrir dispositivos, o decir "Alexa, descubre dispositivos"

No es necesario volver a emparejar Matterbridge ni escanear ningún código.

Ver también: Matter Hub, Matter Server