Headend para Jellyfin — guía de instalación

Instalación

Necesitas Jellyfin Server 12.2 o posterior y una cuenta de MediaLab Works con una licencia que cubra el plugin (una suscripción activa, una licencia de por vida dentro de su período de actualizaciones, el paquete para Jellyfin o la prueba gratuita de 30 días).

Desde tu repositorio de plugins (recomendado). Jellyfin instala y actualiza el plugin por sí solo.

1. En tu cuenta de MediaLab Works abre Licencias → Repositorio de plugins para Jellyfin y pulsa Crear URL del repositorio. Cópiala: es privada (contiene un token), así que no la compartas; puedes regenerarla o revocarla en cualquier momento.
2. En Jellyfin abre Panel de control → Complementos → Repositorios, pulsa +, dale un nombre (por ejemplo MediaLab Works), pega la dirección y guarda.
3. En Panel de control → Complementos → Catálogo busca Headend by MediaLab, pulsa Instalar y reinicia Jellyfin.

El repositorio solo muestra los plugins que cubren tus licencias, y solo las versiones que permiten. Sus enlaces de descarga están firmados y caducan a las pocas horas, así que Jellyfin siempre lee una lista nueva.

Desde el catálogo público. https://medialab.works/jellyfin/manifest.json muestra todos los plugins publicados de MediaLab Works con su compilación pública; medialab Server lo añade por sí solo. Puedes añadirlo del mismo modo para instalar un plugin antes de tener una clave: el plugin te pide entonces la licencia, o inicia la prueba, en su página License. Con una licencia de por vida cuyo período de actualizaciones ha terminado, quédate en tu repositorio privado, que solo ofrece las versiones que permite tu licencia.

Manualmente, desde un archivo zip.

1. En Cuenta → Licencias descarga jf-headend_x.y.z.zip (el SHA-256 del archivo se muestra junto al botón).
2. Extráelo en una carpeta nueva Headend by MediaLab_x.y.z.0 dentro de la carpeta de plugins de Jellyfin:
   • Linux (paquete): /var/lib/jellyfin/plugins/
   • Docker (imagen oficial): /config/plugins/ en el volumen de configuración
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Reinicia Jellyfin.

Activación de la licencia

1. Abre la página del plugin en Panel de control → Complementos → Headend by MediaLab y pulsa Open License page.
2. Pega tu clave de licencia y pulsa Activate with key. El plugin contacta con el servidor de licencias, vincula la clave a este servidor de Jellyfin y muestra la licencia como Active.
3. ¿Todavía no tienes clave? En la misma página introduce tu dirección de correo e inicia la prueba gratuita de 30 días (necesitas tarjeta, hoy no pagas nada) o compra una licencia; el plugin se activa solo cuando se completa el pago.

La licencia se comprueba una vez al día y en cada arranque de Jellyfin. Sin internet el plugin sigue funcionando 7 días después de la última comprobación correcta. Sin una licencia válida el plugin detiene su trabajo y solo sigue funcionando su página License (prueba, clave, renovación); no se borra nada y todo se reanuda en cuanto la licencia vuelve a ser válida. Move license (release this server), en la misma página, libera la clave para otro servidor.

Actualizaciones y reversión

• Desde el repositorio: Jellyfin muestra las versiones nuevas en Panel de control → Complementos y puede actualizar el plugin automáticamente; reinicia Jellyfin para cargar la versión nueva.
• Desde la página License del plugin: con una licencia válida, Install update instala la versión más reciente que permite tu licencia y Roll back to x.y.z vuelve a la versión anterior (por ejemplo, si algo dejó de funcionar tras una actualización). Reinicia Jellyfin después de cualquiera de las dos. Ambos paquetes se comprueban con la suma de control publicada por el servidor de licencias.
• Una licencia de por vida recibe las versiones publicadas durante su período de actualizaciones; después, el plugin sigue funcionando con la última versión que puede usar.
• Tras Roll back to x.y.z, la actualización automática de Jellyfin para ese plugin se desactiva hasta el siguiente Install update en la página License, de modo que la tarea programada Update Plugins (en el arranque y cada día) no vuelva a traer la versión nueva.
• Licencia de por vida y actualizaciones automáticas. El catálogo público de Jellyfin (https://medialab.works/jellyfin/manifest.json) siempre ofrece la versión más reciente. Cuando el período de actualizaciones de una licencia de por vida ha terminado, las versiones publicadas después no tienen licencia: si las actualizaciones automáticas de plugins de Jellyfin instalan una, el plugin se detiene con «version not licensed» hasta que vuelves atrás con Roll back to x.y.z en su página License o compras un pase de actualizaciones. Para evitarlo, no dejes que Jellyfin actualice este plugin automáticamente: añade tu repositorio privado de plugins, que solo ofrece las versiones que permite tu licencia, en lugar del catálogo público, o quita los desencadenantes de la tarea programada Update Plugins en Panel de control → Tareas programadas (esto detiene las actualizaciones automáticas de todos los plugins).

Código fuente

El código fuente GPL-3.0 de cada versión está en Cuenta → Licencias (Código fuente), junto a la descarga, como archivo .tar.gz creado a partir del commit exacto de esa versión.

Configuración

1. Abre Panel de control → TV en directo, añade un dispositivo sintonizador del tipo Headend (Enigma2 / Vu+) e introduce el receptor: dirección, puerto de OpenWebif (80) y puerto de stream (8001), nombre de usuario y contraseña si OpenWebif los pide, y los bouquets que importar.
2. Añade el proveedor de guía Headend en la misma página, para que la guía de programación proceda del receptor.
3. Abre Panel de control → Headend para ajustar la lista de canales (nombres, números, orden, logos, canales para adultos) y para dar acceso a la TV en directo a los usuarios que deban tenerlo; los usuarios nuevos empiezan sin él.
4. Actualiza la guía (Panel de control → Tareas programadas → Refresh Guide); los canales aparecen en TV en directo.

Solución de problemas

• No hay canales: comprueba que OpenWebif se abre en un navegador desde el servidor de Jellyfin en la dirección que introdujiste.
• Un canal no se reproduce: un sintonizador solo puede recibir un transpondedor a la vez; una grabación u otro espectador en un transpondedor distinto puede ocuparlo.
• Un usuario no ve la TV en directo: concede acceso al usuario desde la página de Headend.