Mayk IP TV

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 / TagPoziomTypPrzykładowa wartośćOpis
#EXTM3UStandardowy (Poziom 1) · WymaganeDirective (Header)#EXTM3UWymagana linia nagłówka identyfikująca plik jako rozszerzoną playlistę M3U.
#EXTINFStandardowy (Poziom 1) · WymaganeDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDDyrektywa informacji o ścieżce określająca czas trwania i atrybuty metadanych.
tvg-idStandardowy (Poziom 1) · OpcjonalneStringtrt1.trUnikalny identyfikator wiążący kanał z danymi przewodnika XMLTV EPG.
tvg-nameStandardowy (Poziom 1) · OpcjonalneStringTRT 1 HDOficjalna nazwa kanału zarejestrowana w elektronicznym przewodniku programowym.
tvg-logoStandardowy (Poziom 1) · OpcjonalneURL (http/https)https://stream.example.com:8080/images/trt1.pngBezpośredni adres URL do grafiki z logo kanału (zalecany format PNG lub SVG przez HTTPS).
group-titleStandardowy (Poziom 1) · OpcjonalneStringNationalNazwa kategorii, w której kanał jest umieszczany w interfejsie odtwarzacza.
#EXTGRP:Standardowy (Poziom 1) · OpcjonalneDirective#EXTGRP:NationalAlternatywna dyrektywa grupy umieszczana bezpośrednio po linii EXTINF.

Poziom 2: Tagi rozszerzone Mayk IP TV

Pole / TagPoziomTypPrzykładowa wartośćOpis
media-typeRozszerzony (Poziom 2) · OpcjonalneEnum ("live" | "movie" | "series")media-type="series"Jawne nadpisanie typu mediów: 'live', 'movie' lub 'series'.
series-idRozszerzony (Poziom 2) · OpcjonalneString / Integerseries-id="show-42"Unikalny identyfikator serialu grupujący strumienie odcinków.
series-nameRozszerzony (Poziom 2) · OpcjonalneStringseries-name="Example Series"Kanoniczny tytuł serialu telewizyjnego do agregacji sezonów i odcinków.
seasonRozszerzony (Poziom 2) · OpcjonalneIntegerseason="1"Numer sezonu dla odcinków serialu telewizyjnego (liczba całkowita).
episodeRozszerzony (Poziom 2) · OpcjonalneIntegerepisode="4"Numer odcinka w ramach danego sezonu (liczba całkowita).
is_adultRozszerzony (Poziom 2) · OpcjonalneInteger ("0" | "1")is_adult="1"Wskaźnik blokady rodzicielskiej: '1' oznacza treści dla dorosłych.
age_ratingRozszerzony (Poziom 2) · OpcjonalneStringage_rating="18+"Oznaczenie minimalnego wieku (np. '18+') dla filtrów rodzicielskich.

Reguły klasyfikacji treści

Typ#Przykładowa wartość
Telewizja na żywo#3http(s)://... | media-type="live"
Film (VOD)#2/movie/... | media-type="movie"
Odcinek serialu#1/series/... + S01E01 / S01.E01 | media-type="series"

Przykładowe szablony

Telewizja na żywo (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) & Odcinek serialu (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

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).