# simply-tv Aplikacja na Android TV dla [simply-dvb](../simple-dvbt) (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/`), dokładnie jak klienci tvheadend. * **Kanały i logotypy**: zapisywane w bazie TV Androida (`TvContract`), logotypy z serwera (`/imagecache/`) – 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: ```sh scripts/build-apk.sh # -> dist/simply-tv-.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ć): ```sh scripts/install-tv.sh # 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. Wykresy obejmują ostatnie 3 minuty: sygnał/SNR i CPU pochodzą z historii statystyk, którą simply-dvb trzyma w pamięci (co 2 s, 15 minut; simply-dvb 0.1.18+), a przepływność odbieraną mierzy telewizor podczas odtwarzania – wykres jest więc pełny od razu po otwarciu karty. **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.