iptv-webui
Interfaz web autoalojada para paneles Xtream Codes IPTV con guía de TV en vivo, soporte Chromecast, enriquecimiento TMDB y transcodificación fallback. Multiusuario con credenciales cifradas AES-256-GCM.
Ficha actualizada 28 sept 2026, 12:18 · upstream 28 sept 2026, 11:57 · release sin release detectada
Qué es iptv-webui
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Khouch Potato es una interfaz web autoalojada diseñada específicamente para paneles Xtream Codes IPTV, construida porque las aplicaciones móviles/TV de revendedores son deficientes. Permite navegar por más de 10k canales en vivo, películas y series con búsqueda instantánea, estilo Netflix con carriles por categoría, guía de TV completa semanal y soporte Chromecast.
El sistema soporta múltiples usuarios con credenciales de panel cifradas AES-256-GCM por usuario, donde cada invitado trae sus propias credenciales sin ver las del propietario. Dentro de un único login, existen perfiles separados con favoritos, recientes, progreso de visualización y sincronización automática entre cliente web y aplicación Android TV.
Incluye enriquecimiento TMDB con pósters, fondos, sinopsis y calificaciones, transcodificación con ffmpeg para codecs que el navegador no puede decodificar (principalmente MPEG-2 SD), y un endpoint MCP para asistentes de IA que pueden controlar la interfaz mediante tokens SHA-256.
La arquitectura usa Express.js con Traefik como proxy inverso, cache en memoria con TTL de 1 hora, y despliegue automático vía GitHub Actions a VPS con Let's Encrypt. El servidor solo proxya metadatos y segmentos; el tráfico Chromecast va directo panel→Chromecast sin redirigir.
- Visualización de TV en vivo con guía EPG filtrable por idioma, calidad 4K, deportes, noticias y más
- Navegación estilo Netflix para películas y series con listas favoritas, progreso guardado y sincronización multi-dispositivo
- Control vía asistente de IA mediante endpoint MCP para integración con Home Assistant o automatizaciones
- Perfil infantil con bloqueo por edad certificado TMDB (ej. evitar contenido inapropiado para menores)
- Despliegue en servidor propio con despliegue automático a VPS y frontend HTTPS gestionado por Traefik
- Credenciales de panel cifradas AES-256-GCM por usuario, sin exposición cruzada entre perfiles
- Sincronización automática de favoritos, progreso y estado entre web y aplicación Android TV
- Endpoint MCP stateless para control por asistentes de IA con tokens SHA-256 rotativos
- Cache pre-carga TMDB tras cada build del índice para carga inmediata de pósters y metadatos
- Transcodificación con ffmpeg como fallback para streams que el navegador no puede decodificar en MSE
- Los paneles IPTV suelen limitar max_connections=1 por cuenta, lo que causa conflictos si la app TV y web se usan simultáneamente
- Requiere suscripción legítima al panel IPTV; no elude DRM ni autenticación del proveedor
- Safari usa HLS nativo mientras Chrome/Edge/Firefox requieren hls.js para reproducción de streams
- El endpoint /api/bootstrap es lento en primera carga al rascar ~600 categorías del panel
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.
Copiar .env.example a .env y configurar IPTV_HOST, APP_PASS, TMDB_API_KEY. Para despliegue Docker usar compose.yml con Traefik frontend. GitHub Actions auto-deploya a VPS al push a main (~2-3 min). Rotar PROXY_SECRET solo si se reinicia el servidor. Portos: 3737 (app), 3000 (fallback opcional).
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.