Live TV în Jellyfin de pe receptorul Enigma2 (Vu+): canale, ghid EPG și picon-uri, pas cu pas

De ce să folosești propriul receptor ca tuner

Dacă ai deja un receptor Enigma2 (Vu+, Zgemma, GigaBlue și similare) pentru canale free-to-air sau abonamente pe care ești licențiat să le urmărești, ai deja cea mai grea parte a unei configurații Live TV: tunerul și lista de canale. Headend conectează receptorul la Jellyfin prin OpenWebif, astfel încât canalele, ghidul de programe și logo-urile canalelor vin toate din aceeași cutie. Plugin-ul nu vinde și nu furnizează nimic: Headend nu oferă canale, ci doar le expune pe cele pe care receptorul tău le primește deja.

Fluxul trece prin serverul Jellyfin, așa că aplicațiile nu află niciodată adresa receptorului. Mai mulți vizualizatori ai aceluiași canal partajează un singur tuner, iar un tuner ocupat returnează o eroare clară în loc de o eșuare silențioasă. Dacă vrei lista completă de funcții, vezi pagina produsului; acest tutorial este traseul practic de la zero la un ghid funcțional.

Cerințe preliminare

• Jellyfin Server 12.2 sau mai nou, pe Linux, Windows sau Docker.
• Un receptor Enigma2 cu OpenWebif activat și accesibil din serverul Jellyfin, de obicei în aceeași rețea. OpenWebif ascultă de obicei pe portul 80 și transmite fluxul pe portul 8001.
• jellyfin-ffmpeg, versiunea de ffmpeg care vine cu Jellyfin.
• Un cont MediaLab Works cu o licență care acoperă plugin-ul: un abonament activ, o licență pe viață în fereastra sa de actualizări, pachetul Jellyfin sau perioada de probă gratuită de 30 de zile.
• Opțional: acces SSH root la receptor (fără parolă sau cu cheie) dacă vrei watchdog-ul receptorului. Este dezactivat la instalările noi.

Pasul 1 — Instalează Headend

Calea recomandată este depozitul tău privat de plugin-uri, astfel încât Jellyfin să instaleze și să actualizeze plugin-ul singur.

1. În contul tău MediaLab Works deschide Licenses → Jellyfin plugin repository și apasă Create address. Copiaz-o; conține un token, așa că păstreaz-o privată.
2. În Jellyfin deschide Dashboard → Plugins → Repositories, apasă +, dă-i un nume (de exemplu MediaLab Works), lipește adresa și salvează.
3. În Dashboard → Plugins → Catalog găsește Headend by MediaLab, apasă Install, apoi repornește Jellyfin.

Dacă preferi o instalare manuală, descarcă arhiva zip din Account → Licenses, extrage-o într-un folder nou numit Headend by MediaLab_x.y.z.0 în folderul de plugin-uri Jellyfin (/var/lib/jellyfin/plugins/ la o instalare Linux din pachet, /config/plugins/ în imaginea Docker oficială, %ProgramData%\Jellyfin\Server\plugins\ pe Windows) și repornește Jellyfin. Ghidul listează căile exacte și opțiunea catalogului public.

Pasul 2 — Activează licența

Deschide Dashboard → Plugins → Headend by MediaLab și apasă Open License page. Lipește cheia de licență și apasă Activate with key; plugin-ul leagă cheia de acest server și afișează licența ca Active. Nu ai încă o cheie? Introdu e-mailul pe aceeași pagină pentru a începe perioada de probă gratuită de 30 de zile. Licența este verificată o dată pe zi și la fiecare pornire a Jellyfin; fără internet, plugin-ul funcționează încă 7 zile după ultima verificare reușită.

Pasul 3 — Adaugă receptorul ca tuner

1. Deschide Dashboard → Live TV și adaugă un dispozitiv tuner de tip Headend (Enigma2 / Vu+).
2. Introdu adresa receptorului, portul OpenWebif (80), portul de flux (8001) și numele de utilizator și parola dacă OpenWebif le cere.
3. Alege buchetele de importat. Doar buchetele pe care le selectezi devin canale în Jellyfin.

Începând cu versiunea 1.0.5, parola OpenWebif este criptată în repaus în folderul de date al plugin-ului și nu este trimisă niciodată către browser; pagina afișează doar „set ✓”.

Pasul 4 — Adaugă furnizorul de ghid

În aceeași pagină Dashboard → Live TV adaugă furnizorul de ghid Headend. Ghidul de programe vine apoi de la receptor pentru fiecare canal. Headend reîmprospătează ghidul de la receptor la fiecare 60 de minute și poți forța o reîmprospătare din Dashboard → Scheduled Tasks → Refresh Guide.

Pasul 5 — Modelează lista de canale

Deschide Dashboard → Headend. Aici transformi o listă brută de receptor într-una pe care o gospodărie o poate folosi:

• Ascunde canalele fără nume.
• Ascunde versiunea SD când există versiunea HD.
• Ajustează numele, numerele și ordinea.
• Logo-urile canalelor (picon-urile) vin de la receptor; poți seta și un logo dintr-un link, la acțiunea administratorului, de până la 10 MB. Plugin-ul nu descarcă pachete de picon-uri.

Păstrează lista scurtă și ordonată așa cum fac oamenii zapping în mod real. O listă curată este diferența dintre o sursă Live TV folosită și una ignorată.

Pasul 6 — Acordă accesul pe utilizator

Utilizatorii noi pornesc fără acces Live TV prin Headend. Pe pagina Headend acordă accesul conturilor care ar trebui să îl aibă. Tot aici sunt gestionate canalele pentru adulți: stau în spatele unui PIN, deblocat pe utilizator pentru o perioadă limitată. Începând cu versiunea 1.0.6, PIN-urile noi au cel puțin 6 cifre, se stochează doar un hash PBKDF2-SHA256, iar încercările greșite sunt limitate cu blocări tot mai lungi care rezistă la repornire. În aplicații, PIN-ul este deblocat dintr-un browser la /Headend/Unlock pentru acel cont.

Pasul 7 — Urmărește

Reîmprospătează ghidul, apoi deschide Live TV în Jellyfin. Canalele, ghidul și logo-urile sunt servite prin Live TV-ul serverului, așa că orice aplicație cu Live TV ar trebui să funcționeze; Jellyfin Web este clientul verificat (redare HD în intervalul 4.4–4.7 s în testele publicate). Pe Jellyfin oficial, linkul către pagina TV se adaugă manual în config.json la menuLinks; pe medialab Server apare automat.

Sfaturi și depanare

• Niciun canal. Verifică faptul că OpenWebif se deschide într-un browser de pe serverul Jellyfin, la adresa pe care ai introdus-o. Dacă serverul nu poate ajunge la ea, nici Jellyfin nu va putea.
• Un canal nu se redă. Un tuner poate primi un singur transponder odată; o înregistrare sau un alt vizualizator pe un transponder diferit îl poate ocupa. Acesta este comportamentul normal, nu un defect al plugin-ului.
• Un utilizator nu vede Live TV. Acordă utilizatorului acces din pagina Headend; utilizatorii noi pornesc fără el.
• Ghid gol. Confirmă că furnizorul de ghid Headend este adăugat în Dashboard → Live TV, apoi rulează Refresh Guide din Scheduled Tasks. Ghidul este preluat de la receptor la fiecare 60 de minute.
• Fluxul OpenWebif nu funcționează. Reverifică portul de flux (8001 implicit) și eventuala autentificare OpenWebif. Adresa receptorului nu este transmisă niciodată clienților, așa că testează din partea serverului Jellyfin, nu de pe un telefon.
• Watchdog și SSH. Watchdog-ul receptorului este dezactivat la instalările noi. Dacă îl activezi, cheia de host SSH este verificată începând cu versiunea 1.0.5: este salvată la prima conexiune în ssh/known_hosts în folderul de date, iar dacă se schimbă, comanda nu este trimisă. Poți vedea și uita amprenta salvată din pagină.
• Actualizări. Dacă folosești o licență pe viață după fereastra sa de actualizări, rămâi pe depozitul tău privat, astfel încât Jellyfin să nu descarce versiuni pe care licența ta nu le acoperă. Roll back to x.y.z pe pagina License revine la versiunea anterioară și oprește actualizările automate pentru plugin până la următorul Install update. Changelog-ul arată ce s-a schimbat în fiecare versiune.

Concluzie

Headend face un singur lucru: transformă receptorul pe care îl ai deja într-o sursă Live TV de prim rang în Jellyfin, cu propriile buchete, ghid și picon-uri, și păstrează adresa receptorului pe partea de server. Configurează tunerul și furnizorul de ghid, petrece zece minute pe lista de canale, acordă accesul pe utilizator și ai o configurație TV legală, self-hosted, care se comportă ca orice altă bibliotecă Jellyfin. Pentru detalii dincolo de acest parcurs, ghidul utilizatorului și baza de cunoștințe sunt următoarele opriri; dacă ceva nu se potrivește, contactează-ne.