#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
Specifiche tecniche e standard
Specifiche playlist M3U e tag #EXTINF
Scopri come Mayk IP TV elabora playlist M3U e M3U Plus, associa i metadati dei canali e classifica automaticamente i contenuti.
Intestazione del file e codifica
Una playlist M3U deve iniziare obbligatoriamente con #EXTM3U nella prima riga. I file devono essere codificati in UTF-8 con terminatori di riga LF o CRLF. Gli indirizzi devono essere URL assoluti HTTP o HTTPS.
Livello 1 Tag #EXTINF standard
I metadati sono specificati sulla riga #EXTINF mediante attributi racchiusi tra virgolette. tvg-id associa l'EPG, tvg-name fornisce il nome di riserva, tvg-logo il logo e group-title la categoria.
Classificazione automatica dei contenuti
Mayk IP TV riconosce come film (VOD) gli URL contenenti /movie/ e come episodi di serie tv quelli con /series/ e schemi come S01E01 o S01.E01. Tutti gli altri flussi sono considerati TV in diretta.
Livello 2 Tag estesi
I creatori di playlist possono utilizzare media-type="live|movie|series", series-name, season ed episode per impostare esplicitamente il tipo di contenuto senza dipendere dalla struttura dell'URL.
Dimensioni del catalogo e prestazioni
File M3U non compressi superiori a 40 MB appesantiscono la memoria delle Smart TV. È consigliabile attivare la compressione HTTP gzip o utilizzare l'API Xtream Codes.
Livello 1: Tag #EXTINF standard
| Campo / Tag | Livello | Tipo | Valore di esempio | Descrizione |
|---|---|---|---|---|
#EXTM3U | Standard (Livello 1) · Obbligatorio | Directive (Header) | #EXTM3U | Intestazione del file; deve essere la primissima riga di ogni playlist M3U valida. |
#EXTINF | Standard (Livello 1) · Obbligatorio | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Direttiva principale che specifica la durata del flusso e i relativi metadati. |
tvg-id | Standard (Livello 1) · Opzionale | String | trt1.tr | Identificativo di canale per l'abbinamento con la guida elettronica EPG. |
tvg-name | Standard (Livello 1) · Opzionale | String | TRT 1 HD | Nome canale alternativo per la ricerca nella guida elettronica. |
tvg-logo | Standard (Livello 1) · Opzionale | URL (http/https) | https://stream.example.com:8080/images/trt1.png | URL diretto HTTP o HTTPS che punta all'immagine del logo o alla copertina. |
group-title | Standard (Livello 1) · Opzionale | String | National | Nome della categoria o del gruppo a cui appartiene il canale. |
#EXTGRP: | Standard (Livello 1) · Opzionale | Directive | #EXTGRP:National | Direttiva alternativa di gruppo collocata subito dopo la riga EXTINF. |
Livello 2: Tag estesi Mayk IP TV
| Campo / Tag | Livello | Tipo | Valore di esempio | Descrizione |
|---|---|---|---|---|
media-type | Esteso (Livello 2) · Opzionale | Enum ("live" | "movie" | "series") | media-type="series" | Override esplicito del tipo di media: 'live', 'movie' o 'series'. |
series-id | Esteso (Livello 2) · Opzionale | String / Integer | series-id="show-42" | Identificativo univoco che raggruppa più episodi sotto una stessa serie. |
series-name | Esteso (Livello 2) · Opzionale | String | series-name="Example Series" | Titolo standard della serie tv per associare stagioni ed episodi. |
season | Esteso (Livello 2) · Opzionale | Integer | season="1" | Numero della stagione a cui appartiene l'episodio (numero intero). |
episode | Esteso (Livello 2) · Opzionale | Integer | episode="4" | Numero progressivo dell'episodio all'interno della stagione (numero intero). |
is_adult | Esteso (Livello 2) · Opzionale | Integer ("0" | "1") | is_adult="1" | Segnalatore per il controllo genitori: '1' indica contenuti per adulti. |
age_rating | Esteso (Livello 2) · Opzionale | String | age_rating="18+" | Fascia d'età minima raccomandata (es. '18+') per i filtri di protezione. |
Regole di classificazione
| Tipo | # | Valore di esempio |
|---|---|---|
| TV in diretta | #3 | http(s)://... | media-type="live" |
| Film (VOD) | #2 | /movie/... | media-type="movie" |
| Episodio serie | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Modelli di esempio
#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
Verificatore di formato interattivo
Incolla il testo M3U o la risposta JSON Xtream qui sotto per verificare la compatibilità con Mayk IP TV.
Elenco di controllo compatibilità M3U
- Verifica che la prima riga sia #EXTM3U e la codifica sia UTF-8.
- Racchiudi sempre i valori degli attributi tra virgolette doppie.
- Struttura i film con /movie/ e le serie con /series/ e il pattern SxxEyy.
- Usa URL diretti e validi in HTTP/HTTPS per tutti i loghi.
- Evita righe separatore decorative e usa l'attributo group-title.