Share Links pentru Jellyfin

Uneori vrei să arăți un film sau un serial cuiva care nu are cont pe serverul tău. Share Links de la MediaLab creează un link care expiră, pe care oaspetele îl deschide în browser, pe telefon sau pe TV, fără să primească vreodată o parolă de cont sau un token pentru serverul tău Jellyfin.

Ce face

• Linkuri cu limite: data expirării (implicit 48 de ore, cel mult 7 zile dacă nu permiți mai mult), numărul maxim de deschideri, numărul maxim de privitori simultani și un PIN opțional de 4–8 cifre.
• Se deschide oriunde: în orice browser, pe telefon sau pe TV, cu o adresă scurtă și un cod de 8 caractere (XXXX-XXXX), sau cu un cod QR. Se redă într-un player propriu, cu alegerea pistei audio și a subtitrărilor.
• Oaspetele nu vede niciun token: plugin-ul ține accesul oaspetelui pe server și trece totul printr-un proxy limitat la titlurile linkului. Revocarea linkului îi deconectează imediat pe privitori.
• Securitate: tokenurile, codurile și PIN-urile sunt păstrate doar ca hash; încercările greșite repetate sunt blocate pe adresă IP și pe link; bitrate-ul are un plafon (implicit 8 Mbps); nu se poate descărca nimic.
• Partajare și pentru utilizatorii obișnuiți (opțional, doar titluri pe care le văd ei înșiși), cu o cotă pe 30 de zile (una implicită sau una pe plan Cashier) și pagina Linkurile mele.
• Trimitere: copiezi linkul sau îl trimiți prin WhatsApp, Telegram sau e-mail; pagina plugin-ului păstrează un jurnal al linkurilor.

Cum e ținut oaspetele în limite

La prima deschidere a unui link, plugin-ul creează un utilizator Jellyfin ascuns și temporar pentru acel link: vede doar bibliotecile titlurilor partajate, nu poate descărca, nu are Live TV, control la distanță sau SyncPlay și poate avea doar atâtea sesiuni câți privitori permite linkul. Tokenul lui nu iese niciodată din server: browserul oaspetelui are doar un cookie de sesiune al plugin-ului, iar proxy-ul servește doar titlurile linkului (un sezon sau un serial include episoadele lui). Când linkul expiră sau e revocat, privitorii sunt deconectați și utilizatorul temporar e șters.

Ce trimite și unde

Nimic nu ajunge la servicii externe: browserul oaspetelui vorbește doar cu serverul tău, iar player-ul (hls.js) e servit chiar de plugin. La medialab.works ajunge doar verificarea licenței. Butoanele de trimitere doar deschid WhatsApp, Telegram sau aplicația ta de e-mail cu textul pregătit; plugin-ul nu trimite nimic singur.

• Ce vede oaspetele: titlul și expirarea linkului, numele celui care l-a partajat și, pentru titlurile partajate, numele, serialul, sezonul și episodul, anul, rezumatul, durata și imaginile.
• Ce rămâne pe serverul tău: tokenurile, codurile și PIN-urile doar ca hash; pentru sesiunile oaspeților și jurnalul linkului, adresa IP a oaspetelui, pe care proxy-ul o transmite și lui Jellyfin (apare în jurnalele și sesiunile serverului). Linkurile expirate și evenimentele lor se șterg după 30 de zile (setabil).

Detaliile complete pentru fiecare produs, inclusiv ce rămâne pe serverul tău: Licențe, confidențialitate și compatibilitate.

Compatibilitate cu clienții

• Oaspeții deschid linkul într-un browser modern: pe calculator, pe telefon sau în browserul unui televizor inteligent (cu adresa scurtă și codul de 8 caractere). Testat în Chrome pe calculator, pe telefon și pe un ecran de televizor 1080p; Safari pe iPhone, Firefox și browserele televizoarelor reale nu au fost încă testate.
• Tu creezi linkuri din pagina plugin-ului din tabloul de bord Jellyfin; utilizatorii tăi din pagina lor Linkurile mele (/ShareLinks/My pe adresa Jellyfin).
• Pe medialab Server (varianta noastră de Jellyfin), din versiunea 0.1.1 clientul web arată și butonul Partajează pe pagina titlului și Linkurile mele în meniu, pentru cine are voie să partajeze. Pe Jellyfin oficial aceste două scurtături nu apar; restul merge la fel.
• Aplicațiile native Jellyfin nu au buton de partajare.

Cerințe

• Jellyfin Server 12.2 sau mai nou.
• Pentru oaspeții din afara rețelei tale: o adresă a serverului la care pot ajunge.
• Opțional: Cashier, pentru cote de partajare pe plan.

Licență

Plugin-ul este cu sursă deschisă (GPL-3.0). Versiunile gata de instalat sunt publice, ca și codul sursă. Ce cumperi este abonamentul: licența de folosire a plugin-ului pe un server Jellyfin, actualizările incluse în planul tău și suportul: toate actualizările cât timp abonamentul e activ, prin depozitul tău privat de plugin-uri, și ajutor când ceva nu merge. Plugin-ul verifică cheia o dată pe zi; fără un abonament valabil se oprește până la reînnoire (nu se șterge nimic). Lunar, anual sau lifetime (lifetime include un an de actualizări), sau inclus în Pachetul Jellyfin. 30 de zile de probă gratuită.

Codul sursă. Pentru fiecare versiune, sursa completă corespunzătoare este publică, lângă versiunea gata de instalat, în istoricul versiunilor, și se găsește și în cont (Cont → Licențe, Cod sursă); fiecare arhivă conține textul complet al GPL-3.0 (LICENSE). Dacă ai nevoie de sursa unei versiuni pe care nu o mai poți descărca, ne scrii și ți-o trimitem. Vezi secțiunea 10 din EULA.

Cod propriu, scris de MediaLab Works. Cod de la terți: player-ul folosește hls.js 1.5.20, nemodificat (Apache License 2.0); generatorul de coduri QR se bazează pe biblioteca QR Code generator a Project Nayuki (licență MIT).