#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
Spécifications techniques et normes
Normes de liste de lecture M3U et #EXTINF
Découvrez comment Mayk IP TV analyse les listes M3U et M3U Plus, associe les métadonnées et classe automatiquement les flux.
En-tête de fichier et encodage
Tout fichier de liste de lecture M3U doit débuter par #EXTM3U sur la toute première ligne. L'encodage UTF-8 est requis avec sauts LF ou CRLF. Les adresses des flux doivent être des URL absolues HTTP ou HTTPS.
Niveau 1 Balises #EXTINF standard
Les métadonnées sont définies sur la ligne #EXTINF par des paires clé-valeur entre guillemets. tvg-id permet la correspondance EPG, tvg-name le nom de repli, tvg-logo l'icône et group-title la catégorie.
Classification automatique des médias
Mayk IP TV classe les URL contenant /movie/ comme films (VOD), et celles contenant /series/ avec S01E01 ou S01.E01 comme épisodes de série. Tous les autres flux sont traités comme TV en direct.
Niveau 2 Balises étendues
Les générateurs personnalisés peuvent fournir media-type="live|movie|series", series-name, season et episode pour spécifier explicitement le type sans dépendre de la structure d'URL.
Taille du catalogue et performances
Les playlists non compressées dépassant 40 Mo sollicitent la mémoire des Smart TV. Il est recommandé d'activer la compression HTTP gzip ou d'utiliser l'API Xtream Codes.
Niveau 1 : Balises #EXTINF standard
| Champ / Balise | Niveau | Type | Exemple | Description |
|---|---|---|---|---|
#EXTM3U | Standard (Niveau 1) · Requis | Directive (Header) | #EXTM3U | En-tête de la liste de lecture ; requis en ouverture de tout document M3U conforme. |
#EXTINF | Standard (Niveau 1) · Requis | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Directive principale indiquant la durée du flux et les métadonnées associées. |
tvg-id | Standard (Niveau 1) · Optionnel | String | trt1.tr | Identifiant de chaîne EPG utilisé pour la grille de programmes électroniques. |
tvg-name | Standard (Niveau 1) · Optionnel | String | TRT 1 HD | Nom de chaîne utilisé comme solution de repli pour le guide des programmes. |
tvg-logo | Standard (Niveau 1) · Optionnel | URL (http/https) | https://stream.example.com:8080/images/trt1.png | URL directe HTTP ou HTTPS menant au logo de la chaîne ou à l'affiche. |
group-title | Standard (Niveau 1) · Optionnel | String | National | Nom de catégorie utilisé pour regrouper les chaînes par thématique. |
#EXTGRP: | Standard (Niveau 1) · Optionnel | Directive | #EXTGRP:National | Directive alternative de groupe placée directement après la ligne EXTINF. |
Niveau 2 : Balises étendues Mayk IP TV
| Champ / Balise | Niveau | Type | Exemple | Description |
|---|---|---|---|---|
media-type | Étendu (Niveau 2) · Optionnel | Enum ("live" | "movie" | "series") | media-type="series" | Substitution explicite du type de média : 'live', 'movie' ou 'series'. |
series-id | Étendu (Niveau 2) · Optionnel | String / Integer | series-id="show-42" | Identifiant unique regroupant plusieurs épisodes sous une même série. |
series-name | Étendu (Niveau 2) · Optionnel | String | series-name="Example Series" | Titre canonique de la série télévisée pour regrouper les saisons. |
season | Étendu (Niveau 2) · Optionnel | Integer | season="1" | Numéro de saison de l'épisode de série (nombre entier). |
episode | Étendu (Niveau 2) · Optionnel | Integer | episode="4" | Numéro de l'épisode au sein de la saison (nombre entier). |
is_adult | Étendu (Niveau 2) · Optionnel | Integer ("0" | "1") | is_adult="1" | Indicateur de verrouillage parental : '1' signale un contenu réservé aux adultes. |
age_rating | Étendu (Niveau 2) · Optionnel | String | age_rating="18+" | Indication d'âge minimum (ex. '18+') pour le contrôle parental. |
Règles de classification
| Type | # | Exemple |
|---|---|---|
| TV en direct | #3 | http(s)://... | media-type="live" |
| Film (VOD) | #2 | /movie/... | media-type="movie" |
| Épisode de série | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Modèles d'exemple
#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
Vérificateur de format interactif
Collez votre extrait M3U ou réponse JSON Xtream ci-dessous pour vérifier sa conformité avec Mayk IP TV.
Liste de contrôle de compatibilité M3U
- Vérifiez que #EXTM3U est sur la première ligne avec un encodage UTF-8.
- Entourez toujours les valeurs d'attributs de guillemets doubles.
- Structurez les films avec /movie/ et les séries avec /series/ et SxxEyy.
- Fournissez des URL HTTP/HTTPS valides et directes pour les logos.
- Évitez les séparateurs décoratifs et utilisez l'attribut group-title.