Share Links Jellyfin — ghid

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 depozitul tău de plugin-uri (recomandat). Jellyfin instalează și actualizează apoi singur plugin-ul.

În contul MediaLab Works deschide Licențe → Depozitul 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.
În Jellyfin deschide Tablou de bord → Plugin-uri → „Repositories”, apasă +, dă-i un nume (de exemplu MediaLab Works), lipește adresa și salvează.
În Tablou de bord → Plugin-uri → Catalog găsește Share Links by MediaLab, apasă Instalează, apoi repornește Jellyfin.

Depozitul 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ă.

Din catalogul public. https://medialab.works/jellyfin/manifest.json arată toate plugin-urile MediaLab Works lansate, cu versiunile lor publice; medialab Server îl adaugă singur. Îl poți adăuga la fel ca să instalezi un plugin înainte să ai o cheie: plugin-ul îți cere apoi licența sau pornește perioada de probă din pagina lui Licență. Cu o licență lifetime a cărei perioadă de actualizări s-a încheiat, folosește depozitul tău privat, care oferă doar versiunile permise de licență.

Manual, dintr-o arhivă zip.

În Cont → Licențe descarcă jf-sharelinks_x.y.z.zip (SHA-256 al fișierului apare lângă buton).
Dezarhivează-l într-un dosar nou Share Links 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\
Repornește Jellyfin.

Activarea licenței

Deschide pagina plugin-ului din Tablou de bord → Plugin-uri → Share Links by MediaLab și apasă Licență.
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ă.
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, nimic de plată 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); linkurile nu se mai deschid, dar 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 depozit: 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ă depozitul 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.

Înainte să partajezi

Deschide Share Links din meniul tabloului de bord Jellyfin și mergi la Setări:

Adresa publică a serverului: adresa folosită în linkuri (de exemplu https://media.example.com). Lasă câmpul gol ca să se folosească adresa prin care ai deschis acum Jellyfin. Oaspeții din afara rețelei tale au nevoie de o adresă la care pot ajunge.
Valabilitatea implicită (48 de ore) și valabilitatea maximă (168 de ore = 7 zile), privitorii simultani impliciți (1), calitatea maximă pentru oaspeți (8 Mbit/s; 0 = limita serverului) și câte zile rămân în listă linkurile expirate (30).
Linkurile funcționează: oprit, linkurile existente nu se mai deschid (nu se șterg).

Crearea unui link

În fila Partajează cauți și alegi ce partajezi: un film, un episod, un sezon sau un serial întreg.
Stabilești limitele:
- expirarea: când nu mai merge linkul;
- numărul maxim de deschideri;
- numărul maxim de privitori simultani;
- un PIN opțional de 4–8 cifre, pe care oaspetele trebuie să-l introducă.
Trimiți linkul: îl copiezi sau îl trimiți prin WhatsApp, Telegram sau e-mail; apare și un cod QR. Linkul complet se arată o singură dată (serverul păstrează doar o amprentă a lui); dacă îl pierzi, creezi altul.

Ce face oaspetele

În browser, oaspetele deschide linkul. Pe TV sau pe alt dispozitiv, deschide adresa scurtă (/ShareLinks/s pe serverul tău) și scrie codul de 8 caractere sau scanează codul QR cu telefonul.
Titlul se redă în player-ul propriu al plugin-ului, unde oaspetele poate alege pista audio și subtitrările; un sezon sau un serial își arată episoadele. Nu se poate descărca nimic, iar bitrate-ul are un plafon.
Oaspetele nu primește niciodată o parolă sau un token pentru serverul tău: un utilizator Jellyfin ascuns și temporar, făcut pentru link, își ține tokenul pe server, iar totul trece printr-un proxy limitat la titlurile linkului.

Administrarea linkurilor

Fila Linkuri arată linkurile cu starea lor; revocarea unui link îi deconectează imediat pe privitori și șterge utilizatorul temporar. Linkurile expirate sunt curățate la fel.
Fila Jurnal arată deschiderile, refuzurile și revocările.
10 coduri sau PIN-uri greșite de la aceeași adresă IP în 10 minute o blochează 15 minute; 10 PIN-uri greșite pentru același link, de la orice adresă, blochează PIN-ul acelui link 15 minute.

Partajarea de către utilizatorii obișnuiți

Opțional (Și utilizatorii pot crea linkuri), utilizatorii obișnuiți pot crea linkuri către titluri pe care le văd ei înșiși, pentru un singur privitor, în limita unei cote pe 30 de zile: una implicită (2 linkuri) sau una pe plan Cashier, și cu o valabilitate maximă proprie (implicit 48 de ore). Fiecare utilizator își creează, își vede și își revocă linkurile în pagina Linkurile mele (/ShareLinks/My pe adresa Jellyfin). Pe medialab Server, din versiunea 0.1.1, clientul web arată și butonul Partajează pe pagina titlului și Linkurile mele în meniu.

Ce trimite și unde

Browserul oaspetelui vorbește doar cu serverul tău; player-ul și hls.js sunt servite de plugin.
WhatsApp, Telegram și e-mailul doar se deschid cu textul pregătit; plugin-ul nu trimite nimic singur.
La medialab.works nu ajunge nimic în afară de verificarea licenței.

Probleme frecvente

Linkul nu se deschide din afara rețelei tale: completează Adresa publică a serverului în Setări cu o adresă la care ajung oaspeții, apoi creează din nou linkul.
„Prea multe încercări”: așteaptă 15 minute; blocarea se aplică adresei (sau PIN-ului linkului) de la care au venit încercările greșite.
Nu apare butonul Partajează în clientul web Jellyfin: butonul și intrarea din meniu apar doar pe medialab Server; pe Jellyfin oficial folosește pagina plugin-ului sau /ShareLinks/My.