jak odbierać yu tube na dekoderze ZGEMMA H8.2H
Wymagania wstępne
• Stabilne łącze ≥ 5 Mb/s (Ethernet zalecany).
• Aktualny image Enigma2 (OpenATV 7.3/7.4, OpenPLi 9.x, OpenVision 13 lub nowszy).
• GStreamer ≥ 1.18 oraz exteplayer3/ffmpeg 4.x (instaluje lub aktualizuje ServiceApp).
• Wolne 20–30 MB w pamięci flash na plugin.
Instalacja – trzy najpewniejsze scenariusze
a) Wtyczka YouTube (OE-Alliance)
Menu → Wtyczki → Zielony (Pobierz) → Kategorie “Multimedia” / “Online Video” → YouTube (python3-youtube)
Po instalacji: Menu → Ustawienia → System → ServiceApp → Player=exteplayer3 (lepsza obsługa strumieni DASH).
Pierwsze uruchomienie poprosi o klucz API – bez niego pojawi się błąd quotaExceeded.
b) ServiceApp + plugin FreeTube (bez API, oparte na Invidious)
c) E2iPlayer / IPTVPlayer (yt-dlp)
Konfiguracja klucza API (gdy wymaga go wybrana wtyczka)
a) console.cloud.google.com → Nowy projekt → Włącz “YouTube Data API v3” → Utwórz “Klucz API”.
b) Wklej 40-znakowy klucz w Ustawieniach pluginu (OpenWebif przyspiesza wprowadzanie).
c) Restart GUI (Enigma2) lub cały odbiornik.
Optymalizacja i typowe problemy
• Artefakty / zacięcia: zmniejsz “Max. bitrate” do 5-6 Mb/s lub jakość do 720p, sprawdź obciążenie CPU (Menu → Informacje → System).
• Brak dźwięku: upewnij się, że w ServiceApp jako “Preferred audio codec” wybrany jest “aac, mp3”.
• Plugin zniknął z listy: opkg update, a jeśli feed nie udostępnia pakietu – zainstaluj .ipk ręcznie z /tmp:
opkg install /tmp/enigma2-plugin-extensions-youtube*.ipk
Teoretyczne podstawy (skrócone)
Dekoder odbiera strumień HTTP-DASH/HLS, demultipleksuje w GStreamerze, audio-video przesyłane jest do sprzętowego dekodera Hi3798MV200 (H.264/H.265). Wtyczka wystawia interfejs do API YouTube, pobiera manifest MPD, a ServiceApp/exteplayer3 odpowiada za adaptacyjne dobieranie jakości i synchronizację A/V.
• Migracja pluginów z python2 do python3 (OpenATV 7.x, OpenPLi 9).
• Zastąpienie youtube-dl przez aktywnie rozwijany yt-dlp (obsługa nowych protokołów QUIC, VP9-profile2).
• Powstają projekty bez-API (FreeTube, NewPipe-E2) oparte na scrappingu Invidious – mniejsze ryzyko blokad klucza.
• W OpenVision 13 wbudowano “FastTube” – GUI podobne do SmartTubeNext.
• W sieci rośnie popularność skryptów auto-update yt-dlp co 24 h (crontab w Enigma2).
• H8.2H nie posiada dekodera sprzętowego VP9/AV1; wtyczki wymuszają strumienie H.264/H.265 do 1080p 30 fps.
• exteplayer3 korzysta z bibliotek ffmpeg do dekodowania audio-video w userspace, ale przy odtwarzaczu sprzętowym wykorzystuje ioctl /dev/hi_mpi.
• Przy wprowadzaniu klucza API warto utworzyć ograniczenia “HTTP referrers” = * oraz quota 10 000 zapytani/dzień (wystarczające dla typowego użycia domowego).
• Używaj wyłącznie oficjalnych lub dozwolonych przez licencję wtyczek.
• Pobieranie lub archiwizacja treści YouTube może naruszać regulamin – pluginy domyślnie streamują, nie zapisują.
• Pamiętaj o aktualizacji wtyczek z zaufanych repozytoriów (ryzyko złośliwego kodu w .ipk z nieznanego źródła).
• Zrób pełną kopię zapasową (Image-Backup) przed instalacją niestandardowych wtyczek.
• Jeśli UI zwiesi się po instalacji, telnet → init 4 → opkg remove plugin_faulty.ipk → init 3.
• Ustaw statyczny DNS (8.8.8.8) – niektóre lokalne routery filtrują trafiki DASH.
• Regularnie uruchamiaj “yt-dlp -U” z poziomu terminala, żeby uniknąć błędów Signature Cipher.
• Hardware H8.2H nie uciągnie 60 fps przy 1080p – skutkuje drop-frame.
• Zmiany w API Google mogą nagle wyłączyć działające pluginy – warto mieć alternatywę (E2iPlayer).
• Obrazy sprzed 2021 r. (python2) nie obsłużą nowych wtyczek – konieczny re-flash dekodera.
• Test plug-in “NewPipe-E2” (ściągany z github.com/pr2) – beta, ale bez API.
• Sprawdź projekt “libQuic-E2” – eksperymentalny transport QUIC poprawiający buffer-underflow.
• Rozważ cross-kompilację SmartTubeNext dla Hi3798-E2 (wymaga JavaScriptCore i EGLFS).
YouTube na Zgemma H8.2H jest możliwy, lecz wymaga:
Po poprawnej konfiguracji dekoder bezproblemowo odtwarza materiały do 720 p (najpłynniej) lub 1080 p 30 fps. W razie trudności pierwszymi krokami diagnostycznymi powinny być: test sieci, log z /var/volatile/log/enigma2 oraz aktualizacja wtyczki/yt-dlp.