Headend — TV en directo de Emby desde receptores Enigma2

Headend es un plugin para Emby que configura la TV en directo de Emby a partir de un receptor Enigma2 (Vu+ Duo 4K, Uno, Solo y similares, con VTi, OpenATV, OpenPLi…) a través de OpenWebif. Los canales que sintoniza tu receptor aparecen en la TV en directo de Emby con una EPG (guía de TV), logos de canales (picons) y control parental.

Qué hace

• Streams de canales de los sintonizadores del receptor, asignados a canales de la TV en directo de Emby (selección de bouquet).
• EPG (guía de TV): guía del receptor más fuentes externas opcionales de XMLTV, combinadas por canal.
• Picons: logos de canales del receptor, o de un enlace que tú proporcionas.
• Escalado por GPU (opcional, NVENC): los canales SD se escalan en el servidor antes de llegar a los clientes.
• PIN de adultos: los canales marcados como adultos requieren un PIN en Emby.
• Watchdog del receptor: detecta un receptor congelado y reinicia enigma2 o lo despierta del standby.

Requisitos

• Emby Server 4.10.1 o superior; Emby Premiere para las funciones de TV en directo.
• Receptor Enigma2 con OpenWebif 1.2.9 o superior, accesible desde el servidor de Emby. Probado: Vu+ Duo 4K con VTi 15.
• Opcional: GPU NVIDIA con NVENC para el escalado.
• Opcional: los segmentos cortos (inicio rápido) necesitan un wrapper instalado como root. El watchdog del receptor (opcional, desactivado en instalaciones nuevas) necesita SSH con root al receptor, sin contraseña o con clave.

Preguntas frecuentes

¿Cómo configuro la TV en directo en Emby con un receptor Enigma2? Instala Headend, escribe la dirección del receptor y el puerto de OpenWebif en Dashboard → Plugins → Headend y elige los bouquets que se convertirán en canales. Después abre Live TV → Settings → Tuner devices, donde Headend aparece como sintonizador, y actualiza la guía. Cada paso está en la guía de instalación.

¿Headend incluye canales de IPTV o una suscripción? No. Headend transmite los canales que tu propio receptor Enigma2 sintoniza desde satélite o cable. No vende ni incluye canales, listas de reproducción ni suscripciones de IPTV.

¿Puedo usar una EPG de XMLTV? Sí. La guía propia del receptor está activada por defecto; puedes añadir URLs de XMLTV externas y asignar los canales por nombre o referencia de servicio. Los datos de la guía se combinan por canal.

¿Puedo grabar la TV en directo? Sí, la grabación funciona como con cualquier sintonizador de Emby. Un sintonizador del receptor lleva un canal cada vez (los canales del mismo transpondedor pueden compartirlo).

Qué envía y a dónde

Todas las conexiones de abajo se inician solo con una licencia válida.

• Tu receptor Enigma2 / Vu+ (OpenWebif, tu dirección; puerto web 80, stream 8001; auth opcional): información, estado de encendido, bouquets, canales, guía (cada 60 min), streams de canales. Los clientes nunca ven la dirección del receptor: los streams pasan por el servidor.
• SSH al receptor (el watchdog; desactivado en instalaciones nuevas desde la versión 0.2.9 hasta que el administrador lo activa; en las actualizaciones se mantiene como estaba): comprobación TCP/HTTP cada 3 min; tras 2 fallos, el comando de reinicio mediante ssh (usuario root por defecto, clave opcional) y después el reinicio del receptor; diagnósticos recogidos por SSH antes de reiniciar; standby tras 10 min de inactividad; búsqueda nocturna de canales (02–06). La clave de host SSH se verifica desde la versión 0.2.9 (trust on first use): se guarda en la primera conexión (ssh/known_hosts en la carpeta de datos) y, si cambia, el comando no se envía y se muestra un mensaje claro; la huella guardada se puede ver y olvidar desde la página.
• Canales de internet (iptv-org) — desactivado en instalaciones nuevas desde la versión 0.2.9 (la lista de comprobación de la primera configuración explica qué contactan; en las actualizaciones se mantienen como estaban), una vez activa la licencia (países por defecto RO, MD): descarga el catálogo público iptv-org.github.io/api/*.json (como máximo cada hora, con ETag), comprueba los streams en los hosts de terceros de los canales (hasta 64 KB, cada 24 h / 6 h) y descarga los logos de los canales. Esos hosts ven la dirección IP de tu servidor. Se puede desactivar en los ajustes. Tus propias listas M3U (URL o archivo) son opcionales.
• Guía externa (EPG) — desactivada en instalaciones nuevas desde la versión 0.2.9 (casilla en la lista de comprobación de la primera configuración; en las actualizaciones se mantiene como estaba), cada día a las 04:00, con 2 s entre peticiones: www.programetv.ro, www.cinemagia.ro, epgshare01.online, open-epg.com (+ tu propio XMLTV, desactivado por defecto). Solo se solicitan páginas o archivos de programación; no se envían datos de usuarios. Las imágenes de los programas se pasan al servidor como URLs externas (el servidor puede descargarlas).
• Logos desde un enlace: solo con acción del administrador (máx. 10 MB). El plugin no descarga packs de picons.
• Local: nvidia-smi para el monitorizado de la GPU.
• Las páginas no cargan recursos externos.
• Además, el cliente de licencias, igual en todos los plugins: consulta Licencias y privacidad en nuestros plugins.

Guardado localmente:

• Datos del receptor (dirección, puertos, usuario de OpenWebif) en la configuración del servidor; desde la versión 0.2.9, la contraseña de OpenWebif se cifra en reposo en secrets.enc.json en la carpeta de datos del plugin (AES-256-GCM, clave aleatoria de secrets.key vinculada al id del servidor, ambos archivos con modo 600) y nunca se envía al navegador (la página solo muestra «set ✓»); las versiones anteriores la guardan en texto plano (en la configuración del sintonizador de TV en directo). Para SSH solo se guardan la ruta de la clave y la clave de host pública del receptor (ssh/known_hosts).
• PIN de canales adultos: solo hash PBKDF2-SHA256 (200,000 iteraciones, con sal). Desde la versión 0.2.10, los PIN nuevos tienen al menos 6 dígitos (un PIN existente sigue funcionando), y los intentos fallidos se limitan con bloqueos crecientes que sobreviven a un reinicio.
• history.json: inicios de canales de las últimas 24 h y uso por minuto (sin nombres de usuario); la guía (historial de 24 h), el catálogo de iptv-org, el búfer en directo en la caché del servidor.
• La exportación «Backup» del administrador contiene la configuración del plugin; desde la versión 0.2.10 ya no contiene el hash del PIN (las versiones anteriores sí). Las direcciones de listas de IPTV, guías y logos no pueden llegar a la red local ni al propio servidor (salvo el receptor configurado), a menos que el administrador active «Local network IPTV sources» (se activa automáticamente en la actualización si las fuentes guardadas ya están en la red local); las direcciones de IPTV se registran sin cuenta ni contraseña.
• La opción «no B-frames for web playback» (activada por defecto) cambia las opciones globales de codificación de Emby; la actualización automática de Emby solo puede desactivarse con una acción del administrador.

Compatibilidad con clientes

• Los canales, la guía, los streams, el bloqueo de canales adultos y las preferencias de audio/subtítulos se sirven a través de la TV en directo del servidor: 🟢 debería funcionar en cualquier app con TV en directo.
• ✅ Emby Web: reproducción real con un Vu+ Duo 4K (VTi, OpenWebif), arranque en frío de 4.4–5.7 s.
• Apps nativas de Emby (Android, iOS, Android TV, Samsung, LG, Roku, Apple TV), navegadores de TV: ❔ sin probar.
• Solo navegador: la página de administración, la página «TV» (estilo Netflix), la página «Adult channels». En las apps, el PIN se desbloquea desde un navegador en /Headend/Unlock (por cuenta; ✅ Chrome, teléfono).

Leyenda: ✅ verificado (prueba de extremo a extremo o en el dispositivo) · 🟢 en el servidor, funciona con cualquier cliente (por diseño, sin prueba específica de cliente) · ➖ no aplica · ❔ sin probar.

Licencias

Una licencia por servidor de Emby. Mensual, anual o de por vida, o incluida en el paquete de Emby. Prueba gratuita de 30 días.