9.0 KiB
simply-tv
Aplikacja na Android TV dla simply-dvb (działa też z tvheadend). Dodaje serwer DVB jako źródło we wbudowanej aplikacji TV telewizora (Android TV Input Framework): kanały z logotypami i program TV pojawiają się na liście kanałów i w przewodniku telewizora, a obraz odtwarza odtwarzacz telewizora ze sprzętowym dekodowaniem (HEVC, AC-3/E-AC-3, MPEG-2…).
- Protokół: HTSP tvheadend (port 9982) – kanały, EPG, nagrania i bilety (ticket); strumienie
po HTTP (port 9981,
/stream/channelid/<id>), dokładnie jak klienci tvheadend. - Kanały i logotypy: zapisywane w bazie TV Androida (
TvContract), logotypy z serwera (/imagecache/<id>) – bez płatnych pakietów. - Program TV: 7 dni, gatunki, opisy; odświeżany co godzinę i na żądanie.
- Nagrywanie: na serwerze (DVR simply-dvb). Z aplikacji (Program TV i nagrywanie, OK na audycji) oraz – jeśli aplikacja TV telewizora to obsługuje – z jej przewodnika. Gotowe nagrania są w aplikacji (Nagrania: odtwórz, zatrzymaj, usuń) i na liście nagrań telewizora.
- Odtwarzanie: ExoPlayer (Media3) na powierzchni aplikacji TV; wybór ścieżki dźwiękowej i napisów DVB z menu telewizora; nagrania z przewijaniem.
- Własny odtwarzacz (Odtwarzacz simply-tv): pełny ekran, kanał +/− i numery z pilota, OK = lista kanałów z logotypami i bieżącą audycją, pasek informacji z „teraz/następnie”. Działa niezależnie od aplikacji TV – można używać obu.
- Języki: angielski, polski (wg języka telewizora).
Docelowo: Android TV 8.0+ (testowy cel: Sony BRAVIA z Android TV 12).
Budowanie
Potrzebny jest tylko Docker:
scripts/build-apk.sh # -> dist/simply-tv-<wersja>.apk
Pierwsze budowanie tworzy obraz budujący (JDK 17 + Android SDK, ok. 1,5 GB) oraz klucz podpisu w
keystore/. Zachowaj katalog keystore/ (zrób kopię): Android instaluje aktualizację tylko
wtedy, gdy jest podpisana tym samym kluczem.
Instalacja na telewizorze
- TV: Ustawienia → System → Informacje – naciśnij 7× Kompilacja (tryb dewelopera).
- TV: Ustawienia → System → Opcje programisty – włącz Debugowanie przez sieć (Debugowanie ADB).
- Komputer (ta sama sieć):
Za pierwszym razem telewizor zapyta, czy zezwolić temu komputerowi – wybierz Zawsze zezwalaj i uruchom polecenie ponownie, jeśli się zatrzymało.
scripts/install-tv.sh <adres TV> # np. 192.168.1.50
Parowanie kodem QR
Na ekranie konfiguracji wpisz tylko adres serwera i wybierz Paruj kodem QR. Zeskanuj kod telefonem, zaloguj się do panelu simply-dvb i zatwierdź – telewizor dostaje własny token dostępu, nic nie trzeba wpisywać pilotem (albo wpisz 6-znakowy kod w panelu: Dostęp → Sparuj telewizor).
Kilka serwerów
simply-tv trzyma listę serwerów (Serwery na ekranie startowym, otwiera się też z „konfiguracji kanałów” w aplikacji TV). Dla każdego serwera:
- Używaj w odtwarzaczu – serwer aktywny dla własnego odtwarzacza, przewodnika i nagrań. W odtwarzaczu otwórz listę kanałów (OK) i wciśnij w lewo, aby przełączyć serwer; ostatni kanał jest pamiętany osobno dla każdego serwera.
- Źródło aplikacji TV wł./wył. – czy kanały tego serwera trafiają do wbudowanej aplikacji TV telewizora. Kilka serwerów może zasilać ją jednocześnie; nazwa serwera widnieje jako sieć kanału. Wyłączenie serwera usuwa jego kanały (i nagrania) z aplikacji TV przy następnej synchronizacji.
- Wczytaj kanały do aplikacji TV od razu synchronizuje wszystkie włączone serwery.
Przejście z wersji 0.8 i starszych (io.simplydvb.tv)
Od 0.9 identyfikator aplikacji to io.simplytv, więc Android instaluje ją jako nową aplikację obok starej. Po instalacji: dodaj serwer ponownie (parowanie kodem QR), w razie potrzeby włącz ponownie autostart, skonfiguruj kanały w aplikacji TV (wejście jest nowe), a potem odinstaluj starą: adb uninstall io.simplydvb.tv.
Ekran startowy
Najpierw odtwarzacz: Oglądaj telewizję ma fokus, więc OK otwiera go na ostatnim kanale. Pod tytułem widać ten kanał i to, co na nim teraz leci, z paskiem postępu – dane z serwera (/api/epg/events/grid), odświeżane po zakończeniu audycji. Niżej: Program TV, Nagrania, Aplikacja TV (wbudowana aplikacja telewizora z kanałami simply-tv), Serwery i Ustawienia; dalej stan aktywnego serwera z przyciskiem Synchronizuj, a na dole klawisze pilota w odtwarzaczu.
Informacje na ekranie (OSD)
Przy każdej zmianie kanału, a przyciskiem INFO lub strzałką w lewo w dowolnej chwili, odtwarzacz pokazuje na dole: numer, logo i nazwę kanału; małe znaczniki z obrazem (Full HD 1920×1080 50 fps), dźwiękiem (E-AC-3 5.1), sygnałem i SNR z serwera (zielony / pomarańczowy / czerwony) oraz przepływnością faktycznie odbieraną przez telewizor, a także REC, gdy kanał jest nagrywany; zegar i datę; co leci teraz z godzinami, paskiem postępu, pozostałymi minutami i krótkim opisem; oraz co było wcześniej, co będzie następnie i później. Ponowne INFO / strzałka w lewo albo WSTECZ chowa OSD.
Ustawienia
Ustawienia na ekranie startowym: OSD przy zmianie kanału, czas wyświetlania (3–15 s), szczegóły techniczne i opis w OSD; szczegółowa karta tunera przy zmianie kanału (domyślnie wyłączona – OSD pokazuje najważniejsze dane; NIEBIESKI nadal włącza ją podczas oglądania); tunelowanie wideo; start razem z telewizorem; zarządzanie serwerami; wersja. Lewa kolumna objaśnia zaznaczoną opcję.
Klawisze pilota w odtwarzaczu
Góra / CH+ – następny kanał, dół / CH- – poprzedni · cyfry – numer kanału · OK – lista kanałów (w lewo: inny serwer, w prawo: siatka programu) · strzałka w prawo lub GUIDE – siatka programu · strzałka w lewo lub INFO – OSD (i karta tunera, jeśli włączona) · CZERWONY / REC – nagraj bieżącą audycję (ponownie: zatrzymaj) · ZIELONY – ścieżka dźwiękowa · ŻÓŁTY – napisy · NIEBIESKI – karta tunera wł./wył. · przycisk poprzedniego kanału.
Siatka programu (także Program TV na ekranie startowym): kanały w pionie, czas w poziomie, linia „teraz” i szczegóły zaznaczonej audycji u góry. Góra/dół – kanał, lewo/prawo – audycja, CH+/CH- – strona, OK – szczegóły z nagrywaniem / oglądaniem, CZERWONY – nagraj lub anuluj, ZIELONY – powrót do „teraz”, WSTECZ – zamknij. Niektóre piloty Sony zostawiają przycisk GUIDE dla przewodnika telewizora – strzałka w prawo działa zawsze.
Karta tunera (prawy górny róg, opcjonalna) pokazuje adapter, częstotliwość, synchronizację, trzy małe wykresy – sygnał/SNR, CPU serwera (cały host i proces simply-dvb, wymaga simply-dvb 0.1.13+) oraz przepływność strumienia faktycznie odbieranego przez telewizor (pod spodem przepływność multipleksu) – a także modulację/FEC, BER i liczniki błędów.
Płynny obraz: Tunelowanie wideo (Ustawienia, domyślnie włączone) przekazuje dekodowanie i synchronizację obrazu do toru wideo telewizora – tego samego, którego używa wbudowany tuner. Jeśli na jakimś kanale nie ma wtedy obrazu, wyłącz je. Biała linia na karcie tunera pokazuje, co telewizor robi ze strumieniem: rozdzielczość, wyświetlane klatki na sekundę, gubione klatki (na czerwono), bufor i dekoder; ostatnia linia to czasy sterownika w simply-dvb (odczyt statystyk sygnału i najdłuższa przerwa w strumieniu).
Start razem z telewizorem: Uruchamiaj odtwarzacz z telewizorem (Ustawienia) otwiera własny odtwarzacz na ostatnim kanale po starcie telewizora i po wybudzeniu ze stanu czuwania. Android pozwala otworzyć ekran z tła tylko z uprawnieniem Wyświetlanie nad innymi aplikacjami – aplikacja otwiera ten ekran ustawień; jeśli telewizor go nie ma, nadaj je raz z komputera: adb shell appops set io.simplytv SYSTEM_ALERT_WINDOW allow. Na ekranie głównym jest też drugi kafelek, simply-tv Na żywo, który od razu otwiera odtwarzacz. Przycisk TV na pilocie zawsze otwiera wbudowaną aplikację TV telewizora – kanały simply-tv też w niej działają (przez wejście TV).
Pierwsze uruchomienie
Najprościej – kod QR: wpisz tylko adres serwera i wybierz Paruj kodem QR. Zeskanuj kod telefonem, zaloguj się do panelu simply-dvb i zatwierdź – serwer utworzy token dostępu dla telewizora, a telewizor sam go pobierze (bez wpisywania tokenu pilotem). Bez telefonu: panel → Dostęp → Sparuj telewizor i wpisz 6-znakowy kod z ekranu TV.
Ręcznie:
- simply-tv otworzy ustawienia serwera: adres serwera simply-dvb, port HTSP (9982), port HTTP (9981). W sieci lokalnej użytkownik i hasło nie są potrzebne; spoza domu dowolna nazwa użytkownika i token dostępu jako hasło (panel simply-dvb → Dostęp → tokeny).
- Połącz i wczytaj kanały – kanały, logotypy i program trafiają do telewizora.
- Otwórz aplikację TV (Sony: przycisk TV / Wejścia) i wybierz źródło simply-tv. Kanał +/−, numery i przycisk przewodnika działają jak przy wbudowanym tunerze.