En bref : un lien IPTV M3U est l’adresse d’un fichier texte qui liste vos chaînes, une par une, avec leur nom et leur adresse de lecture. On le colle dans un lecteur comme VLC. La plupart des pannes viennent d’une copie incomplète, pas du fichier lui-même.
Après la commande, vous recevez un message avec une longue adresse pleine de signes étranges. Un point d’interrogation, des « = », des « & », un mot de passe au milieu. Ce n’est pas une page web à visiter : c’est une liste de lecture à donner à une application.
Ce guide ouvre ce fichier pour en montrer l’intérieur, compare le lien aux codes Xtream, détaille l’ouverture dans un lecteur et passe en revue les erreurs qu’on nous décrit le plus souvent.
IPTV M3U : qu’est-ce qu’un fichier M3U ?
Un fichier M3U est une liste de lecture en texte brut. Il ne contient aucune vidéo, seulement des adresses. Le lecteur le lit du haut vers le bas, affiche le nom de chaque chaîne et va chercher l’image à l’adresse indiquée quand vous en choisissez une. En IPTV, ce fichier est généré par le serveur à partir de votre compte.
Le format est né pour la musique. Il servait à enchaîner des morceaux dans un ordre choisi, comme le rappelle la page de l’encyclopédie en ligne sur le format de liste de lecture M3U. L’IPTV l’a repris tel quel, en remplaçant les chansons par des flux de télévision.
Deux conséquences découlent de cette nature de simple texte. Le fichier s’ouvre dans n’importe quel éditeur, le Bloc-notes par exemple, ce qui permet de vérifier son contenu soi-même. Et il pèse très peu : à raison d’environ 150 caractères par entrée, une liste de 20 000 entrées tient dans 3 Mo.
Si le vocabulaire général vous manque encore, notre dossier IPTV c’est quoi, expliqué depuis le début pose les bases avant d’entrer dans ce format.
Que contient un lien IPTV M3U, ligne par ligne ?
Un fichier IPTV M3U commence toujours par la ligne #EXTM3U. Viennent ensuite des paires de lignes : une ligne #EXTINF qui décrit la chaîne (nom, catégorie, identifiant pour le guide des programmes), puis une ligne avec l’adresse du flux. Deux lignes par chaîne, donc 40 001 lignes pour 20 000 entrées.
Voici un extrait fictif, tel qu’il apparaît dans un éditeur de texte :
#EXTM3U
#EXTINF:-1 tvg-id="info1.fr" tvg-name="Info 1 HD" group-title="Information",Info 1 HD
http://exemple-serveur.tv:8080/jean1234/motdepasse/101.ts
#EXTINF:-1 tvg-id="cine2.fr" tvg-name="Cinéma 2 FHD" group-title="Cinéma",Cinéma 2 FHD
http://exemple-serveur.tv:8080/jean1234/motdepasse/102.ts
Chaque morceau a un rôle. Le -1 indique une durée inconnue, normale pour du direct. tvg-id sert à rattacher la chaîne à sa grille de programmes. group-title range la chaîne dans une catégorie du lecteur. Le texte après la virgule est le nom affiché à l’écran.
Regardez maintenant la ligne d’adresse. On y lit le serveur et son port, puis le nom d’utilisateur, le mot de passe et le numéro de la chaîne. Vos identifiants figurent donc en clair dans chaque ligne du fichier.
Quelle différence entre un fichier M3U et un fichier M3U8 ?
Un fichier M3U8 est un fichier M3U enregistré avec l’encodage UTF-8, celui qui affiche correctement les accents et les alphabets non latins. La structure est identique. En IPTV, l’extension M3U8 désigne aussi les petites listes que le format HLS utilise pour annoncer les segments vidéo d’une chaîne.
Le premier sens explique un défaut d’affichage courant. Des noms comme « Cin?ma » ou « événement » dans la liste des chaînes signalent un fichier lu dans le mauvais encodage. Le flux fonctionne, seul le nom est abîmé. Un lecteur plus récent ou le choix de l’UTF-8 dans ses réglages corrige l’affichage.
Le second sens se voit à la fin des adresses. Une adresse terminée par .ts pointe vers un flux continu. Une adresse terminée par .m3u8 pointe vers une liste de segments de quelques secondes, rechargée en permanence par le lecteur. Ce n’est plus votre liste de chaînes, c’est le sommaire d’une seule chaîne.
Lien M3U ou codes Xtream : quelle différence en IPTV ?
Il n’y a pas de différence de fond : un lien M3U et des codes Xtream contiennent les mêmes identifiants, présentés autrement. Le lien réunit tout dans une seule adresse à coller. Les codes Xtream séparent l’URL du serveur, le nom d’utilisateur et le mot de passe dans des champs distincts du lecteur.
La preuve se lit dans le lien complet, qui ressemble à ceci :
http://exemple-serveur.tv:8080/get.php?username=jean1234&password=motdepasse&type=m3u_plus&output=ts
Tout ce qui précède /get.php est l’URL du serveur. Après username= vient le nom d’utilisateur, après password= le mot de passe. Avec un lien en main, vous pouvez donc reconstituer vos codes Xtream sans rien demander. Notre guide pour saisir des codes Xtream IPTV dans un lecteur détaille chaque champ.
La différence est pratique. Avec le lien, le lecteur télécharge un fichier figé au moment de l’import. Avec les codes, il interroge le serveur et récupère les catégories, les films et le guide des programmes à jour. Sur un téléviseur, taper trois champs courts à la télécommande reste aussi moins pénible qu’une adresse de cent caractères.
Les boîtiers MAG forment un cas à part. Ils ne lisent pas de lien M3U et se connectent à une adresse de portail liée à leur adresse MAC. Pour voir les formats côte à côte, consultez notre page qui explique à quoi ressemble un code IPTV.
Comment ouvrir un lien IPTV M3U dans VLC ?
Dans VLC, ouvrez le menu Média puis « Ouvrir un flux réseau », ou appuyez sur Ctrl+N sous Windows. Collez le lien IPTV M3U complet dans le champ et validez. La première chaîne démarre après quelques secondes. Affichez ensuite la liste entière avec Ctrl+L pour choisir une autre chaîne.
- Installez VLC, gratuit et open source, sur Windows, Mac, Android ou iOS.
- Copiez le lien depuis le message reçu, du premier
httpjusqu’au dernier caractère. - Ouvrez Média > Ouvrir un flux réseau (Ctrl+N sous Windows).
- Collez le lien et vérifiez qu’aucun espace ne s’est glissé au début ou à la fin.
- Cliquez sur Lire, puis patientez pendant le chargement de la liste.
- Appuyez sur Ctrl+L pour afficher les chaînes et utilisez le champ de recherche.
Si l’image saccade sur une connexion irrégulière, cochez « Afficher plus d’options » dans la même fenêtre. Une valeur de mise en cache réseau y est exprimée en millisecondes. La passer de 1 000 à 3 000 donne trois secondes d’avance au lecteur au lieu d’une.
Comment ouvrir un lien M3U dans un lecteur IPTV sur téléviseur ?
Sur un téléviseur, un boîtier ou une clé HDMI, ouvrez le lecteur IPTV, choisissez l’ajout d’une liste par lien M3U, donnez-lui un nom et saisissez l’adresse complète. Le lecteur télécharge le fichier, classe les chaînes par catégorie et les garde en mémoire. Il recharge ensuite la liste à intervalles réguliers ou à la demande.
Taper un lien de cent caractères avec une télécommande est l’endroit où tout se joue. Une seule lettre fausse et le lecteur répond par une liste vide. Quand l’application propose une saisie par codes Xtream, préférez-la : même résultat, bien moins de touches. Sinon, dictez l’adresse à quelqu’un qui la relit caractère par caractère.
Attention aux majuscules. Le nom d’utilisateur et le mot de passe y sont sensibles : Jean1234 et jean1234 sont deux comptes différents pour le serveur. Les claviers de téléviseur mettent parfois une majuscule automatique en début de champ.
Pourquoi un lien IPTV M3U ne fonctionne-t-il pas ?
Un lien IPTV M3U échoue le plus souvent pour une raison simple : il a été mal copié. Viennent ensuite un abonnement arrivé à sa date de fin, un autre écran déjà connecté sur le même compte et un type de sortie que le lecteur ne sait pas lire. Le tableau suivant associe chaque symptôme à sa cause.
| Ce que vous voyez | Cause probable | Ce qu’il faut faire |
|---|---|---|
| Liste vide après l’import | Lien tronqué, la fin manque | Recopier jusqu’à output=ts ou output=m3u8 |
| Erreur dès la validation | Espace ou retour à la ligne dans le lien | Coller dans le Bloc-notes, remettre sur une seule ligne |
| Identifiants refusés | Majuscule ou caractère confondu (0 et O, l et 1) | Copier-coller au lieu de retaper |
| Fonctionnait hier, plus rien aujourd’hui | Abonnement arrivé à expiration | Vérifier la date de fin de l’abonnement |
| La chaîne se coupe toutes les trente secondes | Un second appareil lit avec le même compte | Fermer le lecteur sur l’autre appareil |
| La liste s’affiche, aucune chaîne ne démarre | Type de sortie non lu par le lecteur | Changer ts en m3u8, ou l’inverse |
| Noms de chaînes avec des signes bizarres | Mauvais encodage | Choisir UTF-8 dans le lecteur |
Les messageries sont responsables de la première ligne du tableau. Certaines coupent une adresse au premier « & » et ne rendent cliquable que le début. En appuyant sur le lien bleu, on ne copie alors qu’une moitié. Sélectionnez le texte du message en entier, puis copiez.
Un contrôle tranche en une minute. Collez le lien dans la barre d’adresse d’un navigateur sur ordinateur. Si un fichier se télécharge et que son contenu commence par #EXTM3U, le lien et le compte sont bons, et il faut chercher du côté du lecteur. Une page vide ou un fichier de zéro octet désigne le lien ou l’abonnement.
Que change le type de sortie ts ou m3u8 dans un lien M3U ?
La fin du lien M3U, output=ts ou output=m3u8, indique sous quelle forme chaque chaîne sera envoyée. En ts, le serveur livre un flux continu, réactif au changement de chaîne. En m3u8, il livre des segments de quelques secondes au format HLS, plus tolérants quand la connexion varie. La liste des chaînes reste la même.
Le bon choix dépend du lecteur plus que de vos goûts. VLC lit les deux sans difficulté. Certains lecteurs, sur téléviseur notamment, s’entendent mieux avec le HLS. Si la liste se charge mais que chaque chaîne tourne dans le vide, modifier ce seul mot à la fin du lien est le premier essai à faire.
L’autre paramètre, type=m3u_plus, ajoute aux lignes #EXTINF les informations de catégorie, de logo et d’identifiant de guide. Avec type=m3u tout court, vous obtenez une liste nue : les noms et les adresses, rien d’autre. Un lecteur de salon a besoin de la version « plus » pour ranger les chaînes dans des dossiers.
Comment conserver son lien IPTV M3U en sécurité ?
Traitez votre lien IPTV M3U comme un mot de passe, puisqu’il en contient un. Quiconque le possède peut lire vos chaînes, et comme un abonnement fonctionne sur un écran à la fois, sa lecture coupera la vôtre. Ne le publiez jamais dans un groupe ni sur un forum, même pour demander de l’aide.
Pour montrer un problème à l’assistance, une capture d’écran du message d’erreur suffit. Si vous devez vraiment coller le lien quelque part, remplacez d’abord le mot de passe par des X. La personne qui vous aide a besoin de voir la forme de l’adresse, pas vos identifiants.
Questions fréquentes sur l’IPTV M3U
Peut-on ouvrir un fichier M3U sans connexion internet ?
Le fichier lui-même s’ouvre hors ligne dans un éditeur de texte, puisqu’il ne contient que des lignes de texte. Les chaînes, elles, ne se liront pas : chaque adresse pointe vers un serveur distant. Sans connexion, le lecteur affiche la liste enregistrée mais aucune image ne démarre.
Faut-il télécharger le fichier M3U ou utiliser le lien ?
Utilisez le lien quand le lecteur le permet. Il recharge la liste depuis le serveur, ce qui suit les ajouts et les changements de chaînes. Un fichier téléchargé reste figé au jour de son téléchargement. Après quelques semaines, certaines entrées ne correspondent plus à rien et il faut le récupérer de nouveau.
Pourquoi ma liste M3U met-elle longtemps à charger ?
Le lecteur télécharge le fichier puis trie chaque entrée par catégorie. Sur une liste qui compte des dizaines de milliers de lignes, ce tri prend du temps sur un téléviseur peu puissant. Le chargement a lieu une fois, puis la liste est gardée en mémoire. Les codes Xtream chargent souvent plus vite, catégorie par catégorie.
Un lien M3U fonctionne-t-il sur un boîtier MAG ?
Non. Un boîtier MAG ne lit pas de lien M3U. Il utilise une adresse de portail, saisie dans ses réglages, et le serveur le reconnaît grâce à l’adresse MAC inscrite sous l’appareil. Demandez ce format précis au moment de la commande si vous possédez ce type de boîtier.
Le guide des programmes est-il inclus dans le lien M3U ?
Pas directement. Le fichier M3U contient pour chaque chaîne un identifiant, tvg-id, qui sert à la relier à sa grille. Les données du guide voyagent à part, le plus souvent au format XMLTV, par une seconde adresse à renseigner dans le lecteur. VLC n’affiche pas ce guide.
À lire ensuite
- Afficher le programme TV IPTV avec le guide EPG : relier les chaînes à leur grille et corriger un décalage d’une heure.
- Regarder un film en IPTV depuis le catalogue VOD : pistes audio, sous-titres et débit nécessaire en 4K.
- Pourquoi un code IPTV gratuit cesse vite de fonctionner : ce qui arrive à un compte partagé par des milliers de personnes.