#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
Technická dokumentace
Specifikace formátu playlistu M3U
Kompletní specifikace formátu playlistu M3U pro IPTV. Naučte se tagy Úrovně 1 a 2, parsování kanálů a validujte playlisty interaktivně.
Úvod do formátu M3U v aplikaci Mayk IP TV
Formát playlistu M3U představuje celosvětový standard pro seznamy kanálů IPTV. Mayk IP TV spolehlivě zpracovává tradiční soubory M3U i moderní soubory M3U8 s rozšířenými metadaty.
Struktura a syntaxe playlistu
Platný soubor M3U začíná vždy deklaračním řádkem #EXTM3U, po němž následují dvojice řádků metadat #EXTINF a přímých odkazů na stream.
Klasifikace filmů a seriálů
Přehrávač automaticky rozlišuje živé televizní kanály, filmy a jednotlivé epizody seriálů na základě označení řad a dílů, například S01 E02.
Doporučené postupy při parsování
Vždy používejte čisté kódování UTF-8, přímé odkazy na streamy přes HTTP/HTTPS a jedinečné hodnoty tvg-id pro bezchybný televizní program (EPG).
Úroveň 1: Standardní tagy #EXTINF
| Pole / Tag | Úroveň | Typ | Příklad hodnoty | Popis |
|---|---|---|---|---|
#EXTM3U | Standardní (Úroveň 1) · Povinné | Directive (Header) | #EXTM3U | Povinný hlavičkový řádek identifikující soubor jako rozšířený playlist M3U. |
#EXTINF | Standardní (Úroveň 1) · Povinné | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Direktiva informací o stopě určující délku streamu a atributy metadat. |
tvg-id | Standardní (Úroveň 1) · Volitelné | String | trt1.tr | Jedinečný identifikátor spojující kanál s daty programu v souboru XMLTV EPG. |
tvg-name | Standardní (Úroveň 1) · Volitelné | String | TRT 1 HD | Oficiální název stanice evidovaný v elektronickém programovém průvodci. |
tvg-logo | Standardní (Úroveň 1) · Volitelné | URL (http/https) | https://stream.example.com:8080/images/trt1.png | Přímá internetová adresa obrázku s logem stanice (nejlépe PNG nebo SVG přes HTTPS). |
group-title | Standardní (Úroveň 1) · Volitelné | String | National | Název tematické skupiny nebo kategorie, do které je kanál zařazen v nabídce. |
#EXTGRP: | Standardní (Úroveň 1) · Volitelné | Directive | #EXTGRP:National | Alternativní direktiva skupiny umístěná bezprostředně za řádkem EXTINF. |
Úroveň 2: Rozšířené tagy Mayk IP TV
| Pole / Tag | Úroveň | Typ | Příklad hodnoty | Popis |
|---|---|---|---|---|
media-type | Rozšířené (Úroveň 2) · Volitelné | Enum ("live" | "movie" | "series") | media-type="series" | Explicitní přepsání typu média: 'live', 'movie' nebo 'series'. |
series-id | Rozšířené (Úroveň 2) · Volitelné | String / Integer | series-id="show-42" | Jedinečný identifikátor seriálu sdružující streamy jednotlivých epizod. |
series-name | Rozšířené (Úroveň 2) · Volitelné | String | series-name="Example Series" | Kanonický název televizního seriálu pro seskupení řad a dílů. |
season | Rozšířené (Úroveň 2) · Volitelné | Integer | season="1" | Číslo řady pro epizody televizního seriálu (celé číslo). |
episode | Rozšířené (Úroveň 2) · Volitelné | Integer | episode="4" | Číslo epizody v rámci dané řady (celé číslo). |
is_adult | Rozšířené (Úroveň 2) · Volitelné | Integer ("0" | "1") | is_adult="1" | Příznak rodičovského zámku: '1' označuje obsah pro dospělé. |
age_rating | Rozšířené (Úroveň 2) · Volitelné | String | age_rating="18+" | Minimální věková hranice (např. '18+') pro filtry rodičovské kontroly. |
Pravidla klasifikace obsahu
| Typ | # | Příklad hodnoty |
|---|---|---|
| Živé vysílání | #3 | http(s)://... | media-type="live" |
| Film (VOD) | #2 | /movie/... | media-type="movie" |
| Epizoda seriálu | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Vzorové šablony
#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
Interaktivní kontrola formátu
Vložte níže úryvek M3U nebo odpověď JSON Xtream pro ověření kompatibility s Mayk IP TV.
Kontrolní seznam kompatibility M3U
- Zkontrolujte, zda první řádek souboru obsahuje přesně text #EXTM3U.
- Nastavte hodnotu trvání na -1 pro všechny nepřetržité živé televizní stanice.
- Přiřaďte správné hodnoty tvg-id odpovídající vašemu zdroji dat XMLTV.
- Přehledně třiďte stanice pomocí atributu group-title.
- Ukládejte soubory v kódování UTF-8 bez identifikační značky pořadí bajtů (BOM).