Conectare rapidă Jellyfin

Jellyfin are deja Quick Connect: aplicația de pe televizor arată un cod de 6 cifre, iar un utilizator conectat îl aprobă din altă parte. Partea grea e să găsești unde se aprobă, adânc în setările Jellyfin de pe telefon. Conectare rapidă de la MediaLab le dă utilizatorilor tăi pentru asta o pagină scurtă de telefon cu cod QR și un ecran cu cod pentru browserele televizoarelor.

Ce face

• Pagina telefonului cu cod QR (/Connect/Page pe adresa Jellyfin): aprobă codul Quick Connect afișat de orice aplicație Jellyfin — Android TV, Fire TV, webOS, Tizen, Roku, iOS sau Jellyfin Web. Utilizatorul aprobă cu un clic dacă e deja conectat în Jellyfin pe telefon, sau cu utilizator + parolă (a doua variantă se poate opri).
• Ecranul pentru browserele televizoarelor (/Connect/Screen): arată codul și un cod QR spre pagina telefonului; după aprobare, ecranul intră singur în Jellyfin Web.
• Cont nou de pe telefon: cu Înregistrare instalat, pagina telefonului trimite la pagina de înregistrare.
• Panou de administrare în tabloul de bord Jellyfin: dacă Quick Connect e pornit în Jellyfin (cu buton de pornire), setările și aprobările recente. În română și engleză.

Fără cod de unică folosință în locul parolei, intenționat. Spre deosebire de varianta pentru Emby, acest plugin nu le permite utilizatorilor să scrie un cod în locul parolei. Un cont Jellyfin care ar depinde de un astfel de cod ar rămâne blocat pe dinafară dacă plugin-ul ar fi scos vreodată. Fiecare conectare trece prin Quick Connect-ul Jellyfin, iar parolele rămân exact cum le gestionează Jellyfin.

Securitate

• Codurile sunt cele ale Quick Connect-ului Jellyfin: Jellyfin le creează și ele expiră singure. Plugin-ul doar le aprobă.
• 10 încercări greșite (coduri sau parole greșite) de la aceeași adresă în 10 minute o blochează 10 minute.
• Conturile dezactivate sunt refuzate. Opțional, conturile de administrator nu pot aproba prin pagina telefonului.
• Paginile telefonului și ecranului sunt servite cu o politică strictă de securitate a conținutului și nu trimit adresa de proveniență (referrer).
• Fiecare aprobare se înregistrează cu utilizatorul, adresa și modul în care a fost aprobată.

Cerințe

• Jellyfin Server 12.2 sau mai nou.
• Quick Connect pornit în Jellyfin (Tablou de bord → General). Pagina plugin-ului îi arată starea și îl poate porni.

Întrebări frecvente

Se pot conecta utilizatorii pe televizor fără să-și tasteze parola? Da. Aplicația Jellyfin de pe televizor arată un cod Quick Connect; utilizatorul scanează codul QR sau deschide pagina telefonului și îl aprobă. Vezi ghidul.

Există un cod de unică folosință în locul parolei, ca la varianta pentru Emby? Nu, intenționat: dacă plugin-ul ar fi scos, utilizatorii care s-ar baza pe acel cod ar rămâne blocați pe dinafară. Quick Connect-ul Jellyfin acoperă deja aplicațiile oficiale.

Ce trimite și unde

• Niciun serviciu extern în afara clientului de licență. Codurile QR sunt generate pe server; paginile ecranului și telefonului încarcă doar fișierele plugin-ului.
• După conectare, televizorul/browserul e trimis la adresa setată de admin (implicit interfața web a serverului). Tokenul de sesiune e scris în memoria browserului înainte de redirecționare, nu e pus în URL. Adresele locală/externă sunt doar HTTPS.
• Folosește Quick Connect-ul nativ Jellyfin; fără fișiere modificate.
• Plus clientul de licență, același în toate plugin-urile: vezi Licențierea și confidențialitatea în plugin-urile noastre.

Stocat local:

• Codurile în așteptare — doar în memorie.
• state/approvals.json: ultimele 500 de aprobări (ora, utilizatorul, dispozitivul, aplicația, IP-ul, metoda).

Nu se trimite niciodată: parole, tokenuri — nimic nu pleacă spre terți.

Compatibilitate cu clienții

• Ecran + telefon (QR, aprobare din telefon): browsere — Jellyfin Web pe TV, desktop, MediaLab TV. ✅ emulat (Chrome cu User-Agent Philips NETTV; 25/25); ❔ netestat pe televizoare fizice.
• Orice aplicație cu Quick Connect nativ (Android TV, Fire TV, webOS, Tizen, Roku, iOS/Swiftfin, Jellyfin Web): pagina de pe telefon aprobă codul afișat de aplicație. ✅ simulat prin API (client „Jellyfin Android TV”); ❔ netestat pe Android TV, Swiftfin, Findroid, Kodi/JellyCon, Infuse, Streamyfin reale. Necesită Quick Connect activat în Dashboard. Fără cod de unică folosință pe Jellyfin (decizie de siguranță).
• Conectare automată după cont nou + plată: cu Registration și Cashier; implicit oprită.

Legendă: ✅ verificat (test cap-coadă sau pe dispozitiv) · 🟢 funcționează prin server, independent de client (prin design, fără test pe fiecare client) · ➖ nu se aplică · ❔ netestat.

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: generatorul de coduri QR se bazează pe biblioteca QR Code generator a Project Nayuki (licență MIT).