Transcode Doctor 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.

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), deci nu o da mai departe; o poți regenera sau revoca oricând.
2. În Jellyfin deschide Tablou de bord → Plugin-uri → „Repositories”, apasă +, dă-i un nume (de exemplu MediaLab Works), lipește adresa și salvează.
3. În Tablou de bord → Plugin-uri → Catalog găsește Transcode Doctor by MediaLab, 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.

1. În Cont → Licențe descarcă jf-transcodedoctor_x.y.z.zip (SHA-256 al fișierului apare lângă buton).
2. Dezarhivează-l într-un dosar nou Transcode Doctor by MediaLab_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\
3. Repornește Jellyfin.

Activarea licenței

1. Deschide pagina plugin-ului din Tablou de bord → Plugin-uri → Transcode Doctor by MediaLab și apasă Licență.
2. 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ă.
3. 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ă Rollback la x.y.z, actualizarea automată Jellyfin a acelui plugin se oprește până la următoarea Instalează actualizarea din pagina Licență, deci sarcina programată Update Plugins (la pornire și zilnic) nu mai aduce înapoi versiunea nouă.
• Licența lifetime și actualizările automate. Catalogul public Jellyfin (https://medialab.works/jellyfin/manifest.json) oferă mereu cea mai nouă versiune. După ce s-a încheiat perioada de actualizări a unei licențe lifetime, versiunile apărute ulterior nu sunt licențiate: dacă actualizarea automată a plugin-urilor din Jellyfin instalează una, plugin-ul se oprește cu „version not licensed” până revii cu Rollback la x.y.z din pagina lui Licență sau cumperi un abonament de actualizări. Ca să eviți asta, nu lăsa Jellyfin să actualizeze automat acest plugin: adaugă depozitul tău privat de plugin-uri, care oferă doar versiunile permise de licență, în locul catalogului public, sau scoate declanșatoarele sarcinii programate Update Plugins din Tablou de bord → Sarcini programate (asta oprește actualizările automate pentru toate plugin-urile).

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.

Configurare

Deschide Transcode Doctor din meniul tabloului de bord Jellyfin.

1. Diagnosticul accelerării hardware: apasă Rulează testele. Plugin-ul verifică ffmpeg, placa NVIDIA și dispozitivele /dev/dri, creează cu ffmpeg câteva clipuri scurte de probă în dosarul cache al Jellyfin, apoi încearcă fiecare metodă (NVIDIA NVENC, Intel QuickSync, VA-API) la decodarea H.264, HEVC, HEVC 10-bit, MPEG-2, VP9 și AV1 și la codarea H.264 și HEVC. Fiecare test durează cel mult un minut; tabelul arată ce merge și cât de repede.
2. Probleme: dacă ceva blochează accelerarea, pagina spune ce și cum se rezolvă. Cea mai des întâlnită: Jellyfin fără acces la /dev/dri/renderD128; rulează comanda arătată (adaugă utilizatorul Jellyfin în grupul render), repornește Jellyfin și rulează din nou testele. În Docker, trece dispozitivul plăcii în container.
3. Recomandare: metoda care a trecut cele mai multe teste, codecurile de decodare, codarea hardware și aproximativ câte transcodări 1080p pot rula simultan, lângă setările tale actuale.
4. Aplică setările scrie recomandarea în Tablou de bord → Redare → Transcodare: metoda de accelerare, codecurile decodate în hardware, decodarea HEVC 10-bit, codarea hardware și dispozitivul VA-API / QuickSync. Decodarea VC-1, VP8 și MPEG-4, care nu poate fi testată, rămâne cum ai setat-o; codarea HEVC se oprește dacă a picat testul și nu e pornită niciodată de plugin.
5. Revino la setările de dinainte pune la loc setările de transcodare salvate chiar înainte de ultima aplicare. Le poți schimba oricând și de mână în Jellyfin.

Utilizare zilnică

• De ce se transcodează arată redările transcodate recente: când, cine, ce, motivele pe înțeles cu ce se poate face și dacă a lucrat placa video sau procesorul. „Procesor (placa nu a fost folosită)” la o redare cu accelerarea configurată înseamnă că placa nu a fost folosită.
• Când o transcodare video merge pe procesor deși accelerarea e configurată, plugin-ul scrie o intrare în jurnalul de activitate Jellyfin.
• Rulează din nou testele după o schimbare de driver, de versiune Jellyfin sau de placă.

Probleme frecvente

• Diagnosticul a eșuat: ffmpeg nu există: instalează jellyfin-ffmpeg și setează calea în Tablou de bord → Redare → Transcodare.
• Toate testele VA-API / QuickSync pică: verifică lista de probleme; de obicei utilizatorul Jellyfin lipsește din grupul render sau dispozitivul nu e trecut în containerul Docker.
• Toate testele NVENC pică: driverul NVIDIA lipsește sau nvidia-smi nu răspunde.
• Nicio metodă hardware nu a trecut testele: transcodarea rămâne pe procesor; nu se aplică nimic.