MediaLab TV para Jellyfin — guía

Instalación

Necesitas Jellyfin Server 12.2 o más nuevo 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 Jellyfin o la prueba gratuita de 30 días).

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

1. En tu cuenta de MediaLab Works abre Licenses → Jellyfin plugin repository y haz clic en Create address. Cópiala: es privada (contiene un token), así que no la compartas; puedes regenerarla o revocarla en cualquier momento.
2. En Jellyfin abre Dashboard → Plugins → Repositories, haz clic en +, ponle un nombre (por ejemplo, MediaLab Works), pega la dirección y guarda.
3. En Dashboard → Plugins → Catalog busca MediaLab TV, haz clic en Install y reinicia Jellyfin.

El repositorio solo enumera los plugins que tus licencias cubren, 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 fresca.

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

Manualmente, desde un archivo zip.

1. En Account → Licenses descarga jf-tvapp_x.y.z.zip (el SHA-256 del archivo se muestra junto al botón).
2. Extráelo en una carpeta nueva MediaLab TV_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 Dashboard → Plugins → MediaLab TV y haz clic en License.
2. Pega tu clave de licencia y haz clic en Activate with key. El plugin contacta con el servidor de licencias, vincula la clave a este servidor Jellyfin y muestra la licencia como Active.
3. ¿Todavía no tienes clave? En la misma página introduce tu correo e inicia la prueba gratuita de 30 días (se necesita tarjeta, nada que pagar hoy) o compra una licencia; el plugin se activa solo cuando el pago se realiza.

La licencia se comprueba una vez al día y en cada arranque de Jellyfin. Sin internet el plugin sigue funcionando durante 7 días tras la última comprobación exitosa. Sin una licencia válida, el plugin detiene su trabajo y solo su página License sigue funcionando (prueba, clave, renovación); no se elimina 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 nuevas versiones en Dashboard → Plugins y puede actualizar el plugin automáticamente; reinicia Jellyfin para cargar la nueva versión.
• Desde la página License del plugin: con una licencia válida, Install update instala la versión más nueva que tu licencia permite 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 verifican contra la suma de comprobación 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 en la última versión que puede usar.
• Tras una reversión, si tu repositorio de plugins está añadido en Jellyfin, la tarea programada de Jellyfin Update Plugins (al arrancar y cada día) instala de nuevo la versión más nueva. Para quedarte un tiempo en la versión anterior, elimina los disparadores de esa tarea en Dashboard → Scheduled Tasks y añádelos de nuevo más tarde.

Código fuente

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

Marca

Abre MediaLab TV en el menú del panel de control de Jellyfin.

• App name: el título en la TV (por defecto, «MediaLab TV»).
• Short name: se muestra en la lista de dispositivos del servidor y como nombre de la app guardada en la TV.
• Line under the name y footer line: opcionales (por ejemplo, tu sitio web y cómo contactar con el soporte). Un pie vacío muestra «Unofficial app, compatible with Jellyfin servers» en el idioma de la TV.
• Colors: el acento (botones, foco) y el fondo, como #rrggbb. El color del texto se elige automáticamente para que siga siendo legible.
• Language: automático (el idioma del navegador de la TV), inglés o rumano.
• Logo: PNG o SVG, como máximo 512 KB; una imagen cuadrada queda mejor. Los SVG con scripts se rechazan.
• Buttons: «Sign in with your phone» y «New account (from the phone)».

La preview muestra el resultado antes de que hagas clic en Save.

Tras iniciar sesión

• «After sign-in, open»: la interfaz de MediaLab TV (la opción predeterminada: banner, filas, páginas de título, su propio reproductor y los botones de salto) o Jellyfin Web.
• «Remember the password on TVs» (desactivado por defecto): la TV guarda solo el token de inicio de sesión del servidor, no la contraseña; actívalo solo para TVs que pierden el token constantemente. Una contraseña guardada por la versión 1.1 se usa una vez, si hace falta, y luego se elimina.
• En la TV, el menú de perfil cambia el TV mode (elegido automáticamente en Tizen, webOS, Android TV, Google TV y TVs Philips) y cierra la sesión.

Dirección para las TVs

• /MediaLabTv/ en la dirección de tu servidor: siempre funciona.
• Tu propia ruta, por ejemplo, /web/tv/ (la ruta predeterminada es tv), servida directamente por el plugin: la barra de direcciones mantiene /web/tv/, no se escribe nada en los archivos de Jellyfin y no hay que rehacer nada tras las actualizaciones de Jellyfin. Se respeta una URL base establecida en Jellyfin. Una ruta que ya existe en la interfaz web de Jellyfin nunca se sobrescribe: elige otra.

En cada TV, abre la dirección una vez en el navegador y guárdala como página de inicio o favorita.

Inicio de sesión con el teléfono y cuentas nuevas

Ambos usan el propio Quick Connect de Jellyfin: actívalo en Dashboard → General.

• Sign in with your phone: la TV muestra un código de 6 dígitos. Un usuario con sesión iniciada lo aprueba en el teléfono, en la app de Jellyfin (Settings → Quick Connect). Con Quick Connect by MediaLab instalado, la TV también muestra un código QR que abre la página de aprobación.
• New account (from the phone): con Registration by MediaLab, la TV muestra un código QR hacia la página de registro y un código para escribir en el formulario. Cuando la cuenta se activa (tras la aprobación del administrador o, con Cashier by MediaLab, tras el pago), la TV inicia sesión sola.

Resolución de problemas

• La TV muestra «Service unavailable»: la licencia no es válida, o el servidor no ha contactado con medialab.works en más de 7 días. Revisa la página License del plugin.
• Falta «Sign in with your phone»: Quick Connect está desactivado en Jellyfin (Dashboard → General).
• La dirección corta muestra la página propia de Jellyfin: esa ruta ya existe en la interfaz web; elige otra ruta.
• Un vídeo no se reproduce en el navegador de la TV: revisa los ajustes de reproducción de ese usuario en Jellyfin (tasa de bits máxima de streaming, transcodificación permitida); el servidor transcodifica lo que el navegador no puede reproducir.