Mayk IP TV

Spécifications techniques et normes

Spécification de playlist 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

Une playlist M3U doit débuter par la directive #EXTM3U sur la première ligne. Les fichiers doivent être encodés en UTF-8 avec des fins de ligne LF ou CRLF. Les URL de flux doivent être absolues en 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 / BaliseNiveauTypeExempleDescription
#EXTM3UStandard (Niveau 1) · RequisDirective (Header)#EXTM3UEn-tête de playlist ; doit être la toute première ligne de tout fichier M3U valide.
#EXTINFStandard (Niveau 1) · RequisDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDDirective principale indiquant la durée du flux et les métadonnées associées.
tvg-idStandard (Niveau 1) · OptionnelStringtrt1.trIdentifiant de chaîne EPG utilisé pour la grille de programmes électroniques.
tvg-nameStandard (Niveau 1) · OptionnelStringTRT 1 HDNom de chaîne utilisé comme solution de repli pour le guide des programmes.
tvg-logoStandard (Niveau 1) · OptionnelURL (http/https)https://stream.example.com:8080/images/trt1.pngURL directe HTTP ou HTTPS menant au logo de la chaîne ou à l'affiche.
group-titleStandard (Niveau 1) · OptionnelStringNationalNom de catégorie utilisé pour regrouper les chaînes par thématique.
#EXTGRP:Standard (Niveau 1) · OptionnelDirective#EXTGRP:NationalDirective alternative de groupe placée directement après la ligne EXTINF.

Niveau 2 : Balises étendues Mayk IP TV

Champ / BaliseNiveauTypeExempleDescription
media-typeÉtendu (Niveau 2) · OptionnelEnum ("live" | "movie" | "series")media-type="series"Substitution explicite du type de média : 'live', 'movie' ou 'series'.
series-idÉtendu (Niveau 2) · OptionnelString / Integerseries-id="show-42"Identifiant unique regroupant plusieurs épisodes sous une même série.
series-nameÉtendu (Niveau 2) · OptionnelStringseries-name="Example Series"Titre canonique de la série télévisée pour regrouper les saisons.
seasonÉtendu (Niveau 2) · OptionnelIntegerseason="1"Numéro de saison de l'épisode de série (nombre entier).
episodeÉtendu (Niveau 2) · OptionnelIntegerepisode="4"Numéro de l'épisode au sein de la saison (nombre entier).
is_adultÉtendu (Niveau 2) · OptionnelInteger ("0" | "1")is_adult="1"Indicateur de verrouillage parental : '1' signale un contenu réservé aux adultes.
age_ratingÉtendu (Niveau 2) · OptionnelStringage_rating="18+"Indication d'âge minimum (ex. '18+') pour le contrôle parental.

Règles de classification

Type#Exemple
TV en direct#3http(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

TV en direct (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) & Épisode de série (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

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.