#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á dokumentácia
Špecifikácia formátu playlistu M3U
Kompletná špecifikácia formátu playlistu M3U pre IPTV. Naučte sa tagy Úrovne 1 a 2, parsovanie kanálov a validujte playlisty interaktívne.
Úvod do formátu M3U v aplikácii Mayk IP TV
Formát playlistu M3U slúži ako univerzálny štandard pre zoznamy staníc IPTV. Mayk IP TV spoľahlivo podporuje tradičné súbory M3U aj moderné zoznamy M3U8 s bohatými metadátami.
Štruktúra a syntax playlistu
Platný súbor M3U začína vždy deklaráciou #EXTM3U, za ktorou nasledujú usporiadané dvojice riadkov metadát #EXTINF a priamych adries URL streamov.
Klasifikácia filmov a seriálov
Multimediálny obsah sa automaticky zatrieďuje medzi živé vysielanie, filmy a epizódy seriálov na základe vzorov sérií, ako je napríklad S01 E02.
Osvedčené postupy pri spracovaní
Vždy dbajte na čisté kódovanie UTF-8, funkčné internetové adresy HTTP/HTTPS a jedinečné hodnoty tvg-id pre bezchybný televízny program (EPG).
Úroveň 1: Štandardné tagy #EXTINF
| Pole / Tag | Úroveň | Typ | Príklad hodnoty | Popis |
|---|---|---|---|---|
#EXTM3U | Štandardné (Úroveň 1) · Povinné | Directive (Header) | #EXTM3U | Povinný hlavičkový riadok označujúci súbor ako rozšírený playlist M3U. |
#EXTINF | Štandardné (Úroveň 1) · Povinné | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Direktíva informácií o stope určujúca dĺžku streamu a atribúty metadát. |
tvg-id | Štandardné (Úroveň 1) · Voliteľné | String | trt1.tr | Jedinečný kód prepájajúci kanál s príslušným záznamom v súbore XMLTV EPG. |
tvg-name | Štandardné (Úroveň 1) · Voliteľné | String | TRT 1 HD | Oficiálny názov televíznej stanice evidovaný v elektronickom programovom sprievodcovi. |
tvg-logo | Štandardné (Úroveň 1) · Voliteľné | URL (http/https) | https://stream.example.com:8080/images/trt1.png | Priamy odkaz na obrázok s logom stanice (odporúča sa formát PNG alebo SVG cez HTTPS). |
group-title | Štandardné (Úroveň 1) · Voliteľné | String | National | Názov kategórie, do ktorej je kanál zaradený v rozhraní prehrávača. |
#EXTGRP: | Štandardné (Úroveň 1) · Voliteľné | Directive | #EXTGRP:National | Alternatívna direktíva skupiny umiestnená hneď za riadkom EXTINF. |
Úroveň 2: Rozšírené tagy Mayk IP TV
| Pole / Tag | Úroveň | Typ | Príklad hodnoty | Popis |
|---|---|---|---|---|
media-type | Rozšírené (Úroveň 2) · Voliteľné | Enum ("live" | "movie" | "series") | media-type="series" | Explicitné prepísanie typu média: 'live', 'movie' alebo 'series'. |
series-id | Rozšírené (Úroveň 2) · Voliteľné | String / Integer | series-id="show-42" | Jedinečný identifikátor seriálu združujúci streamy epizód. |
series-name | Rozšírené (Úroveň 2) · Voliteľné | String | series-name="Example Series" | Kanonický názov televízneho seriálu na zoskupenie sérií a častí. |
season | Rozšírené (Úroveň 2) · Voliteľné | Integer | season="1" | Číslo série pre epizódy televízneho seriálu (celé číslo). |
episode | Rozšírené (Úroveň 2) · Voliteľné | Integer | episode="4" | Číslo epizódy v rámci danej série (celé číslo). |
is_adult | Rozšírené (Úroveň 2) · Voliteľné | Integer ("0" | "1") | is_adult="1" | Príznak rodičovského zámku: '1' označuje obsah pre dospelých. |
age_rating | Rozšírené (Úroveň 2) · Voliteľné | String | age_rating="18+" | Minimálna veková hranica (napr. '18+') pre filtre rodičovskej kontroly. |
Pravidlá klasifikácie obsahu
| Typ | # | Príklad hodnoty |
|---|---|---|
| Živé vysielanie | #3 | http(s)://... | media-type="live" |
| Film (VOD) | #2 | /movie/... | media-type="movie" |
| Epizóda seriálu | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Vzorové šablóny
#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
Interaktívna kontrola formátu
Vložte nižšie úryvok M3U alebo odpoveď JSON Xtream na overenie kompatibility s Mayk IP TV.
Kontrolný zoznam kompatibility M3U
- Uistite sa, že úplne prvý riadok súboru obsahuje presne #EXTM3U.
- Pre všetky nepretržité živé stanice nastavte dĺžku trvania na -1.
- Priraďte správne hodnoty tvg-id zodpovedajúce vášmu zdroju XMLTV.
- Stanice logicky zoskupujte pomocou atribútu group-title.
- Súbory ukladajte v čistom kódovaní UTF-8 bez značky poradia bajtov (BOM).