Mayk IP TV

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ňTypPříklad hodnotyPopis
#EXTM3UStandardní (Úroveň 1) · PovinnéDirective (Header)#EXTM3UPovinný hlavičkový řádek identifikující soubor jako rozšířený playlist M3U.
#EXTINFStandardní (Úroveň 1) · PovinnéDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDDirektiva informací o stopě určující délku streamu a atributy metadat.
tvg-idStandardní (Úroveň 1) · VolitelnéStringtrt1.trJedinečný identifikátor spojující kanál s daty programu v souboru XMLTV EPG.
tvg-nameStandardní (Úroveň 1) · VolitelnéStringTRT 1 HDOficiální název stanice evidovaný v elektronickém programovém průvodci.
tvg-logoStandardní (Úroveň 1) · VolitelnéURL (http/https)https://stream.example.com:8080/images/trt1.pngPřímá internetová adresa obrázku s logem stanice (nejlépe PNG nebo SVG přes HTTPS).
group-titleStandardní (Úroveň 1) · VolitelnéStringNationalNázev tematické skupiny nebo kategorie, do které je kanál zařazen v nabídce.
#EXTGRP:Standardní (Úroveň 1) · VolitelnéDirective#EXTGRP:NationalAlternativní direktiva skupiny umístěná bezprostředně za řádkem EXTINF.

Úroveň 2: Rozšířené tagy Mayk IP TV

Pole / TagÚroveňTypPříklad hodnotyPopis
media-typeRozšířené (Úroveň 2) · VolitelnéEnum ("live" | "movie" | "series")media-type="series"Explicitní přepsání typu média: 'live', 'movie' nebo 'series'.
series-idRozšířené (Úroveň 2) · VolitelnéString / Integerseries-id="show-42"Jedinečný identifikátor seriálu sdružující streamy jednotlivých epizod.
series-nameRozšířené (Úroveň 2) · VolitelnéStringseries-name="Example Series"Kanonický název televizního seriálu pro seskupení řad a dílů.
seasonRozšířené (Úroveň 2) · VolitelnéIntegerseason="1"Číslo řady pro epizody televizního seriálu (celé číslo).
episodeRozšířené (Úroveň 2) · VolitelnéIntegerepisode="4"Číslo epizody v rámci dané řady (celé číslo).
is_adultRozšíř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_ratingRozšířené (Úroveň 2) · VolitelnéStringage_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í#3http(s)://... | media-type="live"
Film (VOD)#2/movie/... | media-type="movie"
Epizoda seriálu#1/series/... + S01E01 / S01.E01 | media-type="series"

Vzorové šablony

Živé vysílání (M3U / #EXTINF)
#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
Film (VOD) & Epizoda seriálu (M3U / #EXTINF)
#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).