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

98 lines
9.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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/<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:
```sh
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ć):
```sh
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. 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.