tvg-id, group-title et tvg-logo dans une playlist M3U

Les champs M3U tvg-id, group-title et tvg-logo décrivent une chaîne, mais ils ont des fonctions différentes. tvg-id peut aider à associer une entrée aux données de programme, group-title indique une catégorie et tvg-logo pointe vers une image. Ce sont des métadonnées à côté de l’adresse du flux : elles ne créent pas une chaîne et ne garantissent pas que tous les lecteurs IPTV afficheront un guide ou un logo.

Une entrée M3U classique comporte une ligne #EXTINF, suivie de l’adresse du flux. L’ordre des attributs peut varier. Cet exemple fictif montre uniquement la structure :

#EXTINF:-1 tvg-id="actualites-exemple" group-title="Actualités" tvg-logo="https://example.invalid/logo.png",Actualités Exemple
https://example.invalid/flux

Où se trouvent ces champs

Dans une playlist M3U courante, chaque élément comprend une ligne #EXTINF avec des informations sur l’entrée, puis une autre ligne avec l’adresse de la source. La partie avant la virgule peut contenir des attributs ; le texte après la virgule correspond au nom affiché dans la playlist. Le format exact dépend de la façon dont le fournisseur a créé le fichier.

Séparez trois éléments : le nom de la chaîne, ses métadonnées et l’adresse du flux. Le nom permet de reconnaître l’entrée. Les attributs ajoutent des indications. L’URL désigne la source de lecture. Modifier l’un de ces éléments ne corrige pas automatiquement les autres.

tvg-id : un identifiant lié aux données de programme

tvg-id est une chaîne de caractères attribuée à une entrée de playlist. Elle sert souvent à associer une chaîne à une entrée d’un guide XMLTV. Le flux XMLTV peut lui aussi identifier les chaînes à l’aide de ses propres ID. Plus l’identifiant de la playlist correspond à celui du guide, plus un système peut facilement rattacher le programme à la bonne chaîne.

Il ne suffit pas que les deux identifiants se ressemblent. Les données fournies doivent réellement correspondre. Des variantes régionales, différentes versions d’une chaîne ou un changement du côté du fournisseur peuvent empêcher l’association même si la lecture fonctionne. À l’inverse, l’absence de tvg-id ne signifie pas automatiquement qu’une chaîne ne peut pas être lue : cela dépend du lecteur et des autres méthodes de correspondance disponibles.

Si une chaîne fonctionne, mais que son guide est vide ou affiche le programme d’une autre station, séparez le diagnostic de lecture de celui de l’EPG. Le résultat dépend de la playlist, du flux de guide et du lecteur.

group-title : la catégorie de la chaîne

group-title indique le groupe auquel le fournisseur a affecté une entrée, par exemple « Sport », « Actualités » ou « Documentaires ». Il s’agit d’une catégorie dans la playlist, pas d’une source distincte ni d’une partie de l’URL du flux. Les groupes peuvent rendre une longue liste plus facile à parcourir.

Le fournisseur choisit ces intitulés. Ils peuvent être abrégés, écrits dans une autre langue ou formulés différemment pour des catégories proches. Une catégorie vide ou inattendue peut donc venir des métadonnées de la playlist et non d’un problème de lecture. Ne changez pas l’URL du flux simplement parce que le nom du groupe vous paraît étrange.

tvg-logo : l’adresse de l’image de la chaîne

tvg-logo indique l’URL d’une image associée à l’entrée. Il s’agit d’une référence vers une image, pas de l’image elle-même. Si l’adresse est ancienne, inaccessible ou mal formée, le logo peut ne pas apparaître même lorsque la chaîne fonctionne. Les lecteurs ne gèrent pas tous les images manquantes ou invalides de la même façon.

Un logo ne détermine pas la disponibilité du flux et ne fournit pas les données de programme. Si l’image manque alors que la lecture fonctionne, vérifiez d’abord si le fournisseur donne toujours une URL actuelle. Ne confondez pas l’absence de logo avec une chaîne en panne.

Résumé rapide

Champ

À quoi il sert

Ce qu’il ne garantit pas

tvg-id

Identifie une chaîne pour associer les données de programme

Que chaque flux XMLTV correspondra

group-title

Nomme une catégorie de la playlist

Que la chaîne sera lue correctement

tvg-logo

Donne l’adresse de l’image d’une chaîne

Que l’image est disponible ou valide

Cette distinction aide à cibler un problème. Si la chaîne fonctionne mais pas le guide, vérifiez les données et leur correspondance plutôt que de modifier le flux. DaddyTV accepte les sources M3U et un guide XMLTV facultatif ; le traitement exact des métadonnées dépend toutefois de la playlist, du flux EPG et du lecteur.

Examiner une entrée M3U sans exposer ses accès

Si le fournisseur vous remet un fichier, ouvrez-le localement dans un éditeur de texte de confiance. Ne collez pas la playlist complète dans un analyseur public en ligne : ses URL peuvent contenir des données d’accès. Pour comparer les champs, quelques lignes #EXTINF suffisent, sans communiquer la véritable adresse du flux.

Vérifiez la présence de tvg-id, la valeur de group-title et l’apparence complète de l’URL tvg-logo. Comparez ensuite l’identifiant avec la documentation ou un exemple XMLTV du fournisseur. Ne modifiez pas les valeurs de toute la playlist sans savoir comment le lecteur les utilise. Gardez une copie originale et demandez au fournisseur des métadonnées correctes si certaines manquent.

Trois confusions fréquentes

Premièrement, tvg-id n’est pas une adresse de chaîne mais un identifiant. Deuxièmement, group-title ne crée pas de programme TV : il nomme une catégorie mais ne contient aucun horaire. Troisièmement, tvg-logo n’est pas un fichier image obligatoire. Son URL peut être obsolète ou inaccessible. Dans les trois cas, le flux peut fonctionner normalement alors que les métadonnées sont incomplètes.

Vérifiez donc chaque couche séparément : la chaîne, son groupe, son image et le guide. tvg-id identifie la chaîne, group-title indique sa catégorie et tvg-logo donne une adresse d’image. Aucun de ces champs ne remplace l’URL du flux ni un flux XMLTV complet. Si l’image est visible mais que le guide manque, concentrez-vous sur la correspondance du guide ; si la chaîne ne se lance pas, examinez sa source séparément.

Pour configurer une source, consultez la page du lecteur M3U ; pour un guide séparé, voyez la page du lecteur XMLTV EPG.

Pour découvrir les appareils compatibles, consultez la page Plateformes.