Articles
Format M3U : comment lire une liste de chaînes
Lisez un exemple M3U commenté, comprenez les champs EXTINF et tvg-id et examinez les adresses sans exposer votre compte avant d’importer une liste.
Publié par InoxTV · Publié le
Dernière mise à jour
Le format M3U est du texte décrivant des entrées multimédias et leur emplacement. Lire un exemple court aide à distinguer un problème de catalogue d’un problème de lecture avant de modifier des réglages. L’exemple ci-dessous est volontairement fictif : son domaine réservé ne diffuse aucune télévision et le copier dans un lecteur ne fournira pas de chaînes fonctionnelles.
Commencer par un petit exemple lisible
#EXTM3U
#EXTINF:-1 tvg-id="demo.news" group-title="Examples",Example News
https://media.example.com/news/index.m3u8
#EXTINF:-1 tvg-id="demo.documentary" group-title="Examples",Example Documentary
https://media.example.com/documentary/index.m3u8
La première ligne annonce un fichier M3U étendu. Chaque entrée comprend ensuite une ligne descriptive suivie d’un emplacement. Ici, les emplacements pointent vers des listes HLS, mais une entrée M3U ne doit pas obligatoirement porter cette extension. L’adresse peut représenter un autre format compatible ou un point d’accès qui renvoie des médias sans nom de fichier évident.
Pour examiner un fichier qui vous appartient ou dont l’usage est autorisé, ouvrez une copie dans un éditeur de texte simple. Évitez les traitements de texte qui modifient les guillemets ou enregistrent une mise en forme enrichie. Conservez l’original pour qu’un essai sur une étiquette ne devienne pas votre unique exemplaire d’une liste fonctionnelle.
Ce que révèlent les champs descriptifs
La ligne EXTINF contient des informations associées à l’entrée suivante. Dans de nombreux catalogues IPTV, une durée de moins un représente une entrée sans durée fixe connue. Le texte après la virgule est le nom affiché. Les attributs précédents relèvent de conventions utilisées par certains lecteurs et fournisseurs ; leur prise en charge varie selon l’application.
| Champ de l’exemple | Rôle | Ce qu’il ne prouve pas |
|---|---|---|
tvg-id="demo.news" | Identifiant associable aux données du guide | L’existence d’une entrée correspondante |
group-title="Examples" | Catégorie proposée pour organiser les entrées | Une interprétation identique par tous les lecteurs |
Example News | Nom de chaîne lisible | La disponibilité ou l’autorisation du flux |
| L’adresse suivante | Emplacement demandé pour la lecture | L’autorisation du compte à y accéder |
L’adresse d’un logo, lorsqu’elle existe, constitue une autre ressource demandée par l’interface. Une image absente ne signifie donc pas nécessairement que la vidéo est défectueuse. Inversement, un logo correctement affiché n’est pas un test de lecture. Distinguer noms, images, identifiants et emplacements vidéo rend vos observations beaucoup plus précises.
Une liste de chaînes peut pointer vers une autre liste
Il est normal que le catalogue principal contienne des adresses dont les réponses sont elles-mêmes des listes. La liste extérieure indique quelle chaîne le spectateur sélectionne. Un manifeste HLS peut ensuite décrire les variantes ou la succession de petits segments nécessaires à sa diffusion. Il s’agit de niveaux différents, même lorsqu’ils utilisent une syntaxe apparentée.
Le suffixe M3U8 ne suffit donc pas à savoir si une adresse convient à un importateur de catalogue ou à un lecteur multimédia. La comparaison entre M3U et HLS présente les balises distinctives. Suivez les instructions de votre source autorisée plutôt que de changer les extensions jusqu’à ce que l’importateur accepte un fichier.
Vérifier les identifiants lorsque le guide manque
Dans l’exemple fictif, demo.news peut correspondre à une chaîne déclarée dans un guide XMLTV. Les programmes renvoient à cet identifiant de chaîne. Si la source utilise demo.news.hd, des noms affichés similaires ne garantissent pas une correspondance. Le comportement exact dépend de l’application et des conventions de la source.
Avant de modifier des identifiants, comparez le catalogue et le guide prévus pour fonctionner ensemble. Un flux régional peut porter un identifiant différent d’un flux national au nom similaire. Remplacer largement les noms dans un gros fichier peut créer de mauvaises associations. Commencez par un exemple bien compris et consultez le fonctionnement des correspondances XMLTV avant de modifier toute la liste.
Examiner la structure sans exposer un compte
Une adresse peut contenir des identifiants dans son chemin comme après le point d’interrogation. Masquer seulement un paramètre nommé password ne suffit pas. Un jeton, un numéro de compte ou une signature peuvent apparaître ailleurs. Pour préparer un exemple destiné au support, remplacez l’emplacement complet par une adresse réservée et décrivez séparément la réponse ou l’erreur.
N’envoyez pas une liste privée à un formateur ou validateur en ligne simplement pour profiter d’un aperçu pratique. Un catalogue téléchargé peut exposer toutes les adresses associées au compte. Gardez vos sauvegardes dans un stockage contrôlé et vérifiez qui accède aux dossiers synchronisés. Le guide de confidentialité des listes propose des vérifications concrètes avant tout partage.
Comprendre ce qu’une modification peut réparer
Une copie en texte brut peut révéler une adresse incomplète, un retour à la ligne accidentel ou une page HTML de connexion enregistrée avec une extension M3U. Ce sont des constatations utiles. Toutefois, un fichier plausible peut pointer vers des médias indisponibles. Changer un groupe, un identifiant ou une extension ne renouvelle pas un compte et ne contourne pas une restriction du serveur.
Si le catalogue charge mais qu’une entrée échoue, notez si les autres fonctionnent et si le problème suit le même flux autorisé dans une autre installation compatible. Si le catalogue ne s’importe pas, conservez la réponse originale et consultez le guide des problèmes de chargement. Une fois la structure comprise, le guide M3U d’InoxTV fournit les étapes concrètes d’importation.
