Integración domótica MeTube, gratuita y de código abierto

MeTube en Gladys: cola de descargas, terminadas y fallidas, añadir un vídeo desde una escena.

• Publicado por guim31
• Dispositivos
• Versión 1.0.0
• Requiere Gladys >=5.2.0
• ★ 0

Ver en GitHubTodas las integraciones

Lleve su servidor MeTube (la interfaz web autoalojada de yt-dlp, para descargar un vídeo o una lista bajo demanda) a Gladys, en su red local: la cola de descargas con su progreso, las descargas terminadas y fallidas en un panel, escenas que reaccionan cuando una descarga termina o falla, y una acción que añade un vídeo a MeTube.

La integración se ha probado con un MeTube 2026.10.23 real (la imagen Docker oficial, con la descarga real de un vídeo de dominio público), todavía no en una instalación real de Gladys: sus comentarios son bienvenidos en el foro de Gladys o en las issues.

Descargue solo lo que tenga derecho a descargar: vídeos de dominio público, bajo licencia libre, o los suyos.

Lo que necesita

• Gladys Assistant 5.2.0 o posterior.
• Un servidor MeTube, accesible desde Gladys (misma red), en el puerto de su interfaz web (8081 por defecto).
• Si un proxy inverso delante de MeTube pide una contraseña (MeTube en sí no tiene), ese usuario y esa contraseña.

Instalación

1. Instale la integración desde el catálogo de Gladys.
2. En Configuración, introduzca la Dirección de MeTube (por ejemplo 192.168.1.2:8081; sin puerto, se usa 8081). Si MeTube funciona con un URL_PREFIX, añádalo: 192.168.1.2:8081/metube. Detrás de un proxy inverso que pide una contraseña, rellene también el Usuario y la Contraseña.
3. Guarde y haga clic en Probar la conexión: el mensaje bajo el botón indica las versiones de MeTube y de yt-dlp, y las descargas en curso, en espera, terminadas y con error.
4. Abra la pestaña Descubrir: un dispositivo para el servidor. Haga clic en Añadir, elija una habitación y guarde.

Opciones:

• Intervalo de actualización: de 10 segundos a 2 minutos (30 segundos por defecto). MeTube escribe una línea en su propio registro en cada lectura.
• Idioma de los nombres de funciones: los nombres que reciben las funciones al añadir el dispositivo (francés por defecto) y el idioma de los mensajes de la acción de escena.

La integración lee el historial de MeTube (/history, la misma lista que muestra su página web) y añade enlaces mediante /add, como la página web. Nunca elimina una descarga ni un archivo.

El dispositivo

Un dispositivo, MeTube seguido de la dirección del servidor:

Función	Lo que indica
En línea	1 cuando MeTube responde, 0 si no
Descargas en curso	descargas en marcha (preparación, descarga)
Descargas en espera	esperan un hueco libre o el botón Start
Descargas terminadas	descargas terminadas en el historial de MeTube
Descargas con error	descargas fallidas en el historial de MeTube
Progreso de la descarga en curso	en porcentaje, 0 cuando no se descarga nada
Velocidad de descarga	en MB/s, todas las descargas juntas
Descarga en curso	su título, como texto («Ninguna descarga» en reposo)
Última descarga terminada	su título, como texto

Las descargas terminadas y fallidas son las que MeTube guarda en su historial: cuando las borra en MeTube, las cifras bajan.

Panel

El widget Descargas de MeTube muestra tres mosaicos (en curso, en espera, con error), la cola (título, progreso y velocidad, o lo que espera) y las últimas descargas terminadas o fallidas (título, archivo o error, tamaño). Dos botones:

• Añadir un vídeo: un formulario con el enlace y la calidad; el vídeo se añade a MeTube y empieza de inmediato.
• Iniciar: solo aparece cuando descargas añadidas sin inicio automático esperan el botón Start de MeTube; las inicia todas.

Añádalo desde el editor del panel; no necesita ningún ajuste y funciona incluso antes de añadir el dispositivo.

Escenas

Disparadores

• Descarga de MeTube terminada: una descarga acaba de terminar, sin importar quién la añadió (la página web de MeTube, su extensión del navegador, Gladys). Información transmitida a las acciones: el título, el enlace del vídeo, el nombre del archivo y el tamaño en MB.
• Descarga de MeTube fallida: una descarga ha fallado (enlace no compatible, vídeo no disponible o privado, error de yt-dlp). Información: el título, el enlace y el mensaje de error.

Cada descarga se anuncia una sola vez, incluso tras un reinicio de la integración. Lo que MeTube ya tenía en su historial cuando se introdujo su dirección no se anuncia; lo que terminó mientras la integración estaba detenida se anuncia al reiniciarse. El mismo enlace descargado de nuevo se anuncia de nuevo.

Acciones

• Añadir un vídeo a MeTube: añade un vídeo o una lista a la cola de MeTube, iniciada de inmediato. Campos: el Enlace (también sirve una variable de un paso anterior) y la Calidad: mejor vídeo, 1080p, 720p, 480p o solo audio (MP3). Cuando MeTube rechaza el enlace, la acción falla con su mensaje.

Ideas de escenas

• Cuando termine una descarga de MeTube, envíese un mensaje: «{title} está listo ({size_mb} MB)».
• Cuando falle una descarga, envíese el mensaje de error, para comprobar el enlace o actualizar yt-dlp.
• Cada domingo a las 8, añada el enlace de un programa o pódcast semanal de dominio público en solo audio, para escucharlo más tarde.

Solución de problemas

• «MeTube no responde»: compruebe la dirección y el puerto (8081), y que Gladys puede acceder al servidor (misma red, cortafuegos).
• «No hay ningún MeTube en esta dirección»: otro servicio responde en este puerto, o MeTube funciona con un URL_PREFIX que falta en la dirección.
• «Usuario o contraseña rechazados o ausentes»: un proxy inverso pide una contraseña; introduzca su usuario y su contraseña.
• «La dirección redirige»: un proxy inverso envía a una página de acceso o a HTTPS; introduzca la dirección directa de MeTube en su red.
• «MeTube ha rechazado el enlace»: yt-dlp no admite el sitio, o el vídeo no está disponible; el mensaje de MeTube indica por qué.
• Más detalles: ponga el LOG_LEVEL de la integración en debug y abra sus registros.

Límites

• Una descarga se ve en la lectura siguiente: dentro del intervalo de actualización.
• Una descarga que MeTube borra por sí solo de su historial (CLEAR_COMPLETED_AFTER) antes de la lectura siguiente no se anuncia.
• Como máximo 10 eventos de cada tipo por lectura: más allá (una ráfaga de descargas), se cuentan, no se anuncian.
• La integración no elimina descargas ni archivos, no cancela una descarga y no gestiona las suscripciones de MeTube. Para seguir canales y listas de YouTube automáticamente, vea la integración Pinchflat.
• No se admite un proxy inverso con página de acceso (OAuth, Authelia…): solo una autenticación básica (usuario y contraseña).
• Sin relación con MeTube, yt-dlp ni ningún sitio de vídeos.

Parámetros de configuración

Estos son los parámetros que MeTube te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Servidor MeTube	section	No	Dirección de la interfaz web de MeTube. La integración lee su cola de descargas y añade los enlaces que usted envía desde Gladys.
Dirección	string	No	Dirección IP o nombre del servidor, con el puerto de la interfaz web (8081 por defecto) y el URL_PREFIX si MeTube tiene uno.
Usuario	string	No	Solo si un proxy inverso delante de MeTube pide una contraseña (MeTube en sí no tiene).
Contraseña	secret	No	Contraseña del proxy inverso, con el usuario de arriba.
Intervalo de actualización	select	No	Con qué frecuencia se lee la cola de MeTube: progreso, descargas terminadas y fallidas.
Idioma de los nombres de funciones	select	No	Nombres de las funciones al añadir el dispositivo y textos que envía la integración.

Cómo instalar MeTube en Gladys

1. En Gladys, abre Integraciones: MeTube aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-metube:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-metube.

MeTube requiere Gladys >=5.2.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas

MeTube es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

• Explorar todas las integraciones, nativas y de la comunidad
• Crear y publicar tu propia integración externa
• Código fuente en GitHub — fuente de esta documentación

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂