#EXTM3U
#EXTINF:-1 tvg-id="trt1.tr" tvg-name="TRT 1 HD" tvg-logo="https://stream.example.com:8080/images/trt1.png" group-title="Ulusal",TRT 1 HD
https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
#EXTINF:-1 tvg-id="atv.tr" tvg-name="ATV HD" tvg-logo="https://stream.example.com:8080/images/atv.png" group-title="Ulusal",ATV HD
https://stream.example.com:8080/live/demo_user/demo_pass/102.m3u8
Dokumentacja techniczna
Specyfikacja formatu playlisty M3U
Kompletna specyfikacja formatu playlisty M3U dla IPTV. Poznaj tagi Poziomu 1 i 2, parsowanie kanałów oraz sprawdzaj playlisty interaktywnie.
Wprowadzenie do formatu M3U w Mayk IP TV
Format playlisty M3U to powszechny standard list kanałów IPTV. Mayk IP TV w pełni obsługuje zarówno tradycyjne pliki M3U, jak i nowoczesne pliki M3U8 z rozbudowanymi metadanymi.
Struktura i składnia playlisty
Prawidłowy plik M3U rozpoczyna się od deklaracji #EXTM3U, po której następują pary wierszy z metadanymi #EXTINF oraz bezpośrednimi adresami URL strumieni.
Klasyfikacja VOD i seriali
Materiały wideo są automatycznie klasyfikowane jako transmisje na żywo, filmy lub odcinki seriali na podstawie wzorców sezonów, takich jak S01 E02.
Najlepsze praktyki parsowania
Należy zadbać o kodowanie UTF-8, bezpośrednie łącza HTTP/HTTPS oraz unikalne identyfikatory tvg-id dla poprawnego działania przewodnika EPG.
Poziom 1: Standardowe tagi #EXTINF
| Pole / Tag | Poziom | Typ | Przykładowa wartość | Opis |
|---|---|---|---|---|
#EXTM3U | Standardowy (Poziom 1) · Wymagane | Directive (Header) | #EXTM3U | Wymagana linia nagłówka identyfikująca plik jako rozszerzoną playlistę M3U. |
#EXTINF | Standardowy (Poziom 1) · Wymagane | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Dyrektywa informacji o ścieżce określająca czas trwania i atrybuty metadanych. |
tvg-id | Standardowy (Poziom 1) · Opcjonalne | String | trt1.tr | Unikalny identyfikator wiążący kanał z danymi przewodnika XMLTV EPG. |
tvg-name | Standardowy (Poziom 1) · Opcjonalne | String | TRT 1 HD | Oficjalna nazwa kanału zarejestrowana w elektronicznym przewodniku programowym. |
tvg-logo | Standardowy (Poziom 1) · Opcjonalne | URL (http/https) | https://stream.example.com:8080/images/trt1.png | Bezpośredni adres URL do grafiki z logo kanału (zalecany format PNG lub SVG przez HTTPS). |
group-title | Standardowy (Poziom 1) · Opcjonalne | String | National | Nazwa kategorii, w której kanał jest umieszczany w interfejsie odtwarzacza. |
#EXTGRP: | Standardowy (Poziom 1) · Opcjonalne | Directive | #EXTGRP:National | Alternatywna dyrektywa grupy umieszczana bezpośrednio po linii EXTINF. |
Poziom 2: Tagi rozszerzone Mayk IP TV
| Pole / Tag | Poziom | Typ | Przykładowa wartość | Opis |
|---|---|---|---|---|
media-type | Rozszerzony (Poziom 2) · Opcjonalne | Enum ("live" | "movie" | "series") | media-type="series" | Jawne nadpisanie typu mediów: 'live', 'movie' lub 'series'. |
series-id | Rozszerzony (Poziom 2) · Opcjonalne | String / Integer | series-id="show-42" | Unikalny identyfikator serialu grupujący strumienie odcinków. |
series-name | Rozszerzony (Poziom 2) · Opcjonalne | String | series-name="Example Series" | Kanoniczny tytuł serialu telewizyjnego do agregacji sezonów i odcinków. |
season | Rozszerzony (Poziom 2) · Opcjonalne | Integer | season="1" | Numer sezonu dla odcinków serialu telewizyjnego (liczba całkowita). |
episode | Rozszerzony (Poziom 2) · Opcjonalne | Integer | episode="4" | Numer odcinka w ramach danego sezonu (liczba całkowita). |
is_adult | Rozszerzony (Poziom 2) · Opcjonalne | Integer ("0" | "1") | is_adult="1" | Wskaźnik blokady rodzicielskiej: '1' oznacza treści dla dorosłych. |
age_rating | Rozszerzony (Poziom 2) · Opcjonalne | String | age_rating="18+" | Oznaczenie minimalnego wieku (np. '18+') dla filtrów rodzicielskich. |
Reguły klasyfikacji treści
| Typ | # | Przykładowa wartość |
|---|---|---|
| Telewizja na żywo | #3 | http(s)://... | media-type="live" |
| Film (VOD) | #2 | /movie/... | media-type="movie" |
| Odcinek serialu | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Przykładowe szablony
#EXTM3U
#EXTINF:-1 tvg-logo="https://stream.example.com:8080/images/movie202.png" group-title="Sinema",Example Movie (2026)
https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
#EXTINF:-1 group-title="Dizi",Example Series - S01E01 - Pilot
https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4
#EXTINF:-1 media-type="series" series-name="Custom Show" season="1" episode="2" group-title="Dizi",Custom Show - S01E02
https://stream.example.com:8080/series/demo_user/demo_pass/30302.mp4
Interaktywny walidator formatu
Wklej poniżej fragment M3U lub odpowiedź JSON Xtream, aby sprawdzić zgodność z Mayk IP TV.
Lista kontrolna zgodności M3U
- Upewnij się, że pierwszy wiersz pliku zawiera dokładnie #EXTM3U.
- Ustaw czas trwania na -1 dla wszystkich kanałów telewizyjnych na żywo.
- Przypisz prawidłowe identyfikatory tvg-id zgodne ze źródłem XMLTV.
- Grupuj kanały logicznie za pomocą atrybutu group-title.
- Zapisuj pliki w kodowaniu UTF-8 bez znacznika kolejności bajtów (BOM).