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

Dacă ai deja un receptor Enigma2 (Vu+, Zgemma, GigaBlue și similare) pentru propriul abonament de satelit sau cablu, ai deja un tuner perfect funcțional. Problema este că Emby nu vorbește cu Enigma2. Headend este un plugin pentru Emby care face puntea între cele două: citește receptorul prin OpenWebif și expune canalele pe care le acordează receptorul ca canale Emby Live TV, cu ghid, sigle de canale și control parental.

Un lucru de lămurit înainte de a începe: Headend nu oferă canale, liste de redare sau vreun abonament IPTV. El transmite ceea ce acordează propriul tău receptor de pe satelit sau cablu, pe hardware pe care îl controlezi. Dacă cauți canale de cumpărat, nu acesta este produsul, iar acest tutorial nu te va ajuta cu asta.

Acest ghid acoperă o configurare completă Emby Live TV cu un receptor Enigma2: conectarea, alegerea bouquet-urilor, combinarea datelor din ghid, picon-urile, PIN-ul pentru adulți și paznicul receptorului.

Cerințe preliminare

• Emby Server 4.10.1 sau mai nou, cu Emby Premiere pentru funcțiile Live TV.
• Un receptor Enigma2 cu un image recent (VTi, OpenATV, OpenPLi și similare) și OpenWebif 1.2.9 sau mai nou, accesibil din serverul Emby. Combinația testată în documentație este un Vu+ Duo 4K cu VTi 15.
• Opțional: un GPU NVIDIA cu NVENC dacă vrei ca canalele SD să fie upscalate pe server.
• Opțional: acces SSH root la receptor (fără parolă sau cu cheie) dacă vrei paznicul receptorului.
• O licență Headend pentru serverul tău Emby. Fără o licență validă plugin-ul este oprit: sarcinile automate nu rulează, iar paginile lui răspund cu motivul, așa că fă mai întâi pasul de licențiere.

Pasul 1: Instalează plugin-ul și activează licența

1. Autentifică-te în contul tău MediaLab Works, deschide Licenses și descarcă DLL-ul plugin-ului. Este disponibil pe un abonament activ, pe o licență lifetime în fereastra ei de actualizare sau în perioada de probă gratuită de 30 de zile.
2. Copiază DLL-ul în folderul de plugin-uri Emby și repornește Emby Server:
   • Linux (pachet): /var/lib/emby/plugins/
   • Docker: folderul plugins din volumul de configurare Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Deschide Emby Dashboard → Plugins, apasă pe plugin, lipește cheia de licență și salvează. Plugin-ul contactează serverul de licențe, leagă cheia de acest server Emby și afișează licența ca Active.

Licența este verificată o dată pe zi și la fiecare pornire a Emby. Fără internet, plugin-ul funcționează încă 7 zile după ultima verificare reușită; după aceea se oprește până când poate verifica din nou. Nimic nu este șters, iar totul își revine odată ce licența este din nou validă.

Pasul 2: Conectează-te la receptor

Deschide Dashboard → Plugins → Headend. În secțiunea Receiver, introdu IP-ul sau hostname-ul, portul OpenWebif (80 implicit) și un utilizator și o parolă dacă OpenWebif are autentificare activată. Apasă Test connection.

Dacă testul eșuează, verifică de pe hostul Emby însuși că OpenWebif răspunde, de exemplu deschizând http://receiver/api/getallservices într-un browser. Acesta este și primul pas de depanare mai târziu, dacă nu apar canale.

O notă despre credențiale: începând cu versiunea 0.2.9, parola OpenWebif este criptată în repaus în secrets.enc.json în folderul de date al plugin-ului (AES-256-GCM cu o cheie aleatorie legată de id-ul serverului, fișiere cu mod 600) și nu este trimisă niciodată către browser. Versiunile anterioare o păstrează în text simplu în configurația tunerului Live TV, așa că actualizează dacă poți.

Pasul 3: Alege bouquet-urile

În secțiunea Bouquets, alege ce bouquet-uri devin canale Emby. Numerele canalelor urmează ordinea bouquet-urilor, deci aici decizi ordinea canalelor pe care o vor vedea utilizatorii. Fă-o deliberat: o listă scurtă și ordonată de bouquet-uri este mai ușor de navigat de pe telecomanda unui televizor decât întreaga ta grilă de pe receptor.

Pasul 4: Datele din ghid (EPG)

EPG-ul propriu al receptorului este activat implicit, așa că obții un ghid fără efort suplimentar. Pentru o acoperire mai bună poți adăuga URL-uri XMLTV externe și poți mapa canalele după nume sau după service reference. Datele din ghid sunt combinate pe canal, așa că datele receptorului și sursele tale XMLTV se completează reciproc în loc să se suprascrie.

Fii conștient de ce contactează opțiunea de ghid extern. Pe instalările noi, începând cu versiunea 0.2.9, ghidul extern este oprit implicit și poate fi activat din checklist-ul de configurare inițială; la actualizări rămâne cum era. Când este activat, rulează zilnic la 04:00, cu 2 secunde între cereri, și contactează www.programetv.ro, www.cinemagia.ro, epgshare01.online și open-epg.com, plus propriile tale surse XMLTV (oprite implicit). Sunt cerute doar pagini de programe și fișiere; nu se trimit date ale utilizatorului. Imaginile de programe sunt transmise serverului ca URL-uri externe, iar serverul le poate descărca.

Pasul 5: Picon-uri (sigle de canale)

În secțiunea Picons poți folosi picon-urile deja existente pe receptor sau poți indica plugin-ului un folder local de picon-uri. Atât: plugin-ul nu descarcă singur pachete de picon-uri, iar siglele dintr-un link sunt preluate doar la o acțiune a administratorului, cu o limită de 10 MB.

Pasul 6: Upscaling NVENC opțional

Dacă serverul tău are un GPU NVIDIA cu NVENC, poți activa upscaling, alege rezoluția țintă și seta un număr maxim de fluxuri simultane. Astfel canalele SD sunt upscalate pe server înainte de a ajunge la clienți. Dacă redarea sacadează după aceea, scade rezoluția țintă sau oprește upscaling-ul și verifică rețeaua între receptor și server.

Pasul 7: Canalele pentru adulți și PIN-ul

Marchează canalele pe care vrei să le pui sub control parental și setează un PIN. Este stocat doar un hash PBKDF2-SHA256 al PIN-ului (200.000 de iterații, cu salt). Începând cu versiunea 0.2.10, PIN-urile noi trebuie să aibă cel puțin 6 cifre (un PIN existent continuă să funcționeze), iar încercările greșite sunt limitate cu blocări tot mai lungi care rezistă la o repornire. În aplicații, PIN-ul se deblochează dintr-un browser la /Headend/Unlock, pe cont.

Pasul 8: Paznicul receptorului (opțional)

Un receptor blocat înseamnă un flux Live TV mort. Paznicul este opțional și oprit pe instalările noi începând cu versiunea 0.2.9 (la actualizări rămâne cum era). Când este activat, setezi intervalul de verificare și acțiunea: repornire enigma2 sau scoatere din standby.

Funcționează prin SSH către receptor, deci are nevoie de SSH root fără parolă sau cu cheie. Rulează o verificare TCP/HTTP la fiecare 3 minute; după 2 eșecuri trimite comanda de repornire prin ssh (utilizator implicit root, cheie opțională), apoi repornește, colectând diagnostice prin SSH înainte de repornire. Gestionează și standby-ul după 10 minute de inactivitate și o scanare nocturnă de canale între 02:00 și 06:00. Începând cu versiunea 0.2.9, cheia de host SSH este verificată (trust on first use): este salvată la prima conexiune în ssh/known_hosts în folderul de date, iar dacă se schimbă, comanda nu este trimisă și apare un mesaj clar. Poți vedea și uita amprenta salvată din pagină.

Pasul 9: Adaugă tunerul în Emby și reîmprospătează ghidul

Mergi la Live TV → Settings → Tuner devices. Headend apare acolo ca tuner. Adaugă-l, apoi reîmprospătează ghidul.

Utilizare zilnică și limite

Canalele și ghidul apar în Live TV, iar înregistrarea funcționează ca la orice tuner Emby. Ține cont de calculul tunerelor: un tuner de pe receptor poartă un canal o dată, deși canalele de pe același transponder îl pot împărți. Planifică în consecință înregistrările simultane.

Suportul pentru clienți este asigurat prin Live TV-ul serverului, așa că canalele, ghidul, fluxurile, blocarea canalelor pentru adulți și preferințele de audio/subtitrări ar trebui să funcționeze în orice aplicație cu Live TV. Emby Web este verificat cap-coadă cu un Vu+ Duo 4K (VTi, OpenWebif), cu o pornire la rece de 4,4–5,7 s. Aplicațiile native și browserele de pe televizoare nu sunt testate. Pagina de administrare, pagina „TV” și pagina „Adult channels” sunt doar pentru browser.

Sfaturi și depanare

• Niciun canal: confirmă că OpenWebif este accesibil din hostul Emby (http://receiver/api/getallservices), apoi reverifică adresa și portul receptorului în plugin.
• Fără date în ghid: asigură-te că EPG-ul receptorului este activat, apoi adaugă URL-uri XMLTV și verifică maparea canalelor după nume sau service reference. Reține că ghidul extern este oprit implicit pe instalările noi.
• Sacadări: scade ținta de upscaling sau dezactivează upscaling-ul și verifică traseul de rețea între receptor și server.
• Receptorul se blochează: activează paznicul ca să repornească enigma2 când fluxurile nu mai răspund.
• Tuner ocupat: un alt canal folosește deja tunerul. Așteaptă să se termine sau înregistrează de pe același transponder.
• Confidențialitate: clienții nu văd niciodată adresa receptorului; fluxurile trec prin server. Listele tale M3U sunt opționale, iar canalele de internet (iptv-org) sunt oprite pe instalările noi începând cu versiunea 0.2.9.

Concluzie

Headend îți permite să folosești în continuare receptorul pe care îl ai deja ca tuner legal pentru Emby Live TV, cu bouquet-urile tale, un ghid combinat, picon-uri și un paznic care te scutește de o excursie în pod. Începe cu pagina produsului, urmează ghidul utilizatorului pentru câmpurile exacte și ține la îndemână changelog-ul când faci actualizări. Dacă ceva nu se potrivește, baza de cunoștințe și FAQ sunt următoarea oprire, iar ne poți contacta oricând.