iptv-manager
Herramienta web para gestionar listas M3U y datos EPG con emulación HDHomeRun para integración en Plex, Jellyfin y Emby. Incluye proxy Xtream Codes, soporte OpenVPN, MQTT y gestión de sesiones en Docker.
Ficha actualizada 24 sept 2026, 15:41 · upstream 24 sept 2026, 15:22 · release 0.1
Qué es iptv-manager
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
IPTV Manager es una herramienta basada en web diseñada para gestionar, filtrar y servir listas de reproducción IPTV (M3U) junto con datos de guías electrónicas (EPG). Su función principal es emular un sintonizador HDHomeRun, permitiendo la integración transparente con servidores multimedia como Plex, Jellyfin y Emby sin necesidad de hardware adicional. La aplicación proporciona una interfaz para añadir proveedores, gestionar credenciales y configurar filtros avanzados de canales.
- Integración en servidores multimedia (Plex, Jellyfin, Emby) actuando como sintonizador HDHomeRun virtual.
- Proxy centralizado para aplicaciones Xtream Codes como TiviMate o IPTV Smarters con gestión de credenciales por proveedor.
- Gestión y filtrado de listas M3U externas, permitiendo visualizar canales antes de aplicar filtros estrictos.
- Generación automática de archivos XMLTV compatibles con guías de programas para servidores DVR.
- Ruteo de tráfico a través de OpenVPN para acceder a proveedores IPTV bloqueados geográficamente.
- Reproductor web integrado para probar streams y verificar la disponibilidad de canales directamente en el navegador.
- Emulación nativa HDHomeRun que permite descubrimiento automático por servidores multimedia sin configuración manual compleja.
- Proxy Xtream Codes completo que sirve VOD, series y canales en vivo a través de una única URL con gestión de sesiones.
- Soporte OpenVPN integrado con detección de estado de conexión en tiempo real y publicación de métricas vía MQTT.
- Generación automática de guías EPG normalizando nombres de canales para evitar duplicados y ordenar por número de canal.
- Gestión robusta de sesiones con límites de streams concurrentes, reinicio automático ante caídas y bloqueo temporal tras desconexión.
- Interfaz web completa que incluye dashboard estadístico, editor de filtros y reproductor de video integrado (mpegts.js).
- Requiere capacidades especiales en Docker (`NET_ADMIN`, `/dev/net/tun`) para habilitar el soporte OpenVPN correctamente.
- La calidad y disponibilidad de los datos de la guía dependen de las fuentes externas configuradas (ej. epg.pw).
- Los canales con bucles infinitos o repetitivos no reciben datos de guía real, mostrando entradas de relleno.
- El proxy actúa como intermediario; el usuario debe asegurarse de que el proveedor IPTV tenga licencia para el contenido distribuido.
- El filtrado basado en nombres exactos puede requerir normalización manual si los proveedores usan nombres inconsistentes.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utilizar `docker-compose.yml` proporcionado. Configurar `HDHR_ADVERTISE_HOST` con la IP LAN del servidor. Asegurar puertos 5005 abiertos y acceso a red para OpenVPN. Si se usa Home Assistant, habilitar integración MQTT en la UI. Verificar que los streams no sean bloqueados por Cloudflare si el proveedor lo requiere.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.