Kodi IPTV : configurer PVR IPTV Simple Client (M3U et EPG)

Pour regarder l’IPTV sur Kodi, installez l’extension officielle PVR IPTV Simple Client depuis le dépôt Kodi (Paramètres > Extensions > Installer d’un dépôt > Clients enregistreur vidéo), ouvrez Configurer, collez l’URL de votre playlist M3U dans l’onglet Général, puis l’URL XMLTV dans l’onglet EPG si vous avez un guide des programmes. Validez avec OK : les chaînes apparaissent dans la rubrique TV de Kodi.

Kodi est un lecteur multimédia libre et gratuit : il ne fournit aucune chaîne. PVR IPTV Simple Client se contente de lire la playlist que vous lui donnez, généralement fournie par votre fournisseur IPTV.

Ce qu’il vous faut avant de commencer

• Kodi installé depuis une source officielle. Passez par la page de téléchargement de kodi.tv ou par le store de votre plateforme (par exemple Kodi sur Google Play, publié par la XBMC Foundation). Évitez les « builds » préconfigurés trouvés sur des forums ou des vidéos : ils embarquent souvent des extensions tierces et des dépôts non officiels.
• Une URL M3U (lien commençant par http:// ou https://) ou un fichier .m3u / .m3u8.
• Optionnel : une URL XMLTV pour le guide des programmes (EPG). Sans elle, les chaînes se lisent, mais sans grille horaire.

Au moment de cette mise à jour, la dernière version stable publiée par l’équipe Kodi est la 21.3 « Omega » ; Kodi 22 « Piers » est en phase de version candidate. La méthode ci-dessous est la même sur ces deux versions, avec l’habillage par défaut Estuary.

Si votre fournisseur ne vous a donné que des identifiants Xtream (serveur, nom d’utilisateur, mot de passe), demandez-lui le lien M3U correspondant : PVR IPTV Simple Client attend une playlist, pas un formulaire de connexion. Sur Fire TV, une application comme IPTV Smarters Pro accepte directement ces identifiants (voir notre guide IPTV Smarters Pro sur Fire Stick).

Installer PVR IPTV Simple Client depuis le dépôt officiel

L’extension fait partie du dépôt officiel de Kodi, aucun fichier ZIP ni dépôt externe n’est nécessaire.

1. Depuis l’écran d’accueil, ouvrez Paramètres (icône en forme d’engrenage).
2. Entrez dans Extensions.
3. Choisissez Installer d’un dépôt, puis Kodi Add-on repository si Kodi vous demande de choisir un dépôt.
4. Ouvrez Clients enregistreur vidéo (selon la traduction : « PVR clients »).
5. Sélectionnez PVR IPTV Simple Client, puis Installer.

Si l’extension est déjà installée, vous la retrouverez dans Extensions > Mes extensions > Clients enregistreur vidéo.

Cas particulier Linux (Ubuntu/Debian) : lorsque Kodi est installé via les paquets de la distribution, les clients PVR ne sont pas toujours inclus. Installez alors le paquet kodi-pvr-iptvsimple avec le gestionnaire de paquets, puis activez l’extension dans Kodi.

Ajouter la playlist M3U : chemin distant ou fichier local

Ouvrez l’extension, choisissez Configurer et restez dans l’onglet Général. Le réglage Emplacement propose deux options, décrites dans la documentation officielle de l’extension :

1. Choisissez l’emplacement adapté.
2. Collez l’URL complète, sans espace avant ni après (ou parcourez jusqu’au fichier).
3. Appuyez sur OK pour enregistrer : quitter avec Retour ne valide pas toujours la saisie.
4. Kodi affiche une notification pendant l’import des chaînes.

Une URL M3U contient souvent votre identifiant et votre mot de passe : ne la publiez jamais dans une capture d’écran, un forum ou un journal (log) partagé.

Le réglage de mise à jour automatique (désactivée, répétée toutes les X minutes avec un maximum de 120, ou une fois par jour) se trouve dans le même onglet. La documentation précise que le cache local est désactivé quand la mise à jour automatique est active. Depuis Kodi 20 « Nexus », l’extension accepte plusieurs configurations, donc plusieurs couples M3U + XMLTV.

Ajouter le guide des programmes (EPG XMLTV)

Toujours dans Configurer, ouvrez l’onglet EPG :

1. Réglez l’emplacement sur chemin distant (URL) ou chemin local (fichier).
2. Collez l’URL XMLTV donnée par votre fournisseur. Certaines playlists l’indiquent déjà dans leur en-tête via l’attribut x-tvg-url.
3. Validez avec OK.

L’extension lit les fichiers XMLTV bruts et compressés en Gzip (.xml.gz) ou XZ. Un réglage de décalage horaire de l’EPG (EPG time shift dans la documentation) décale toutes les heures du guide, de -12 h à +14 h, si les programmes apparaissent avec un décalage.

Pour que les programmes s’affichent, Kodi doit relier chaque chaîne à son entrée dans le XMLTV. Il compare d’abord le tvg-id de la M3U au <channel id> du XMLTV, puis le tvg-name et enfin le nom de la chaîne au <display-name>. Si rien ne correspond, la chaîne reste sans programme. Pour trouver une source XMLTV et comprendre ces identifiants, voyez notre page EPG IPTV : trouver et ajouter une source XMLTV.

Ouvrir la TV en direct et le guide

Revenez à l’écran d’accueil et ouvrez la rubrique TV. La liste des chaînes importées s’affiche ; le guide des programmes est accessible depuis cette même rubrique. Le premier chargement de l’EPG peut prendre un moment si le fichier XMLTV est volumineux. Sélectionnez une chaîne pour lancer la lecture.

Le rattrapage (catch-up) et la pause du direct ne dépendent pas seulement de Kodi : ils ne fonctionnent que si le serveur de votre fournisseur les prend en charge.

Problèmes fréquents et solutions

« Aucune chaîne » après la configuration

1. Ouvrez l’URL M3U dans un navigateur sur le même réseau : elle doit renvoyer un fichier commençant par #EXTM3U, pas une page d’erreur ou de connexion.
2. Vérifiez que l’abonnement est actif et que l’URL n’a pas changé.
3. Téléchargez le fichier et testez-le en chemin local : si cela fonctionne, le problème vient de l’accès distant, pas de Kodi.
4. Désactivez temporairement l’EPG pour tester uniquement l’import des chaînes, puis redémarrez Kodi depuis son menu d’alimentation.

Gestionnaire PVR bloqué au chargement

Un import qui ne progresse pas vient souvent d’un fichier distant lent ou très lourd (M3U ou XMLTV). Testez les deux fichiers en local pour isoler la cause. Si l’EPG est en cause, préférez une version compressée .xml.gz ou une source limitée aux chaînes que vous regardez. Pour lire les messages exacts, activez le journal de débogage dans Paramètres > Système > Journalisation, reproduisez le problème et cherchez pvr.iptvsimple dans kodi.log (en masquant vos identifiants avant tout partage).

Guide EPG vide ou décalé

Vérifiez que l’URL XMLTV s’ouvre et contient des balises <programme>, que les tvg-id correspondent aux identifiants du guide, puis l’heure et le fuseau de l’appareil avant de toucher au décalage horaire de l’EPG.

Extension désactivée après une mise à jour de Kodi

Les clients PVR sont liés à la version de Kodi. Après une mise à jour majeure, ouvrez Extensions > Mes extensions > Clients enregistreur vidéo, vérifiez que PVR IPTV Simple Client est activé et à jour, puis contrôlez que vos réglages M3U et EPG sont toujours renseignés. Une chaîne listée mais illisible relève plutôt d’une erreur de lecture IPTV.

Pourquoi Kodi ne marche plus ?

Quand Kodi « ne marche plus », la cause est rarement Kodi lui-même. Les situations les plus courantes :

• Une extension tierce a cessé de fonctionner. Les extensions non officielles disparaissent ou cassent régulièrement ; l’équipe Kodi ne les prend pas en charge. La solution durable est de s’en tenir au dépôt officiel.
• Une mise à jour majeure a désactivé ou rendu incompatible une extension (voir ci-dessus).
• La source a changé : URL M3U expirée, abonnement terminé, serveur du fournisseur indisponible. Dans ce cas, contactez le fournisseur.
• Un build ou une configuration corrompue : réinstaller Kodi depuis la source officielle et reconfigurer uniquement PVR IPTV Simple Client repart sur une base propre.

Applications similaires à Kodi pour l’IPTV

Kodi est un centre multimédia complet, mais sa configuration PVR demande quelques étapes. Pour un usage uniquement IPTV, des lecteurs dédiés comme TiviMate, IPTV Smarters Pro ou VLC acceptent directement une playlist M3U, et certains des identifiants Xtream. Nous les comparons appareil par appareil dans notre guide des meilleures applications IPTV.

Si vous cherchez une offre IPTV pour la France compatible avec Kodi et ces applications, consultez les tarifs de l’abonnement IPTV.

Questions fréquentes

Comment mettre l’IPTV sur Kodi ?

Installez PVR IPTV Simple Client depuis le dépôt officiel (Paramètres > Extensions > Installer d’un dépôt > Clients enregistreur vidéo). Dans Configurer, ajoutez l’URL M3U dans l’onglet Général et, si vous l’avez, l’URL XMLTV dans l’onglet EPG. Validez avec OK, puis ouvrez la rubrique TV.

Comment avoir les chaînes TV sur Kodi ?

Kodi ne contient aucune chaîne : il faut lui fournir une playlist, en général celle de votre fournisseur IPTV, ou une source gratuite et légitime (certaines chaînes publient leurs propres flux). Le dépôt officiel propose aussi des extensions de vidéo à la demande. Évitez les extensions et dépôts tiers qui diffusent des contenus sans autorisation.

Pourquoi Kodi ne marche plus ?

Le plus souvent, c’est une extension tierce qui a cessé de fonctionner, une extension désactivée après une mise à jour de Kodi, ou une playlist qui a expiré. Vérifiez l’extension dans Mes extensions, testez l’URL M3U dans un navigateur et, en dernier recours, réinstallez Kodi depuis kodi.tv.

Quelle application est similaire à Kodi ?

Pour l’IPTV, TiviMate (Android TV), IPTV Smarters Pro (multiplateforme), VLC (logiciel libre) ou SS IPTV (Smart TV) jouent le même rôle de lecteur de playlist, avec une configuration plus directe. Le choix dépend surtout de votre appareil.