Favorite Actors para Jellyfin — guía de configuració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 Favorite Actors 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-favoriteactors_x.y.z.zip (el SHA-256 del archivo se muestra junto al botón).
2. Extráelo en una carpeta nueva Favorite Actors 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 → Favorite Actors 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

Abre Panel de control → Favorite Actors.

1. Radarr / Sonarr: dirección y clave de API de cada uno, perfil de calidad, carpeta raíz y, para Sonarr, las temporadas supervisadas (por defecto, la primera).
2. Users: los usuarios de Jellyfin cuyos actores favoritos se siguen.
3. TMDb: tu clave de API (clave v3 o token de lectura v4) para las listas de Sonarr, y el número mínimo de episodios para un papel principal.
4. Jellyfin address seen by Sonarr: la dirección desde la que Sonarr puede leer las listas que sirve el plugin.
5. Activa la sincronización y pulsa Sync now una vez.

En Radarr y Sonarr pon List Sync Level en disabled, para que quitar una lista nunca elimine títulos de tu biblioteca; si no, el plugin te lo advierte.

Uso diario

• Marca un actor como favorito (el corazón de la página del actor): en cuestión de segundos Radarr y Sonarr reciben las listas del actor.
• Search and add: busca una película o una serie y añádela directamente, con los ajustes de arriba.

Solución de problemas

• Sonarr no puede leer la lista: comprueba que la dirección de Jellyfin definida en el plugin sea accesible desde el host de Sonarr.
• No pasa nada al marcar un favorito: comprueba que el usuario esté entre los usuarios elegidos y que la sincronización esté activada.