Files
simply-tv/README.pl.md
T
2026-11-17 17:29:00 +01:00

9.0 KiB
Raw Blame History

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

  1. TV: Ustawienia → System → Informacje – naciśnij 7× Kompilacja (tryb dewelopera).
  2. TV: Ustawienia → System → Opcje programisty – włącz Debugowanie przez sieć (Debugowanie ADB).
  3. Komputer (ta sama sieć):
    scripts/install-tv.sh <adres TV>      # np. 192.168.1.50
    
    Za pierwszym razem telewizor zapyta, czy zezwolić temu komputerowi – wybierz Zawsze zezwalaj i uruchom polecenie ponownie, jeśli się zatrzymało.

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:

  1. 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).
  2. Połącz i wczytaj kanały – kanały, logotypy i program trafiają do telewizora.
  3. 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.