Quick Connect para Jellyfin — guía

Instalación

Necesitas Jellyfin Server 12.2 o superior 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 de 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 Licenses → Jellyfin plugin repository y haz clic en Create address. Cópialo: es privado (contiene un token), así que no lo compartas; puedes regenerarlo o revocarlo en cualquier momento.
2. En Jellyfin abre Dashboard → Plugins → Repositories, haz clic en +, dale un nombre (por ejemplo MediaLab Works), pega la dirección y guarda.
3. En Dashboard → Plugins → Catalog busca Quick Connect by MediaLab, haz clic en Install y reinicia Jellyfin.

El repositorio lista solo 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 lista cada plugin publicado 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 entonces pide la licencia, o inicia 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 ofrece solo las versiones que tu licencia permite.

Manualmente, desde un archivo zip.

1. En Account → Licenses descarga jf-quickconnect_x.y.z.zip (el SHA-256 del archivo se muestra junto al botón).
2. Extráelo en una carpeta nueva Quick Connect 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 Dashboard → Plugins → Quick Connect by MediaLab 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 de Jellyfin y muestra la licencia como Active.
3. ¿Aún no tienes clave? En la misma página escribe 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 ha hecho.

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 borra nada y todo se reanuda en cuanto la licencia es válida de nuevo. Move license (release this server) en la misma página libera la clave para otro servidor.

Actualizaciones y vuelta atrás

• Desde el repositorio: Jellyfin muestra las versiones nuevas 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 comprueban contra la suma de verificació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 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 trae de nuevo la versión más 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 nueva. Cuando el período de actualizaciones de una licencia de por vida ha terminado, las versiones publicadas después no están licenciadas: 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 ofrece solo las versiones que tu licencia permite, en lugar del catálogo público, o quita los desencadenantes de la tarea programada Update Plugins en Dashboard → Scheduled Tasks (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 Account → Licenses (Source code), junto a la descarga, como archivo .tar.gz creado a partir del commit exacto de esa versión.

Configuración

Abre Quick Connect en el menú del panel de Jellyfin.

1. Quick Connect in Jellyfin: el plugin funciona sobre el Quick Connect propio de Jellyfin. Si el panel indica que está desactivado, haz clic en Turn on Quick Connect (o actívalo en Dashboard → General); mientras esté desactivado, las apps de Jellyfin no pueden pedir códigos.
2. Settings:
   • The phone and screen pages are active.
   • Approval from the phone with username + password too, para teléfonos donde Jellyfin no tiene la sesión iniciada. Desactívalo para permitir solo aprobaciones desde un teléfono que ya tiene una sesión de Jellyfin.
   • Administrator accounts cannot approve through the phone page: desactivado por defecto.
3. How to use muestra las dos direcciones de tu servidor: la página para el teléfono (/Connect/Page) y la página de pantalla para navegadores de TV (/Connect/Screen). Comparte la dirección de la página para el teléfono con tus usuarios, o pon su código QR junto al televisor.

El plugin no añade un código de un solo uso para escribir en lugar de la contraseña, a propósito: los usuarios que dependieran de él se quedarían fuera si el plugin se eliminara. Las contraseñas siguen exactamente como las gestiona Jellyfin.

Uso diario

• En una app de Jellyfin en el televisor (Android TV, Fire TV, webOS, Tizen, Roku y las demás): elige Quick Connect en la pantalla de inicio de sesión. La app muestra un código de 6 dígitos.
• En un navegador de la TV: abre la página de pantalla. Muestra el código y un código QR que lleva a la página para el teléfono.
• En el teléfono: escanea el código QR o abre la página para el teléfono, escribe el código si no está ya rellenado, y después aprueba con un toque como el usuario de Jellyfin que ya tiene la sesión iniciada en el teléfono, o con un nombre de usuario y una contraseña. El televisor inicia sesión solo.
• ¿Aún no tienes cuenta? Con Registration by MediaLab instalado, la página para el teléfono muestra un enlace para crear una.
• El panel lista los recent approvals (cuándo, usuario y cómo se aprobó).

Solución de problemas

• «Quick Connect is not available on this server»: activa Quick Connect en Jellyfin (el panel tiene un botón para ello) y comprueba que la licencia del plugin esté activa.
• «The code is not valid or has expired»: comprueba los dígitos en la TV; los códigos de Jellyfin caducan al cabo de un tiempo. Pide a la app uno nuevo.
• «Too many attempts»: espera 10 minutos; el bloqueo se aplica a la dirección que hizo los intentos incorrectos.
• «The account is disabled» o administrator accounts refused: la cuenta está desactivada en Jellyfin, o los administradores no pueden aprobar en los ajustes del plugin.