MediaLab SpeedTest pentru Jellyfin — ghid

Instalează plugin-ul, activează licența, apoi măsoară viteza fiecărui televizor, telefon sau browser și citește verdictul.

Instalare

Ai nevoie de Jellyfin Server 12.2 sau mai nou, ori medialab Server, și de un cont MediaLab Works cu o licență care acoperă plugin-ul (abonament activ, licență lifetime în fereastra de actualizări, pachetul Jellyfin sau proba gratuită de 30 de zile).

Din depozitul tău de plugin-uri (recomandat). Jellyfin instalează și actualizează plugin-ul singur.

1. În contul MediaLab Works deschide Licențe → Depozitul de plugin-uri Jellyfin și apasă Creează adresa. Copiaz-o: e privată (conține un token), așa că nu o împărtăși; o poți regenera sau revoca oricând.
2. În Jellyfin deschide Panou → Plugin-uri → Depozite, apasă +, dă-i un nume (de exemplu MediaLab Works), lipește adresa și salvează.
3. În Panou → Plugin-uri → Catalog caută MediaLab SpeedTest by MediaLab, apasă Instalează, apoi repornește Jellyfin.

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

Manual, dintr-un fișier zip.

1. În Cont → Licențe descarcă jf-speedtest_x.y.z.zip (SHA-256 al fișierului apare lângă buton).
2. Dezarhivează-l într-un folder nou MediaLab SpeedTest by MediaLab_x.y.z.0 în folderul de plugin-uri Jellyfin:
   • Linux (din pachet): /var/lib/jellyfin/plugins/
   • Docker (imaginea oficială): /config/plugins/ în volumul de configurare
   • Windows: %ProgramData%\Jellyfin\Server\plugins\
3. Repornește Jellyfin.

Licență

Deschide MediaLab SpeedTest în meniul panoului Jellyfin și apasă Licență. Lipește cheia de licență și activeaz-o, sau dă adresa de e-mail pentru proba gratuită de 30 de zile ori pentru cumpărare. Plugin-ul vorbește cu serverul de licențe, leagă cheia de acest server Jellyfin și arată licența ca Activă.

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ă; după aceea se oprește până când poate verifica din nou.

Fără licență validă, pagina arată doar panoul de licență: punctele de măsurare și butoanele de test se opresc, iar MediaLab TV trece pe măsurarea lui internă. Nimic nu se șterge, iar setările rămân.

Configurare

Pagina are testul, viteza pe dispozitiv și măsurările recente; setările sunt jos:

• Pornit / oprit: oprirea plugin-ului închide punctele de măsurare (MediaLab TV folosește atunci măsurarea internă).
• Măsurări pe minut, pe utilizator: limita anti-abuz. Un dispozitiv are rar nevoie de mai multe măsurări; ține-o mică.
• Mărime maximă pe măsurare: între 1 și 64 MiB. O mărime mai mare dă un rezultat mai stabil pe linii rapide; pe o conexiune lentă sau mobilă e destul una mică.
• Istoric: câte măsurări recente se păstrează în memorie.

Salvează după fiecare schimbare. Măsurările stau doar în memorie, așa că lista pornește goală după fiecare repornire Jellyfin, indiferent de setarea de istoric.

Cum măsori

1. Deschide pagina plugin-ului pe dispozitivul pe care vrei să-l testezi — browserul televizorului, telefonul sau calculatorul — conectat cu contul pe care îl folosește acel dispozitiv. Pagina măsoară drumul acelui dispozitiv; deschisă pe server, măsoară serverul însuși.
2. Apasă Start (întâi descărcare, apoi încărcare, apoi latență). Lasă pagina deschisă până se termină; butoanele sunt blocate cât rulează o măsurare.
3. Citește rezultatul:
   • descărcare — contează pentru redarea filmului; circa 25 Mbps ajung pentru 4K cu debit mare, 10–15 Mbps pentru 1080p;
   • încărcare — contează când dispozitivul trimite date (rar la redare);
   • latență — contează pentru pornirea lină și pentru derulare; peste 100 ms înseamnă de obicei un VPN, un drum lung sau un Wi-Fi aglomerat.
4. Verdictul apare lângă rezultat: lentă (sub 3 Mbps), medie (3–12), bună (12–40), excelentă (peste 40). Cardul viteza pe dispozitiv păstrează ultimul rezultat și mediana ultimelor cinci pentru acel dispozitiv.

Rulează testul din nou când imaginea se oprește, ca să vezi dacă problema e pe drumul acelui dispozitiv în acel moment.

Cu MediaLab TV

MediaLab TV verifică dacă MediaLab SpeedTest e instalat și licențiat:

• dacă da, aplicația de televizor măsoară rețeaua la pornire și în timpul redării, alege calitatea AUTO după viteza reală și arată rezultatul pe ecranul Verifică rețeaua;
• dacă nu (lipsește, licența nu e activă sau serverul n-a putut verifica licența în ultimele 7 zile), aplicația trece pe măsurarea ei internă, fără erori și fără să întrebe privitorul nimic.

Puncte de acces (pentru administratori)

Toate punctele cer un utilizator Jellyfin conectat; nu există niciun punct public.

• HEAD sau GET …/MediaLabSpeedTest/ping — verifică dacă plugin-ul răspunde.
• GET …/MediaLabSpeedTest/download?mb=N — trimite N MiB pentru măsurarea descărcării (N e limitat de mărimea maximă din setări).
• POST …/MediaLabSpeedTest/upload — primește datele pentru măsurarea încărcării.

În Jellyfin punctele sunt direct sub adresa serverului, deci o adresă completă arată așa: https://serverul-tau/MediaLabSpeedTest/ping.

Dacă nu merge

• Pagina spune că licența nu e activă: introdu cheia din nou la Licență sau verifică în cont că licența acoperă acest server și nu a expirat. Plugin-ul trebuie să ajungă la medialab.works cel puțin o dată la 7 zile.
• Testul eșuează imediat: verifică faptul că ești conectat (punctele refuză cererile anonime) și că plugin-ul e pornit în setări.
• Cifrele sunt mult mai mici decât linia serverului: testează de pe alt dispozitiv din același Wi-Fi, apoi de pe un dispozitiv pe cablu. Dacă doar un dispozitiv e lent, problema e la Wi-Fi-ul ori la drumul lui, nu la server.
• Aplicația TV îl ignoră: verifică licența pentru speedtest (sau pachetul) și că serverul a putut verifica licența în ultimele 7 zile.