EPG IPTV: czym jest przewodnik TV i jak go dodać

EPG (Electronic Program Guide) to elektroniczny program telewizyjny: lista audycji z godzinami i opisami, którą odtwarzacz IPTV pokazuje przy każdym kanale. Sam odtwarzacz go nie ma. Pobiera go od dostawcy, najczęściej automatycznie po zalogowaniu danymi Xtream, a przy liście M3U z osobnego linku w formacie XMLTV.

Gdy przewodnik jest pusty albo pokazuje złe godziny, przyczyna prawie zawsze leży w jednym z trzech miejsc: brak źródła, kanały niedopasowane do programu albo strefa czasowa. W tym poradniku wyjaśniam, jak to działa, gdzie dodać EPG w aplikacjach opisanych na naszym blogu i jak naprawić najczęstsze usterki. Fakty o aplikacjach pochodzą z ich oficjalnych stron, sprawdzonych 15 października 2026.

Co to jest EPG i co daje w IPTV

EPG to ta sama ramówka, którą znasz z telewizji naziemnej czy satelitarnej, tylko wyświetlana w aplikacji. Widzisz, co leci teraz, co będzie później, krótki opis audycji i siatkę programu na kolejne dni.

W IPTV program telewizyjny to osobne dane, niezależne od samych kanałów. Lista kanałów (M3U albo dane Xtream) mówi odtwarzaczowi, co możesz oglądać. Przewodnik mówi, co i o której będzie nadawane. Dlatego kanały mogą działać bez zarzutu, a siatka programu i tak jest pusta: to dwa różne źródła.

Co daje działający EPG:

• wiesz, co leci na innych kanałach, bez przełączania jednego po drugim,
• planujesz oglądanie na kilka dni naprzód (ile dni, zależy od dostawcy),
• w aplikacjach z oglądaniem wstecz wybierasz minioną audycję prosto z siatki programu,
• za granicą widzisz godziny w swojej strefie czasowej, jeśli urządzenie ma ją dobrze ustawioną.

Czym EPG nie jest: nie jest listą kanałów, nie daje dostępu do żadnego kanału i nie jest osobną aplikacją. Sam link do przewodnika, bez listy, nic Ci nie pokaże. Jeśli dopiero zaczynasz i nie wiesz, czym różni się lista od odtwarzacza, zacznij od tekstu IPTV: co to jest i jak działa.

Skąd odtwarzacz bierze program telewizyjny

To, czy musisz cokolwiek ustawiać, zależy od tego, w jakiej formie dostałeś dostęp od dostawcy. Są trzy typowe sytuacje.

Logowanie Xtream: przewodnik zwykle przychodzi sam

Przy logowaniu danymi Xtream odtwarzacz łączy się z serwerem dostawcy i pobiera z niego zarówno kanały, jak i program. Kanały i przewodnik pochodzą z jednego miejsca, więc zwykle pasują do siebie bez Twojej pomocy. Po pierwszym logowaniu daj aplikacji chwilę: przy długiej liście program potrafi doczytywać się jeszcze przez kilka minut. Więcej o samych danych Xtream i różnicy względem M3U piszemy w poradniku jak skonfigurować IPTV.

Lista M3U: osobny link do przewodnika

Lista M3U to plik z adresami kanałów. Programu w nim nie ma, więc dostawca podaje drugi link: do przewodnika w formacie XMLTV. Taki link kończy się często na .xml albo na .xml.gz. Końcówka .gz oznacza plik skompresowany, który zajmuje mniej miejsca i szybciej się pobiera. Dodatek PVR IPTV Simple Client do Kodi, według swojej oficjalnej dokumentacji, czyta przewodniki skompresowane metodą Gzip i XZ. Czym dokładnie jest lista i jak ją wczytać, opisujemy w tekście o liście M3U.

Adres przewodnika zapisany w samej liście

Niektórzy dostawcy wpisują adres przewodnika do pierwszej linii pliku M3U, w nagłówku listy (atrybut x-tvg-url). Odtwarzacz, który to rozumie, pobierze wtedy EPG bez Twojego udziału. Kodi korzysta z tego adresu tylko wtedy, gdy w ustawieniach dodatku nie wskazano innego źródła przewodnika. Czy i jak robią to inne aplikacje, ich twórcy nie opisują na stronach, które sprawdziliśmy, dlatego tego nie zgadujemy.

Nie wiesz, czy Twój obecny dostęp w ogóle zawiera przewodnik? W planach RodakTV program EPG jest w komplecie, a sprawdzisz to na swoim sprzęcie w bezpłatnym teście.

Co jest w pliku XMLTV

XMLTV to otwarty, tekstowy format zapisu programu telewizyjnego. Nie musisz go otwierać ani edytować, ale gdy wiesz, z czego się składa, łatwiej zrozumiesz, dlaczego przewodnik czasem nie działa. Według oficjalnej specyfikacji formatu (plik DTD projektu XMLTV, sprawdzony 15 października 2026) plik zawiera dwie rzeczy: opis kanałów i listę audycji.

Z tej tabeli wynikają dwie najważniejsze rzeczy dla widza. Po pierwsze, program trafia do kanału po identyfikatorze, a nie „sam z siebie”. Po drugie, godziny w pliku mają swoją strefę czasową, więc zegar Twojego urządzenia też musi być ustawiony dobrze.

Jak odtwarzacz łączy program z kanałem

To najważniejszy mechanizm EPG i przyczyna większości problemów. Każdy kanał na liście M3U ma w swojej linii kilka opisów. Dla przewodnika liczą się trzy: identyfikator przewodnika (tvg-id), nazwa przewodnika (tvg-name) i zwykła nazwa kanału wyświetlana na liście.

Dokumentacja dodatku PVR IPTV Simple Client do Kodi (sprawdzona 15 października 2026) opisuje dopasowanie krok po kroku:

1. Odtwarzacz porównuje identyfikator kanału z pliku przewodnika z identyfikatorem tvg-id na liście.
2. Jeśli to nie wystarczy, porównuje nazwę z przewodnika z tvg-name z listy, w oryginale albo ze spacjami zamienionymi na podkreślenia.
3. Na końcu porównuje ją ze zwykłą nazwą kanału na liście.

Po stronie przewodnika Kodi sprawdza najpierw identyfikator, a potem każdą nazwę wyświetlaną kanału. Ma też opcję ignorowania wielkości liter w identyfikatorach, przydatną, gdy jedno źródło pisze je małymi, a drugie wielkimi literami.

Inne aplikacje nie publikują tak dokładnego opisu, ale zasada jest ta sama: program trafia na właściwy kanał tylko wtedy, gdy identyfikator albo nazwa się zgadzają. Prosty przykład: na liście kanał informacyjny ma identyfikator „kanal.informacyjny.pl”, a w przewodniku „kanalinformacyjny.pl”. Dla człowieka to ten sam kanał, dla odtwarzacza dwa różne. Efekt: kanał działa, a program przy nim jest pusty.

Dlatego najlepiej, gdy lista i przewodnik pochodzą od tego samego dostawcy, który przygotował je do siebie nawzajem. Problemy zaczynają się, gdy listę bierzesz z jednego miejsca, a przewodnik z innego.

Nie chcesz sklejać listy i programu z dwóch różnych źródeł? W naszym dostępie lista kanałów i program EPG przychodzą razem. Sprawdź to na swoim telewizorze w darmowym teście.

Gdzie dodać EPG: aplikacja po aplikacji

Każdy odtwarzacz chowa ustawienia przewodnika gdzie indziej. Poniżej masz skrót dla aplikacji, które opisujemy na blogu. Dokładne kroki z nazwami opcji są w poradnikach do konkretnych aplikacji, więc tutaj ich nie powtarzamy. Tam, gdzie twórca aplikacji nie publikuje instrukcji, którą mogliśmy sprawdzić, nie podajemy nazw opcji.

OTT Navigator i TiviMate

Obie aplikacje przy logowaniu Xtream zwykle wczytują program bez Twojego udziału. Różnią się tym, co dzieje się z osobnym linkiem. W OTT Navigatorze ma znaczenie, gdzie go wpiszesz, bo od tego zależy, czy kanały dopasują się po nazwie i identyfikatorze, czy tylko po nazwie. W TiviMate najczęstszą pułapką jest źródło przewodnika dodane w ustawieniach, ale nieprzypisane do żadnej listy. Oba przypadki z dokładnymi nazwami opcji opisujemy w poradnikach do OTT Navigatora i TiviMate, w częściach o programie EPG.

IPTV Smarters Pro

Oficjalna strona aplikacji potwierdza, że IPTV Smarters Pro ma elektroniczny program telewizyjny (stan na 15 października 2026). Twórcy nie publikują jednak instrukcji z nazwami opcji EPG, którą mogliśmy sprawdzić, a strony nieoficjalne podają je różnie. Dlatego nie wymieniamy ich tutaj. Przy logowaniu danymi Xtream program pojawia się zwykle sam. Jeśli go nie ma, sprawdź najpierw, czy dostawca w ogóle go udostępnia. Resztę konfiguracji znajdziesz w poradniku instalacja IPTV Smarters Pro.

Smart IPTV

W Smart IPTV listę wgrywasz przez stronę aplikacji, a nie na telewizorze. Oficjalne FAQ aplikacji (siptv.app, sprawdzone 15 października 2026) wspomina przy tym pole wykrywania EPG (Detect EPG). Gdy lista się nie wczytuje, twórcy radzą zmniejszyć listę, wyłączyć zewnętrzny EPG albo odznaczyć to pole przy wgrywaniu listy. Jak Smart IPTV dopasowuje program do kanałów, twórcy nie opisują na stronach, które udało się otworzyć, więc tego nie opisujemy. Krok po kroku przez aktywację i wgrywanie listy prowadzi poradnik aktywacja Smart IPTV. Na telewizorze Samsung przyda się też tekst IPTV na Smart TV Samsung.

Kodi: ustawienia EPG w PVR IPTV Simple Client

Kodi ma najlepiej udokumentowane ustawienia przewodnika. Nazwy podaję tak, jak są w oficjalnej dokumentacji dodatku, czyli po angielsku. W polskiej wersji Kodi mogą brzmieć inaczej.

1. Otwórz ustawienia dodatku PVR IPTV Simple Client i przejdź do sekcji EPG. Jak znaleźć dodatek w menu Kodi, pokazujemy w poradniku IPTV w Kodi.
2. W polu Location wybierz Remote path, jeśli masz link do przewodnika, albo Local path, jeśli masz plik zapisany na urządzeniu.
3. Wpisz link w polu XMLTV URL (albo ścieżkę do pliku w polu XMLTV path).
4. Przy linku możesz włączyć Cache XMLTV at local storage, czyli zapisywanie przewodnika na urządzeniu.
5. Jeśli wszystkie audycje są przesunięte o tyle samo godzin, ustaw EPG time shift. Zakres to od minus 12 do plus 14 godzin.

Dostawca może też zapisać przesunięcie w samej liście, dla całej listy albo dla pojedynczego kanału (atrybut tvg-shift). Opcja Apply time shift to all channels sprawia, że Twoje ustawienie z punktu 5 zastępuje przesunięcia z listy na wszystkich kanałach.

Masz już odtwarzacz, ale brakuje Ci listy z przewodnikiem? Poproś o dane testowe i wpisz je w aplikacji, której używasz.

EPG nie działa: przyczyny i naprawa

Większość usterek przewodnika da się rozpoznać po tym, jak wygląda siatka programu. Zacznij od objawu w lewej kolumnie.

Program jest pusty wszędzie

Najpierw upewnij się, że przewodnik w ogóle istnieje. Nie każdy dostęp go zawiera, a bez źródła odtwarzacz nie ma czego pokazać. Jeśli masz osobny link, skopiuj go jeszcze raz w całości: jeden brakujący znak wystarczy, żeby aplikacja nic nie pobrała.

Prosty test: otwórz link do przewodnika w przeglądarce telefonu. Poprawny link pobiera plik albo pokazuje długi tekst z opisem kanałów i audycji. Jeśli zamiast tego widzisz stronę logowania albo komunikat o błędzie, problem leży w linku, a nie w odtwarzaczu.

Program jest tylko przy części kanałów

To prawie zawsze kwestia dopasowania, opisanego wyżej. Odtwarzacz nie znalazł w przewodniku identyfikatora ani nazwy, które pasowałyby do części kanałów z listy. Jeśli lista i przewodnik są od tego samego dostawcy, zgłoś mu, przy których kanałach brakuje programu. Jeśli łączysz źródła z różnych miejsc, właśnie to jest przyczyną. W Kodi możesz jeszcze włączyć Ignore Case for EPG Channel IDs, co pomaga, gdy różnią się tylko wielkie i małe litery.

Wszystkie godziny są przesunięte

Gdy każda audycja zaczyna się na przykład godzinę za wcześnie, przewodnik działa, tylko godziny się rozjechały. Plik XMLTV zapisuje czas razem ze strefą czasową, więc zacznij od zegara urządzenia: ustaw strefę miejsca, w którym mieszkasz, i automatyczną datę i godzinę. Dotyczy to szczególnie oglądania z Wielkiej Brytanii czy Irlandii, gdzie zegar jest godzinę za Polską, i z innych krajów poza naszą strefą. Tę samą kolejność polecamy w poradniku do OTT Navigatora.

Dopiero gdy to nie pomoże, użyj przesunięcia czasu w aplikacji (w Kodi to EPG time shift, w TiviMate osobne ustawienie przesunięcia przewodnika). Pamiętaj, że ręczne przesunięcie to stała liczba godzin. Po zmianie czasu z letniego na zimowy albo odwrotnie może przestać pasować, więc wtedy sprawdź je jeszcze raz.

Program się kończy albo pokazuje miniony dzień

Odtwarzacz pokazuje tyle dni, ile jest w pliku przewodnika, i odświeża go co jakiś czas. Jeśli siatka kończy się na dzisiejszym wieczorze albo wyświetla wczorajsze audycje, odśwież przewodnik ręcznie w ustawieniach aplikacji. Gdy nic nie pomaga, usuń listę i dodaj ją od nowa: aplikacja pobierze wtedy wszystko od zera.

Lista przestała się wczytywać po dodaniu EPG

Przewodnik dla kilku tysięcy kanałów na kilka dni naprzód to spory plik, a tańsze telewizory i przystawki mają mało pamięci. Twórcy Smart IPTV w swoim FAQ radzą w takiej sytuacji zmniejszyć listę i wyłączyć zewnętrzny EPG albo odznaczyć wykrywanie EPG przy wgrywaniu listy. Jeśli bez przewodnika lista działa, wiesz już, że problemem jest jego rozmiar. Inne przyczyny zacinania, niezwiązane z EPG, opisujemy w tekście IPTV się tnie.

Program działa u Ciebie tylko przy części kanałów albo w ogóle? W teście 24 h dostajesz listę i przewodnik z jednego źródła, więc od razu zobaczysz, czy problem leżał w dopasowaniu.

EPG a oglądanie wstecz

Przewodnik przydaje się nie tylko do sprawdzenia, co leci teraz. W aplikacjach, które obsługują oglądanie wstecz, właśnie z siatki programu wybierasz audycję, która już się skończyła.

Tak opisują to twórcy dwóch aplikacji (strony sprawdzone 15 października 2026), a trzeci przypadek opisaliśmy już na blogu:

• Smart IPTV: dostawca oznacza w liście kanały z archiwum i liczbę dni, przez które jest dostępne. Gdy wybierasz audycję z przewodnika z dzisiejszego lub wcześniejszego dnia, aplikacja sama dopisuje do adresu strumienia godzinę jej startu. Według strony twórców aplikacja obsługuje obecnie do 15 dni wstecz, ale ile dni naprawdę masz, zależy od dostawcy.
• Kodi (PVR IPTV Simple Client): dodatek ma osobną grupę ustawień oglądania wstecz, między innymi Enable catchup i odtwarzanie z przewodnika w trybie telewizji na żywo.
• TiviMate: oglądanie minionych audycji jest częścią wersji Premium, co opisujemy w poradniku do TiviMate.

Bez działającego EPG ta funkcja traci sens, bo nie masz z czego wybrać audycji. W planach RodakTV jest odtwarzanie do 7 dni wstecz, a program EPG jest w komplecie (szczegóły w cenniku abonamentu).

Darmowe przewodniki z internetu: dlaczego zwykle zawodzą

W sieci łatwo trafić na ogólne linki do przewodników, polecane jako uniwersalne. W praktyce sprawiają więcej kłopotu niż pożytku. Są przygotowane pod czyjąś inną listę, więc identyfikatory kanałów rzadko pasują do Twojej. Często to bardzo duże pliki, które spowalniają słabszy sprzęt. Potrafią też z dnia na dzień zniknąć, a wtedy siatka programu znów jest pusta.

Jeśli Twój dostawca daje własny przewodnik, używaj właśnie jego. Jeśli go nie daje, a program jest dla Ciebie ważny, to dobry powód, żeby przy wyborze usługi zapytać o EPG wprost. Na co jeszcze patrzeć przy wyborze, piszemy w tekście o najlepszych aplikacjach IPTV i na stronie testu IPTV.

Jak sprawdzić EPG w czasie testu 24 h

Test to najlepszy moment, żeby sprawdzić przewodnik na własnym sprzęcie, zanim zapłacisz. Przejdź przez tę krótką listę:

1. Otwórz siatkę programu i sprawdź, czy przewodnik jest przy kanałach, które oglądasz najczęściej.
2. Porównaj audycję w przewodniku z tym, co faktycznie leci na ekranie. Jeśli godziny się rozjeżdżają, zacznij od strefy czasowej urządzenia.
3. Przewiń siatkę do przodu i zobacz, na ile dni naprzód jest program.
4. Wybierz z przewodnika audycję, która już się skończyła, i sprawdź, czy da się ją obejrzeć.
5. Jeśli oglądasz na kilku urządzeniach, na przykład na telewizorze i telefonie, sprawdź przewodnik na każdym z nich.

Jeśli coś z tej listy nie działa, napisz do nas w trakcie testu. Łatwiej to wyjaśnić od razu, na Twoim sprzęcie, niż po zakupie.

Chcesz przejść tę listę na swoim telewizorze? Poproś o bezpłatny test 24 h z listą kanałów i programem EPG.

W skrócie

• EPG to program telewizyjny w odtwarzaczu. Przychodzi od dostawcy, nie z aplikacji.
• Przy logowaniu Xtream pojawia się zwykle sam, przy liście M3U potrzebujesz osobnego linku XMLTV.
• Program tylko przy części kanałów oznacza niedopasowane identyfikatory: używaj przewodnika od tego samego dostawcy co lista.
• Przesunięte godziny naprawiasz najpierw strefą czasową urządzenia, a dopiero potem przesunięciem w aplikacji.