Un fichier M3U est une playlist en texte brut : une liste d'entrées, chacune avec un nom et l'adresse d'un flux. En IPTV, une playlist M3U recense les chaînes en direct — parfois aussi des films et des séries — avec leur logo, leur catégorie et l'identifiant utilisé par le guide TV. Le M3U8, c'est le même format enregistré en UTF-8, qui préserve les accents et les écritures non latines ; c'est aussi l'extension des flux HLS. Ce guide explique à quoi ressemble un fichier M3U, ce qui distingue M3U et M3U8, ce qu'est un lien M3U, et comment Klyvo Play le prend en charge.
Klyvo Play est un lecteur. Il ne fournit aucune chaîne, aucun film ni aucune série : vous y connectez le service que vous avez déjà et que vous êtes autorisé à utiliser, avec ses identifiants Xtream ou son lien M3U.
Qu'est-ce qu'un fichier M3U ?
Le format est né pour la musique : les premiers lecteurs multimédias utilisaient des fichiers .m3u pour mémoriser une liste de morceaux. Chaque ligne était le chemin d'un fichier à lire, l'un après l'autre. L'IPTV a gardé l'idée en remplaçant les chemins par des adresses internet. Une playlist reste du simple texte — on peut l'ouvrir dans n'importe quel éditeur — mais un seul fichier peut décrire des milliers de chaînes.
Grâce à cette simplicité, le format M3U est lu par presque toutes les applications multimédias. C'est aussi sa limite : il dit quoi lire, et guère plus.
Dans une playlist M3U : #EXTM3U et #EXTINF
Une playlist IPTV utilise le format M3U étendu. Elle commence par une ligne d'en-tête, puis répète deux lignes par chaîne :
- #EXTM3U — la première ligne, qui indique une playlist étendue. Elle peut porter un attribut comme url-tvg, l'adresse d'un guide TV.
- #EXTINF:-1 suivi d'attributs et du nom de la chaîne — la ligne de description. Le -1 signifie que la durée est inconnue, ce qui est le cas d'un flux en direct.
- L'adresse du flux sur la ligne suivante — par exemple http://serveur.exemple:8080/live/utilisateur/motdepasse/1234.ts.
Une ligne de description typique ressemble à ceci : #EXTINF:-1 tvg-id="info.exemple" tvg-name="Info HD" tvg-logo="http://img.exemple/info.png" group-title="Information",Info HD. Les attributs les plus courants :
- tvg-id : l'identifiant de la chaîne dans le guide TV, qui sert à la relier à ses programmes dans un fichier XMLTV — voir ce que sont l'EPG et le XMLTV.
- tvg-name : le nom de la chaîne tel que le guide le connaît.
- tvg-logo : l'adresse du logo de la chaîne.
- group-title : la catégorie, ou le bouquet, auquel appartient la chaîne.
- des attributs catchup, sur certaines playlists, qui décrivent l'accès aux programmes passés.
M3U ou M3U8 : quelle différence ?
Les deux mots recouvrent deux situations différentes, d'où la confusion fréquente :
- Le M3U8 comme fichier de playlist : le même M3U étendu, enregistré en UTF-8. Le 8 désigne cet encodage. Pour une liste de chaînes, M3U et M3U8 se lisent de la même façon ; le M3U8 garantit simplement que des noms comme « Télé Région » ou des noms en alphabet arabe s'affichent correctement.
- Le M3U8 comme flux HLS : le HTTP Live Streaming, utilisé par de nombreux services, décrit un seul flux sous la forme d'une playlist .m3u8 de courts segments vidéo. Ce fichier n'est pas une liste de chaînes : c'est la mécanique interne d'une chaîne, que le lecteur lit pendant la lecture.
Une adresse de chaîne qui se termine par .m3u8 est donc un flux HLS, alors qu'une playlist nommée liste.m3u8 est une liste de chaînes. Le lecteur les distingue par leur contenu.
Fichier M3U ou lien M3U ?
La plupart des services n'envoient pas un fichier à télécharger une fois pour toutes. Ils envoient un lien M3U : une adresse qui génère la playlist sur leur serveur à chaque ouverture, pour refléter toujours la liste de chaînes du moment. Pour un service compatible Xtream, ce lien ressemble à ceci : http://serveur.exemple:8080/get.php?username=VOTRE_NOM&password=VOTRE_MOT_DE_PASSE&type=m3u_plus&output=ts.
- get.php est l'adresse du serveur qui fabrique la playlist.
- username et password sont vos identifiants personnels — les mêmes que votre code Xtream.
- type=m3u_plus demande le format étendu, avec logos, catégories et identifiants de guide.
- output=ts demande des adresses de direct en MPEG-TS ; output=m3u8 demande du HLS.
Autrement dit, le lien M3U d'un service compatible Xtream, c'est le code Xtream écrit en une seule adresse. Voilà pourquoi les deux accès mènent exactement aux mêmes chaînes — voir connexion Xtream ou lien M3U et ce qu'est l'API Xtream Codes.
Comment Klyvo Play lit un lien M3U
Klyvo Play accepte le lien M3U get.php remis par un service compatible Xtream. Quand vous le collez, l'application y lit le serveur, l'identifiant et le mot de passe, puis dialogue avec le serveur via l'API Xtream. Vous obtenez ainsi ce qu'une playlist brute ne peut pas offrir : le direct, les films et les séries dans des rubriques séparées, des affiches et des fiches, le guide par chaîne, le replay quand le service conserve une archive, et l'état de votre ligne.
Soyons clairs sur les limites : un simple fichier de playlist M3U, ou un lien M3U qui ne provient pas d'un service compatible Xtream, n'est pas pris en charge. Si le lien n'est pas reconnu, l'application le signale et propose de coller le lien get.php de votre service ou d'utiliser l'onglet Xtream. La marche à suivre est détaillée dans comment ajouter une playlist M3U.
Vous pouvez aussi éviter de taper un long lien à la télécommande : chaque installation de Klyvo Play affiche un code qui ressemble à une adresse MAC et une Device Key, auxquels votre revendeur ou vous-même pouvez associer la playlist sur le portail client — voir le portail des appareils.
Les limites d'une playlist M3U brute
- Le poids : une playlist de dizaines de milliers de chaînes et de films devient un gros fichier texte qu'il faut lire en entier avant d'afficher quoi que ce soit.
- Peu d'informations : ni résumé, ni structure en saisons, ni informations de compte dans le format lui-même.
- La correspondance du guide : le guide repose sur des tvg-id qui doivent correspondre exactement à ceux du fichier XMLTV ; à la moindre différence, la chaîne reste sans programme.
- Les copies figées : un fichier téléchargé est dépassé dès que le service modifie sa liste, ce qu'un lien évite.
C'est pourquoi Klyvo Play travaille avec l'API qui se trouve derrière le lien : les catégories se chargent quand vous les ouvrez, et même les très grosses playlists restent rapides — voir gérer une grosse playlist IPTV.
Gardez votre lien M3U pour vous
Un lien M3U contient votre identifiant et votre mot de passe en clair. Qui le possède peut ouvrir votre ligne, utiliser vos connexions et la faire bloquer pour partage. Ne le publiez pas sur un forum, dans un groupe ou sur une capture d'écran. Si vous pensez qu'il a fuité, demandez de nouveaux identifiants à votre service. Dans Klyvo Play, les informations d'une playlist enregistrée sont chiffrées et ne sont plus jamais réaffichées en entier.
Questions fréquentes
Peut-on ouvrir un fichier M3U dans un éditeur de texte ? Oui. C'est du texte brut, pratique pour vérifier le contenu d'une playlist — sans jamais modifier ni partager celle de quelqu'un d'autre.
Le M3U8 est-il meilleur que le M3U ? Pour une liste de chaînes, le M3U8 n'ajoute que l'encodage UTF-8, pour des noms accentués bien affichés. Comme flux, .m3u8 signifie HLS, que Klyvo Play lit aussi bien que le MPEG-TS.
Pourquoi mon lien M3U est-il « non reconnu » ? Klyvo Play attend le lien get.php complet d'un service compatible Xtream, avec identifiant et mot de passe. Un lien tronqué, ou une playlist qui ne vient pas d'un tel service, n'est pas accepté.
Un lien M3U contient-il les films et les séries ? Il peut, selon le service. Dans Klyvo Play, films et séries sont lus via l'API derrière le lien, et apparaissent dans leurs propres rubriques.
Où obtenir un lien M3U ? Auprès du service auquel vous êtes abonné et que vous êtes autorisé à utiliser. Klyvo Play est un lecteur et ne fournit pas de playlists.
Ajoutez votre lien M3U dans Klyvo Play
Un fichier M3U est une simple liste de chaînes ; le lien M3U d'un service compatible Xtream, ce sont vos identifiants en une seule adresse. Collez ce lien dans Klyvo Play et vous obtenez un catalogue complet et organisé au lieu d'une liste brute. Téléchargez Klyvo Play pour votre appareil et essayez l'application complète gratuitement pendant 10 jours.