MediaLab TV pentru 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 MediaLab TV, 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-tvapp_x.y.z.zip (SHA-256 al fișierului apare lângă buton).
Dezarhivează-l într-un dosar nou MediaLab TV_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 → MediaLab TV ș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); 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.

Branding

Deschide MediaLab TV în meniul tabloului de bord Jellyfin.

Numele aplicației: titlul de pe televizor (implicit „MediaLab TV”).
Numele scurt: apare în lista de dispozitive a serverului și ca nume al aplicației salvate pe televizor.
Rândul de sub nume și rândul din subsol: opționale (de exemplu adresa site-ului și cum se ajunge la suport). Un subsol gol arată „Aplicație neoficială, compatibilă cu serverele Jellyfin”, în limba televizorului.
Culori: accentul (butoane, focus) și fundalul, de forma #rrggbb. Culoarea textului se alege singură, ca să rămână lizibil.
Limba: automată (limba browserului televizorului), română sau engleză.
Sigla: PNG sau SVG, cel mult 512 KB; o imagine pătrată arată cel mai bine. Fișierele SVG cu scripturi sunt refuzate.
Butoane: „Conectare cu telefonul” și „Cont nou (de pe telefon)”.

Previzualizarea arată rezultatul înainte să apeși Salvează.

După conectare

„După conectare se deschide”: interfața MediaLab TV (implicit: banner, rânduri, pagina titlului, player propriu și butoanele de sărit) sau Jellyfin Web.
„Ține minte parola pe televizoare” (oprită implicit): televizorul păstrează doar tokenul de conectare al serverului, nu și parola; pornește setarea doar pentru televizoarele care pierd mereu tokenul. O parolă salvată de versiunea 1.1 se folosește o singură dată, dacă e nevoie, apoi se șterge.
Pe televizor, meniul profilului comută modul TV (ales singur pe Tizen, webOS, Android TV, Google TV și televizoarele Philips) și deconectează.

Adresa pentru televizoare

/MediaLabTv/ pe adresa serverului tău: merge oricând.
Calea ta, de exemplu /web/tv/ (calea implicită este tv), servită direct de plugin: bara de adrese păstrează /web/tv/, nu se scrie nimic în fișierele Jellyfin și nu e nimic de refăcut după actualizările Jellyfin. Adresa de bază setată în Jellyfin este respectată. O cale care există deja în interfața web Jellyfin nu este acoperită niciodată: alege alta.

Pe fiecare televizor deschizi adresa o dată în browser și o salvezi ca pagină de start sau la favorite.

Conectarea cu telefonul și conturile noi

Amândouă folosesc Quick Connect din Jellyfin: pornește-l din Tablou de bord → General.

Conectarea cu telefonul: televizorul arată un cod de 6 cifre. Un utilizator conectat îl aprobă de pe telefon, în aplicația Jellyfin (Setări → Quick Connect). Cu Quick Connect by MediaLab instalat, televizorul arată și un cod QR care deschide pagina de aprobare.
Contul nou (de pe telefon): 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 adminului sau, cu Cashier by MediaLab, după plată), televizorul intră singur.

Probleme frecvente

Televizorul arată „Serviciul nu este disponibil”: licența nu este validă sau serverul nu a ajuns la medialab.works de mai mult de 7 zile. Verifică pagina Licență a plugin-ului.
Lipsește „Conectare cu telefonul”: Quick Connect este oprit în Jellyfin (Tablou de bord → General).
Adresa scurtă arată o pagină Jellyfin: calea există deja în interfața web; alege altă cale.
Un video nu pornește în browserul televizorului: verifică setările de redare ale acelui utilizator în Jellyfin (debitul maxim, transcodarea permisă); serverul transcodează ce nu poate reda browserul.