Actori favoriți Jellyfin — instalare

Instalare

Ai nevoie de Jellyfin Server 12.2 sau mai nou și de un cont MediaLab Works cu o licență care acoperă plugin-ul (abonament activ, licență lifetime în perioada de actualizări, Pachetul Jellyfin sau proba gratuită de 30 de zile).

Din repository-ul tău de plugin-uri (recomandat). Jellyfin instalează și actualizează apoi singur plugin-ul.

1. În contul MediaLab Works deschide Licențe → Repository de plugin-uri Jellyfin și apasă Creează adresa. Copiaz-o: e privată (conține un token), deci nu o da mai departe; o poți regenera sau revoca oricând.
2. În Jellyfin deschide Tablou de bord → Plugin-uri → Repository-uri, apasă +, dă-i un nume (de exemplu MediaLab Works), lipește adresa și salvează.
3. În Tablou de bord → Plugin-uri → Catalog găsește Favorite Actors by medialab, apasă Instalează, apoi repornește Jellyfin.

Repository-ul arată doar plugin-urile acoperite de licențele tale și doar versiunile permise. Linkurile de descărcare sunt semnate și expiră după câteva ore, așa că Jellyfin citește mereu o listă proaspătă.

Manual, dintr-o arhivă zip.

1. În Cont → Licențe descarcă jf-favoriteactors_x.y.z.zip (SHA-256 al fișierului apare lângă buton).
2. Dezarhivează-l într-un dosar nou Favorite Actors by medialab_x.y.z.0 din dosarul de plugin-uri Jellyfin:
   • Linux (pachet): /var/lib/jellyfin/plugins/
   • Docker (imaginea oficială): /config/plugins/ din volumul de configurare
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Repornește Jellyfin.

Activarea licenței

1. Deschide pagina plugin-ului din Tablou de bord → Plugin-uri → Favorite Actors by medialab și apasă Deschide pagina Licență.
2. Lipește cheia de licență și apasă Activează cu cheia. Plugin-ul contactează serverul de licențe, leagă cheia de acest server Jellyfin și arată licența Activă.
3. Nu ai încă o cheie? Pe aceeași pagină scrii adresa de e-mail și pornești proba gratuită de 30 de zile (card necesar, 0 € azi) sau cumperi o licență; plugin-ul se activează singur după plată.

Licența se verifică o dată pe zi și la fiecare pornire a Jellyfin. Fără internet plugin-ul merge încă 7 zile de la ultima verificare reușită. Fără o licență valabilă plugin-ul își oprește activitatea și rămâne funcțională doar pagina Licență (probă, cheie, reînnoire); nu se șterge nimic și totul revine imediat ce licența e din nou valabilă. Mută licența (eliberează serverul) de pe aceeași pagină eliberează cheia pentru alt server.

Actualizare și revenire

• Din repository: Jellyfin arată versiunile noi în Tablou de bord → Plugin-uri și poate actualiza plugin-ul automat; repornește Jellyfin ca să încarce versiunea nouă.
• Din pagina Licență a plugin-ului: cu o licență valabilă, Instalează actualizarea aduce cea mai nouă versiune permisă de licență, iar Rollback la x.y.z întoarce versiunea anterioară (de exemplu dacă ceva nu mai merge după o actualizare). Repornește Jellyfin după oricare dintre ele. Ambele pachete se verifică după suma de control publicată de serverul de licențe.
• O licență lifetime primește versiunile apărute în perioada ei de actualizări; după aceea plugin-ul merge mai departe pe ultima versiune permisă.
• După o revenire, dacă repository-ul de plugin-uri e adăugat în Jellyfin, sarcina programată Update Plugins (la pornire și zilnic) instalează din nou cea mai nouă versiune. Ca să rămâi o vreme pe versiunea anterioară, scoate declanșatoarele acestei sarcini din Tablou de bord → Sarcini programate și pune-le la loc mai târziu.

Codul sursă

Sursa GPL-3.0 a fiecărei versiuni e în Cont → Licențe (Cod sursă), lângă descărcare, ca arhivă .tar.gz făcută din commit-ul exact al versiunii.

Configurare

Deschide Tablou de bord → Actori favoriți.

1. Radarr / Sonarr: adresa și cheia API pentru fiecare, profilul de calitate, dosarul rădăcină și, pentru Sonarr, sezoanele monitorizate (implicit primul sezon).
2. Utilizatori: utilizatorii Jellyfin ai căror actori favoriți se urmăresc.
3. TMDb: cheia ta API (cheie v3 sau token de citire v4) pentru listele Sonarr și numărul minim de episoade pentru un rol principal.
4. Adresa Jellyfin văzută de Sonarr: adresa la care Sonarr poate citi listele servite de plugin.
5. Pornește sincronizarea și apasă o dată Sincronizează acum.

În Radarr și Sonarr setează List Sync Level la disabled, ca ștergerea unei liste să nu scoată niciodată titluri din bibliotecă; altfel plugin-ul te avertizează.

Folosire zilnică

• Marchează un actor ca favorit (inima de pe pagina actorului): în câteva secunde Radarr și Sonarr primesc listele lui.
• Caută și adaugă: găsești un film sau un serial și îl adaugi direct, cu setările de mai sus.

Depanare

• Sonarr nu poate citi lista: verifică dacă adresa Jellyfin setată în plugin e accesibilă de pe calculatorul cu Sonarr.
• Nu se întâmplă nimic la un favorit: verifică dacă utilizatorul e printre cei aleși și dacă sincronizarea e pornită.