Integración domótica Tvheadend, gratuita y de código abierto
Su grabador Tvheadend en Gladys: grabaciones, espacio libre, reproducciones y escenas.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Tvheadend es el servidor de TV y grabador libre de muchos hogares: lee sintonizadores DVB (TDT, satélite, cable) y listas IPTV, envía los canales a Kodi, a un navegador o a una aplicación de TV, y graba programas. Esta integración lleva su grabador a Gladys: lo que graba ahora, lo que viene después, las grabaciones fallidas, el espacio libre, quién ve qué, y escenas que reaccionan a una grabación que empieza, termina o falla, a alguien que empieza a ver la tele o a un disco que se llena.
¿Busca la guía de TV? Vea la integración Programme Télé: esta no la repite.
Probada con un Tvheadend 4.3 real en Docker (imagen
lscr.io/linuxserver/tvheadend), con una red IPTV que lee un flujo de prueba
servido por ffmpeg: grabaciones programadas, en curso, terminadas y fallidas,
un flujo cortado, una reproducción, una cuenta de administrador y una cuenta
solo de grabación. Desarrollada sin sintonizador DVB: sus comentarios son
bienvenidos en las issues.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Tvheadend 4.2 o posterior, accesible desde Gladys (puerto 9981 por defecto).
- Un usuario de Tvheadend con contraseña, y una entrada de acceso con los derechos Interfaz web y Grabador de vídeo (básico, todas las grabaciones, grabaciones fallidas). Con el derecho Admin, la integración muestra también las reproducciones y los sintonizadores en uso.
Primeros pasos
1. Crear un usuario para Gladys
En Tvheadend, Configuración → Usuarios:
- Entradas de acceso → Añadir: usuario
gladys, derechos Interfaz web y Grabador de vídeo (marque también «Todas las grabaciones» y «Grabaciones fallidas»), y Admin si desea las reproducciones y los sintonizadores. - Contraseñas → Añadir: el mismo usuario y una contraseña.
2. Configurar la integración
En Gladys, abra la integración y rellene:
- Dirección de Tvheadend:
http://192.168.1.2:9981(una dirección sin puerto usa el 9981; una URL copiada del navegador también funciona). - Usuario y Contraseña: el usuario creado arriba. La autenticación Digest y la Basic funcionan las dos.
- Intervalo de actualización: 30 segundos por defecto.
- Idioma de los nombres: el idioma de los nombres de las funciones, de las fechas y de los resultados de escena.
Después use Probar la conexión: lee Tvheadend y resume lo que graba, lo siguiente y el espacio libre.
3. Añadir el dispositivo
Abra la pestaña Descubrir: el servidor es un dispositivo llamado
Tvheadend. Añádalo.
Los dispositivos
| Función | Lo que indica |
|---|---|
| Accesible | Sí mientras Tvheadend responde |
| Grabaciones en curso | Las grabaciones en curso |
| Grabaciones programadas | Las grabaciones por venir (activadas) |
| Grabaciones fallidas (24 h) | Las grabaciones terminadas con error en las últimas 24 horas |
| Grabando ahora | «Título (Canal)» de lo que se graba («—» si nada) |
| Próxima grabación | «Título · Canal · vie 20:30» («—» si no hay nada previsto) |
| Espacio libre | Espacio libre de la carpeta de grabación, en GB |
| Espacio libre (%) | Lo mismo, en porcentaje |
| Reproducciones en curso | Personas que ven un canal (Kodi, navegador…), cuenta de administrador |
| Sintonizadores en uso | Sintonizadores (entradas) ocupados, cuenta de administrador |
No hay un dispositivo por sintonizador: Tvheadend solo lista los que están en uso.
Panel
El widget Grabaciones Tvheadend muestra lo que se graba ahora (título, canal y hora de fin), o la próxima grabación; mosaicos para las grabaciones programadas, el espacio libre y (cuenta de administrador) las reproducciones; después una fila por grabación en curso y por venir.
Escenas
Disparadores
Los disparadores de grabación pueden limitarse a un canal: escriba su nombre tal como lo muestra Tvheadend (vacío: todos los canales).
- Empieza una grabación: Tvheadend empieza a grabar, con el título, el canal, la hora de fin y la duración prevista.
- Termina una grabación: una grabación ha terminado y su archivo está en el disco, con el título, el canal, la duración y el número de errores de flujo.
- Falla una grabación: una grabación terminó con error (sin señal, sin sintonizador libre, archivo no creado, hora perdida…), con el motivo de Tvheadend, en inglés.
- Empieza una reproducción: un cliente empieza a ver un canal, con el canal, el usuario de Tvheadend y el cliente. Puede limitarse a un canal o a un usuario. Requiere una cuenta de administrador.
- El espacio libre baja de un umbral: elija 5, 10, 15, 20 o 25 %; se dispara una vez, y de nuevo solo después de que el espacio libre vuelva a superarlo.
La integración guarda lo que ha visto: un reinicio de Gladys no anuncia dos veces una grabación, y una grabación terminada mientras tanto se anuncia una vez.
Acciones
- Grabar un canal ahora: graba un canal (su nombre o su número, tal como lo muestra Tvheadend) desde ahora, de 1 a 720 minutos, con un título opcional. Da el título, el canal, las horas de inicio y de fin.
- Resumen de grabaciones: lee Tvheadend para las siguientes acciones: grabaciones en curso y programadas, lo que se graba, la próxima grabación (título, canal, hora), el espacio libre y una frase lista («1 grabación(es) en curso (Telediario), próxima: Película · La 1 · vie 20:30, 120 GB libres (24 %)»).
Ideas de escenas
- Alerta de fallo: «Falla una grabación» le envía un mensaje con el título y el motivo, para volver a programarla.
- Nadie en casa a las 20:55: cuando la alarma está activada, «Grabar un canal ahora» graba el telediario durante 40 minutos.
- Disco casi lleno: «El espacio libre baja de un umbral» (10 %) envía una notificación; una escena matinal dice la frase de «Resumen de grabaciones».
- Modo cine: «Empieza una reproducción» con la cuenta del salón atenúa las luces.
Solución de problemas
- Tvheadend no responde: compruebe la dirección y el puerto 9981 desde la máquina de Gladys.
- Usuario o contraseña rechazados (o sin derecho a la interfaz web): Tvheadend responde igual a una contraseña errónea y a una cuenta sin el derecho Interfaz web; compruebe los dos.
- La cuenta no tiene derecho de grabación: marque Grabador de vídeo en la entrada de acceso del usuario.
- Ni reproducciones ni sintonizadores: la cuenta no es administradora (la prueba de conexión lo indica); el resto funciona.
- Una grabación cortada a mitad «termina»: el propio Tvheadend indica «Completed OK» para un flujo perdido durante la grabación; solo falla un flujo ausente al inicio.
Límites
- Un solo servidor Tvheadend por integración.
- Tvheadend se lee al intervalo elegido (30 segundos por defecto), no en tiempo real: una reproducción más corta que el intervalo puede pasar desapercibida.
- El motivo de un fallo es el de Tvheadend, en inglés.
- Sin dispositivo por sintonizador, ni señal ni SNR: Tvheadend solo lista los sintonizadores en uso.
- La acción de escena programa una grabación; no anula ni borra ninguna.
- «Empieza una reproducción» se dispara una vez por cliente (dirección, usuario, aplicación): cambiar de canal no lo vuelve a disparar.
- Una grabación cuyo archivo se mueve o se borra después sigue siendo una grabación terminada.
- Sin relación con el proyecto Tvheadend.
Parámetros de configuración
Estos son los parámetros que Tvheadend te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su servidor Tvheadend | section | No | Introduzca la dirección de Tvheadend (puerto 9981) y una cuenta con derechos de grabación e interfaz web. Una cuenta de administrador muestra también las reproducciones y los sintonizadores en uso. El servidor aparece en la pestaña Descubrir. |
| Dirección de Tvheadend | string | Sí | Dirección de la interfaz web de Tvheadend (puerto 9981 por defecto). |
| Usuario | string | Sí | Un usuario de Tvheadend (Configuración → Usuarios → Entradas de acceso). |
| Contraseña | secret | Sí | |
| Opciones | section | No | |
| Intervalo de actualización | select | No | Con qué frecuencia se lee Tvheadend: unas pocas peticiones ligeras cada vez. |
| Idioma de los nombres | select | No | Idioma de los nombres de las funciones (fijados al añadir el dispositivo), de las fechas y de los resultados de escena. |
Cómo instalar Tvheadend en Gladys
- En Gladys, abre Integraciones: Tvheadend aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-tvheadend: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). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-tvheadend.
Tvheadend requiere Gladys >=5.1.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
Tvheadend 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