1. M3U a M3U8 - czym się różnią
Dla listy kanałów niczym istotnym. M3U8 to M3U zapisany w kodowaniu UTF-8, czyli z poprawnymi polskimi znakami w nazwach. Dziś praktycznie każda lista jest w UTF-8 niezależnie od rozszerzenia, a aplikacja czyta obie tak samo.
Zamieszanie bierze się stąd, że .m3u8 to także rozszerzenie
strumienia HLS - adresu pojedynczego kanału, który sam jest małą listą
segmentów wideo. W playliście IPTV adresy kanałów często kończą się na .m3u8,
i to jest normalne: lista M3U zawiera strumienie M3U8. Jeśli więc dostawca dał Ci adres
z .m3u8 na końcu, może to być zarówno cała lista, jak i jeden kanał.
Do aplikacji dodajesz listę, nie pojedynczy strumień - adres jednego
kanału wczyta się błędnie (aplikacja potraktuje jego segmenty jak kanały).
2. Jak dodać listę
Na ekranie głównym „Dodaj listę". Dwa źródła:
- Z adresu. Wklejasz adres podany przez dostawcę. Lista jest pobierana z serwera i odświeżana automatycznie - gdy dostawca dodaje lub usuwa kanały, po odświeżeniu widzisz zmiany.
- Z pliku. Wybierasz plik
.m3ulub.m3u8z pamięci telefonu, tabletu albo z pendrive'a w telewizorze. Aplikacja kopiuje go do siebie; taka lista nie odświeża się - żeby ją zmienić, usuwasz ją i dodajesz nowy plik.
Przy dodawaniu podajesz nazwę (dowolną), opcjonalnie adres przewodnika EPG i to, czy lista ma korzystać z domyślnego przewodnika z ustawień. Jeśli nie masz jeszcze żadnej listy, jednym przyciskiem dodasz listę demonstracyjną z materiałami na otwartych licencjach - tylko po to, żeby sprawdzić, czy odtwarzanie działa na Twoim urządzeniu.
Jedna lista jest dostępna bezpłatnie. Kilka list naraz, z przełączaniem między nimi, to funkcja wersji PRO.
3. Co aplikacja odczytuje z pliku
Poza nazwą i adresem kanału aplikacja rozumie te atrybuty w linii #EXTINF
i nagłówku #EXTM3U:
| Atrybut | Do czego służy |
|---|---|
| tvg-id | Identyfikator kanału w przewodniku EPG. Najpewniejszy sposób dopasowania programu. |
| tvg-name | Nazwa zapasowa, gdy po przecinku w #EXTINF nic nie ma. |
| tvg-logo | Adres logotypu kanału. Bez niego logo może przyjść z przewodnika EPG. |
| group-title | Grupa kanału - staje się kategorią na liście. Alternatywnie linia #EXTGRP:. |
| url-tvg | W nagłówku: adres przewodnika XMLTV. Także x-tvg-url. Przy kilku adresach brany jest pierwszy. |
| catchup | Rodzaj archiwum: default, append, shift, flussonic, xc. |
| catchup-source | Wzór adresu archiwum z podstawieniami {utc}, {utcend}, {lutc}, {duration}. |
| catchup-days | Ile dni wstecz sięga archiwum. Także timeshift i tvg-rec. Sam typ bez liczby = 7 dni. |
Wielkość liter w nazwach atrybutów nie ma znaczenia. Kanał bez grupy trafia do kategorii „Inne"; kanał bez nazwy dostaje numer.
Nieobsługiwane: linie #EXTVLCOPT i #KODIPROP
(nagłówki HTTP i klucze DRM per kanał) są pomijane. Strumienie z DRM nie odtworzą się.
4. Grupy, ulubione i własne kategorie
Grupy z playlisty stają się zakładkami kategorii na liście kanałów - w kolejności z pliku. Numer kanału jest zawsze z pełnej listy, więc nie zmienia się przy przełączaniu kategorii i można go wybrać cyframi z pilota.
Niezależnie od podziału dostawcy możesz oznaczać ulubione (własna kolejność w PRO) i tworzyć własne grupy (PRO) - te przetrwają odświeżenie listy, bo są zapisane po stronie aplikacji, powiązane z identyfikatorem lub nazwą kanału.
5. Odświeżanie listy
Lista z adresu jest pobierana ponownie nie częściej niż co 12, 24 lub 48 godzin - ustawienie „Odświeżanie list i EPG". Między pobraniami aplikacja używa zapisanej kopii, więc lista otwiera się natychmiast, także bez połączenia (kanały i tak wymagają sieci). Gdy serwer jest niedostępny w chwili odświeżania, używana jest starsza kopia. Ręcznie: „Odśwież listę i EPG" w menu listy kanałów.
Rzadsze odświeżanie to mniejsze ryzyko limitów - część dostawców blokuje konto po zbyt wielu pobraniach listy w krótkim czasie.
6. Formaty strumieni i panele dostawców
Aplikacja odtwarza to, co odtwarza Android: HLS (.m3u8),
MPEG-TS po HTTP (.ts, adresy bez rozszerzenia), a także
zwykłe pliki wideo (MP4, MKV). Adresy http i https; przekierowania między nimi
są dozwolone, bo panele często przekierowują strumienie na serwery bez szyfrowania.
Xtream Codes: aplikacja nie ma osobnego logowania loginem i hasłem.
Użyj adresu listy M3U, który panel udostępnia (zwykle .../get.php?username=…&password=…&type=m3u_plus).
Archiwum takich paneli (catchup="xc") jest obsługiwane.
Nieobsługiwane: portale Stalker/MAC, DASH, protokoły RTMP i UDP/multicast, strumienie z DRM.
7. Kopia zapasowa
Ustawienia → kopia zapasowa zapisuje listy, ulubione, grupy, blokadę rodzicielską, zaplanowane audycje i ustawienia do jednego pliku. Nic nie opuszcza urządzenia - plik przenosisz sam, np. z telefonu na telewizor.
8. Gdy lista się nie wczytuje
- 0 kanałów po dodaniu. Adres nie zwraca listy M3U, tylko stronę
HTML (logowanie, komunikat o wygaśnięciu konta). Otwórz adres w przeglądarce: powinien
pobrać się plik tekstowy zaczynający się od
#EXTM3U. - Lista jest, kanały nie ruszają. To problem strumienia, nie listy - patrz strona o telewizorze, punkty 4 i 7.
- Krzaki zamiast polskich liter. Plik nie jest w UTF-8. Przy liście z adresu poproś dostawcę o wersję M3U8; przy pliku zapisz go ponownie w UTF-8.
- Brak grup. Lista nie ma
group-titleani#EXTGRP; wszystko ląduje w „Inne". Zrób własne grupy (PRO) albo poproś dostawcę o wersjęm3u_plus. - Brak przewodnika. Patrz Przewodnik EPG.
W pozostałych przypadkach: kontakt@ipapptv.com - z pierwszymi liniami pliku (bez adresów z loginem i hasłem).