Jellyfin pe televizor Samsung: aplicația TV care rulează în browserul televizorului

Problema: un server Jellyfin și un televizor fără aplicație Jellyfin

Ai un server Jellyfin acasă sau pentru un grup mic de utilizatori. Serverul merge bine. Problema este televizorul: un Samsung sau LG mai vechi, un model Philips ori un televizor de hotel care are browser, dar nu are aplicația Jellyfin în magazinul lui. Transmiterea de pe telefon nu este mereu o opțiune, iar să pui o a doua cutie în spatele fiecărui televizor nu este nici asta ce îți dorești.

MediaLab TV merge pe altă cale. Este un plugin Jellyfin care servește o aplicație web, deschisă o singură dată în browserul propriu al televizorului. De atunci, televizorul intră singur și afișează o interfață în stil Netflix, gândită pentru telecomandă, cu player propriu, butoane „Sari peste” și cu numele, sigla, culorile și adresa ta în locul celor ale noastre. Dacă ai căutat o alternativă la aplicația Jellyfin TV pentru televizoare care nu o vor primi niciodată, acesta este unghiul: browserul este clientul.

O precizare sinceră înainte de a începe: MediaLab TV nu este o aplicație din magazinul de aplicații al televizorului. A fost testată într-un browser emulat de televizor Philips; televizoarele Samsung (Tizen), LG (webOS), Android TV / Google TV și Philips reale sunt tratate în cod (mod TV, taste de telecomandă, pointer Magic Remote), dar nu au fost încă verificate pe dispozitive. Ce poate reda un televizor depinde de browserul lui, iar serverul transcodifică ceea ce browserul nu poate reda.

Cerințe preliminare

Jellyfin Server 12.2 sau mai nou, oficial sau medialab Server, pe Linux, Windows sau Docker.
Un televizor cu browser web. Acesta este singurul lucru necesar pe partea de client.
Quick Connect activat în Jellyfin (Dashboard → General), dacă vrei conectarea de pe telefon și conturi noi de pe telefon. Fără el, televizorul arată doar formularul obișnuit cu nume de utilizator și parolă.
Un cont MediaLab Works cu o licență care acoperă pluginul: un abonament activ, o licență pe viață în perioada ei de actualizări, pachetul Jellyfin sau perioada de probă gratuită de 30 de zile.
Extraopționale: Quick Connect by MediaLab (cod QR spre pagina de aprobare), Registration by MediaLab (înregistrare de pe telefon) și Cashier by MediaLab (plată înainte ca contul să devină activ).

Pasul 1 — Instalează pluginul din depozitul tău privat

Calea recomandată lasă Jellyfin să instaleze și să actualizeze singur pluginul.

În contul tău MediaLab Works deschide Licenses → Jellyfin plugin repository și apasă Create address. Copiaz-o. Adresa este privată pentru că conține un token, așa că nu o împărtăși; o poți regenera sau revoca oricând.
În Jellyfin deschide Dashboard → Plugins → Repositories, apasă +, dă-i un nume (de exemplu MediaLab Works), lipește adresa și salvează.
În Dashboard → Plugins → Catalog caută MediaLab TV, apasă Install, apoi repornește Jellyfin.

Depozitul listează doar pluginurile acoperite de licențele tale și doar versiunile pe care acestea le permit. Linkurile lui de descărcare sunt semnate și expiră după câteva ore, așa că Jellyfin citește mereu o listă proaspătă.

Dacă preferi, catalogul public de la https://medialab.works/jellyfin/manifest.json listează fiecare plugin MediaLab Works publicat, cu buildul lui public (medialab Server îl adaugă singur). Poți instala și manual: descarcă jf-tvapp_x.y.z.zip din Account → Licenses, dezarhivează-l într-un folder nou MediaLab TV_x.y.z.0 în folderul de pluginuri (/var/lib/jellyfin/plugins/ la o instalare Linux din pachet, /config/plugins/ în volumul de configurare la imaginea Docker oficială, %ProgramData%\Jellyfin\Server\plugins\ pe Windows) și repornește Jellyfin.

Pasul 2 — Activează licența

Deschide Dashboard → Plugins → MediaLab TV și apasă License.
Lipește cheia de licență și apasă Activate with key. Pluginul contactează serverul de licențe, leagă cheia de acest server și arată licența ca Active.
Nu ai încă o cheie? Pe aceeași pagină introdu e-mailul și începe perioada de probă gratuită de 30 de zile, sau cumpără o licență; pluginul se activează singur când plata este făcută.

Licența este verificată o dată pe zi și la fiecare pornire a Jellyfin. Fără internet, pluginul funcționează în continuare 7 zile după ultima verificare reușită. Fără o licență validă, televizoarele văd doar un ecran neutru „Serviciul nu este disponibil”, în engleză și română, fără numele sau sigla ta — nimic nu este șters, iar totul revine la normal când licența este din nou validă. Move license (release this server) pe aceeași pagină eliberează cheia pentru alt server.

Pasul 3 — Configurează-ți brandingul

Deschide MediaLab TV în meniul dashboardului Jellyfin. Totul aici este opțional, dar este partea pe care utilizatorii tăi o văd de fapt.

App name: titlul de pe televizor (implicit „MediaLab TV”).
Short name: apare în lista de dispozitive a serverului și ca nume al aplicației salvate pe televizor.
Line under the name și footer line: de exemplu site-ul tău și cum se ajunge la suport. Un subsol gol afișează „Unofficial app, compatible with Jellyfin servers” în limba televizorului.
Colors: culoarea de accent (butoane, focus) și fundalul, ca #rrggbb. Culoarea textului este aleasă automat ca să rămână lizibilă.
Language: automată (limba browserului televizorului), engleză sau română.
Logo: PNG sau SVG, cel mult 512 KB; o imagine pătrată arată cel mai bine. Fișierele SVG cu scripturi sunt refuzate.

Previzualizarea arată rezultatul înainte de a apăsa Save. Setările de branding și sigla rămân pe serverul tău.

Pasul 4 — Alege adresa pentru televizoare

Două adrese funcționează:

/MediaLabTv/ la adresa serverului tău: funcționează mereu.
Calea ta, de exemplu /web/tv/ (calea implicită este tv), servită chiar de plugin. Bara de adrese păstrează /web/tv/, nu se scrie nimic în fișierele Jellyfin și nimic nu trebuie refăcut după actualizările Jellyfin. Un base URL setat în Jellyfin este respectat. O cale care există deja în interfața web a Jellyfin nu este niciodată acoperită, așa că alege alta dacă apare un conflict.

Pe medialab Server, aplicația primește și o intrare în meniul utilizatorilor.

Pasul 5 — Deschide-o o dată pe fiecare televizor

Pe televizor, deschide browserul, scrie o dată adresa scurtă și salvează-o ca pagină de start sau ca favorit. Acesta este tot setupul pe partea de dispozitiv.

Un mod TV este ales singur pe Tizen, webOS, Android TV, Google TV și televizoare Philips, sau comutat din meniul de profil. Este dimensionat pentru ecrane de 720p, 1080p și 4K, cu margini de siguranță și un focus mare. Tastele săgeți, OK, Back (cu o întrebare înainte de ieșire), media, color, canal și cifre funcționează, la fel și pointerul LG Magic Remote. Ecranul complet este disponibil dintr-un buton din antet acolo unde browserul permite și cu tasta F; pe un televizor, sau când este deschis din Quick Connect, primul OK / click trece în ecran complet (din 1.2.1).

Pasul 6 — Decide cum se conectează oamenii

Televizorul păstrează tokenul serverului, nu parola. Tokenul este verificat la fiecare pornire; dacă a fost revocat, televizorul arată formularul de conectare. „Remember the password on TVs” este dezactivat implicit — activează-l doar pentru televizoarele care pierd mereu tokenul.

Pentru majoritatea gospodăriilor, conectarea de pe telefon este varianta mai prietenoasă:

Sign in with your phone: televizorul arată un cod de 6 cifre. Un utilizator conectat îl aprobă pe telefon, în aplicația Jellyfin (Settings → Quick Connect). Cu Quick Connect by MediaLab instalat, televizorul arată și un cod QR care deschide pagina de aprobare.
New account (from the phone): cu Registration by MediaLab, televizorul arată un cod QR spre pagina de înregistrare și un cod de scris în formular. Când contul devine activ — după aprobarea administratorului sau, cu Cashier by MediaLab, după plată — televizorul intră singur.

Reține că ambele depind de Quick Connect din Jellyfin, care trebuie să fie activat în Dashboard → General.

Pasul 7 — Ce primesc utilizatorii tăi

Interfața este proprie: un banner care se rotește și rânduri pentru Continuă vizionarea, Episodul următor, filme și seriale adăugate recent, fiecare bibliotecă, Lista mea, colecții, genuri și TV în direct (acum pe post, filme diseară, sport, copii, urmează). Paginile titlurilor includ imagine de fundal, evaluări, distribuție, sezoane și episoade, titluri similare și trailerul local. Există grile, căutare cu tastatură pe ecran și profiluri („Who's watching?”).

Și playerul este propriu: piste audio, subtitrări, reluare, episodul următor și butoanele Sari peste intro / rezumat / generic (Media Segments din Jellyfin). Redarea este raportată către Jellyfin, așa că apare în Continuă vizionarea peste tot. Dacă cineva preferă clientul standard, setarea „After sign-in, open” îl trimite la Jellyfin Web; interfața MediaLab TV este implicită.

Sfaturi și depanare

„Serviciul nu este disponibil” pe televizor: licența nu este validă sau serverul nu a ajuns la medialab.works de mai mult de 7 zile. Verifică pagina License a pluginului.
Lipsește „Sign in with your phone”: Quick Connect nu este activat în Jellyfin. Activează-l în Dashboard → General.
S-a stricat ceva după o actualizare: pe pagina License a pluginului folosește Roll back to x.y.z (cu o licență validă), apoi repornește Jellyfin. Dacă depozitul tău privat este adăugat, sarcina programată Update Plugins din Jellyfin (la pornire și zilnic) va instala din nou cea mai nouă versiune — elimină-i declanșatoarele din Dashboard → Scheduled Tasks dacă vrei să rămâi o vreme pe versiunea anterioară, și adaugă-le la loc mai târziu.
Confidențialitate: televizorul vorbește doar cu serverul tău Jellyfin; pagina blochează orice din altă parte (fără fonturi web, fără CDN, fără trailere externe). Către medialab.works se trimite doar verificarea licenței.
Așteptări privind compatibilitatea: tratează browserul ca pe clientul. Dacă un fișier nu rulează fluent, lasă serverul să îl transcodifice, în loc să dai vina pe televizor.

Concluzie

Pentru un televizor care nu va primi niciodată o aplicație Jellyfin, un client în browser cu o interfață proprie potrivită pentru telecomandă este răspunsul pragmatic. MediaLab TV îți oferă asta, plus conectarea de pe telefon prin Quick Connect, butoane „Sari peste” bazate pe Media Segments și un branding care face serverul să pară al tău. Instalează-l din depozitul tău privat, setează numele, sigla și culorile, deschide /web/tv/ o dată pe fiecare televizor — și televizorul este gata. Ghidul utilizatorului acoperă fiecare setare în detaliu, changelogul listează fiecare versiune cu codul ei sursă, iar baza de cunoștințe și FAQ sunt acolo când ceva nu se comportă cum trebuie; ne poți și contacta direct.

Postarea a fost scrisă cu ajutorul AI pe baza documentației produselor noastre sau a surselor indicate și verificată automat înainte de publicare.