Share Links 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 Share Links by MediaLab, 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-sharelinks_x.y.z.zip (el SHA-256 del archivo se muestra junto al botón).
2. Extráelo en una carpeta nueva Share Links 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 → Share Links 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 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); los enlaces dejan de abrirse, pero 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.

Antes de compartir

Abre Share Links en el menú del panel de control de Jellyfin y ve a Settings:

• Public server address: la dirección usada en los enlaces (por ejemplo, https://media.example.com). Déjala vacía para usar la dirección a través de la cual estás usando Jellyfin ahora mismo. Los invitados fuera de tu red doméstica necesitan una dirección a la que puedan acceder.
• Default validity (48 horas) y maximum validity (168 horas = 7 días), default simultaneous viewers (1), guest maximum quality (8 Mbit/s; 0 = el límite propio del servidor) y cuántos días permanecen los enlaces caducados en la lista (30).
• Links work: desactivada, los enlaces existentes ya no se abren (no se eliminan).

Crear un enlace

1. En la pestaña Share, busca y elige qué compartir: una película, un episodio, una temporada o una serie completa.
2. Establece los límites:
   • expiry: cuándo deja de funcionar el enlace;
   • maximum opens: cuántas veces puede abrirse;
   • maximum simultaneous viewers;
   • un PIN opcional de 4 a 8 dígitos, que el invitado debe introducir.
3. Envía el enlace: copíalo, o envíalo por WhatsApp, Telegram o correo; también se muestra un código QR. El enlace completo solo se muestra una vez (el servidor guarda solo una huella digital de él); si lo pierdes, crea uno nuevo.

Qué hace el invitado

• En un navegador, el invitado abre el enlace. En una TV u otro dispositivo, abre la dirección corta (/ShareLinks/s en tu servidor) e introduce el código de 8 caracteres, o escanea el código QR con un teléfono.
• El título se reproduce en el reproductor propio del plugin, donde el invitado puede elegir la pista de audio y los subtítulos; una temporada o serie muestra sus episodios. No se puede descargar nada y la tasa de bits tiene un límite.
• El invitado nunca recibe una contraseña ni un token para tu servidor: un usuario de Jellyfin oculto y temporal, creado para el enlace, mantiene su token en el servidor, y todo pasa por un proxy limitado a los títulos del enlace.

Gestión de enlaces

• La pestaña Links enumera los enlaces con su estado; revocar un enlace cierra la sesión de sus espectadores de inmediato y elimina al usuario temporal. Los enlaces caducados se limpian de la misma manera.
• La pestaña Log muestra las aperturas, los rechazos y las revocaciones.
• 10 códigos o PIN incorrectos desde una dirección IP en 10 minutos la bloquean durante 15 minutos; 10 PIN incorrectos para un enlace, desde cualquier dirección, bloquean el PIN de ese enlace durante 15 minutos.

Compartir por los usuarios habituales

Opcionalmente (Users can create links too), los usuarios habituales pueden crear enlaces a títulos que ellos mismos pueden ver, para un espectador, dentro de una cuota por 30 días: una cuota predeterminada (2 enlaces), o una por plan de Cashier, y una validez máxima propia (48 horas por defecto). Cada usuario crea, ve y revoca sus enlaces en la página My links (/ShareLinks/My en tu dirección de Jellyfin). En medialab Server, desde la versión 0.1.1, el cliente web también muestra un botón Share en la página del título y My links en el menú.

Qué envía y a dónde

• El navegador del invitado solo habla con tu servidor; el reproductor y hls.js los sirve el plugin.
• WhatsApp, Telegram y el correo solo se abren con el texto preparado; el plugin no envía nada por sí mismo.
• Nada va a medialab.works salvo la comprobación de la licencia.

Resolución de problemas

• El enlace no se abre desde fuera de tu red: establece en Settings la Public server address a una dirección a la que los invitados puedan acceder y luego crea el enlace de nuevo.
• «Too many attempts»: espera 15 minutos; el bloqueo se aplica a la dirección (o al PIN del enlace) que tuvo los intentos incorrectos.
• No aparece el botón Share en el cliente web de Jellyfin: el botón y la entrada del menú solo aparecen en medialab Server; en Jellyfin oficial usa la página del plugin o /ShareLinks/My.