Ajouter une playlist M3U à Kodi avec IPTV Simple Client (avec EPG)

Comment fonctionne la TV en direct dans Kodi

Kodi n'ouvre pas les playlists IPTV dans sa médiathèque vidéo. La TV en direct passe par des clients PVR — des extensions qui alimentent la section TV de Kodi en chaînes et en guide des programmes. Pour une playlist M3U, l'extension officielle est PVR IPTV Simple Client, maintenue par l'équipe Kodi et disponible dans le dépôt officiel. Elle prend en charge :

• une playlist M3U/M3U8 depuis une URL ou un fichier local ;
• un guide des programmes XMLTV (EPG) ;
• les logos et groupes de chaînes (tvg-logo, group-title) ;
• le replay quand la source le permet.

Ce guide s'applique aux versions récentes de Kodi (20 « Nexus » et suivantes). Les intitulés peuvent varier légèrement selon la version et l'habillage, mais le chemin reste le même.

Avant de commencer

Préparez :

• l'URL de la playlist ou le fichier — par exemple le lien M3U de votre compte M3utify ;
• éventuellement l'URL du guide XMLTV (.xml ou .xml.gz). Si vous utilisez l'accès Xtream de M3utify, le guide est disponible à l'adresse https://m3utify.com/xmltv.php?username=…&password=….

Une playlist filtrée, limitée aux groupes que vous regardez, rend Kodi beaucoup plus rapide : la section TV doit indexer chaque chaîne et chaque programme. Nettoyez-la d'abord dans l'éditeur M3utify.

Étape 1 : installer PVR IPTV Simple Client

1. Ouvrez Kodi et allez dans Paramètres (l'icône d'engrenage) → Extensions.
2. Choisissez Installer depuis un dépôt → Kodi Add-on repository → Clients PVR.
3. Sélectionnez PVR IPTV Simple Client et cliquez sur Installer. Acceptez les dépendances proposées.

Sur certaines distributions Linux, l'extension s'installe plutôt via le gestionnaire de paquets du système (paquet kodi-pvr-iptvsimple).

Étape 2 : configurer la playlist

1. Depuis Paramètres → Extensions → Mes extensions → Clients PVR, ouvrez PVR IPTV Simple Client et cliquez sur Configurer. Les versions récentes proposent d'ajouter une configuration : cela permet d'installer plusieurs playlists côte à côte.
2. Dans l'onglet Général, réglez Emplacement sur :
   • Chemin distant (adresse Internet) et collez l'URL dans URL de la playlist M3U, ou
   • Chemin local (réseau local inclus) et sélectionnez le fichier.
3. Laissez activée la mise en cache locale de la playlist M3U pour les playlists distantes ; Kodi la rechargera au démarrage.
4. Validez avec OK.

Étape 3 : configurer le guide des programmes (EPG)

1. Ouvrez l'onglet EPG de la même configuration.
2. Réglez Emplacement sur Chemin distant et collez l'adresse XMLTV dans URL XMLTV (ou sélectionnez un fichier local).
3. Si les programmes sont décalés d'une heure ou plus, ajustez ici le décalage horaire de l'EPG — ou corrigez les chaînes concernées avec tvg-shift dans la playlist (voir corriger un décalage horaire de l'EPG).

Si l'en-tête de votre playlist contient déjà x-tvg-url="…", IPTV Simple Client peut l'utiliser, mais saisir explicitement l'URL du guide est plus fiable.

Étape 4 : logos et groupes

Dans l'onglet Logos des chaînes, conservez une source distante si votre playlist utilise des URL tvg-logo, et choisissez si les logos de la playlist ou ceux du guide sont prioritaires. Les groupes issus de group-title apparaissent comme groupes de chaînes dans la section TV, où vous choisissez lesquels afficher.

Étape 5 : redémarrer et ouvrir la section TV

Redémarrez Kodi (ou désactivez puis réactivez l'extension). Une notification indique le chargement des chaînes et des programmes. Ouvrez ensuite TV depuis le menu principal : vous obtenez la liste des chaînes, la grille du guide et les groupes. Le premier import de l'EPG peut prendre quelques minutes avec un gros guide.

Réglages recommandés

• Paramètres → PVR et TV en direct → Guide : réduisez le nombre de jours affichés dans le guide à 3 ou 4 sur les appareils peu puissants.
• Lecteur → Vidéos : gardez l'accélération matérielle activée (sur Android : MediaCodec), qui gère bien mieux les flux HD et H.265.

Si vous utilisez l'export Kodi de M3utify, la playlist contient des options #EXTVLCOPT optimisées pour la mise en mémoire tampon avec IPTV Simple Client.

Résolution des problèmes

« Aucune chaîne chargée » ou section TV vide

L'URL de la playlist est fausse ou inaccessible depuis l'appareil Kodi. Ouvrez l'URL dans un navigateur sur le même réseau : vous devez voir un fichier texte commençant par #EXTM3U. Vérifiez aussi que l'extension est activée.

Les chaînes se chargent mais le guide reste vide

Les valeurs tvg-id ne correspondent pas aux identifiants des chaînes du guide, ou l'URL du guide est fausse. Vérifiez d'abord l'URL de l'EPG, puis l'association — notre guide d'intégration EPG explique les deux. Effacer les données du guide (Paramètres → PVR et TV en direct → Général → Effacer les données) force un rechargement complet.

Les modifications de la playlist n'apparaissent pas

Kodi garde la playlist en cache. Redémarrez Kodi, ou définissez un intervalle d'actualisation dans l'onglet Général de l'extension. En dernier recours, utilisez Effacer les données dans les réglages PVR.

Les flux se coupent ou s'arrêtent

Consultez comment résoudre les coupures IPTV. Dans Kodi, essayez aussi l'export optimisé pour Kodi et vérifiez que l'accélération matérielle est active.

FAQ

PVR IPTV Simple Client est-il légal ?

Oui. C'est une extension officielle et open source du dépôt Kodi. Comme pour tout lecteur, la légalité dépend des flux de votre playlist — voir les sources IPTV légales.

Peut-on ajouter plusieurs playlists ?

Oui. Les versions récentes gèrent plusieurs configurations de l'extension, chacune avec sa playlist et son guide.

Faut-il installer des extensions Kodi tierces pour l'IPTV ?

Évitez les dépôts non officiels : ils sont une source fréquente de logiciels malveillants et de contenus illégaux. IPTV Simple Client, depuis le dépôt officiel, suffit pour une playlist M3U.