Kodi IPTV : configurer PVR IPTV Simple Client, M3U et guide TV XMLTV

Kodi sur écran de télévision avec chaînes en direct et guide électronique des programmes XMLTV

Kodi permet d’organiser des chaînes IPTV dans une interface de télévision grâce à l’extension officielle PVR IPTV Simple Client. Pour fonctionner, ce client utilise une playlist M3U provenant d’une source autorisée et peut lui associer un guide des programmes XMLTV. Kodi et l’extension ne fournissent pas de chaînes ni d’abonnement.

Nous détaillons l’installation, les réglages M3U/EPG, le fonctionnement du guide, les limites de Xtream Codes, du replay et de l’enregistrement, puis les solutions aux problèmes courants sur Windows et macOS. Pour un lecteur beaucoup plus simple, consultez le guide VLC pour ouvrir une URL M3U et tester un flux ; conserver les ancrages français présents dans le contenu ; pour une installation par appareil, le guide d’installation général, pour choisir la procédure adaptée à son appareil ; conserver les ancrages français présents dans le contenu.

Viktige punkter

  • Installez PVR IPTV Simple Client depuis le dépôt officiel Kodi, pas depuis une « build TV premium ».
  • Renseignez M3U pour les chaînes et XMLTV pour le guide : ce sont deux sources de données différentes.
  • Une grille vide vient souvent de l’EPG, d’identifiants tvg-id incohérents ou d’une importation non actualisée.
  • La connexion Xtream à trois champs n’est pas la méthode native du client PVR standard.
  • Replay, pause et enregistrement ne sont pas garantis par la présence du bouton PVR : droits et capacités des flux priment.

Kodi IPTV : comment fonctionne la rubrique TV et PVR ?

Kodi est un centre multimédia gratuit et open source. Sa fonction PVR (Personal Video Recorder) réunit la télévision en direct, les chaînes, les informations de programme et, selon les services et modules, des fonctions associées à l’enregistrement. Kodi n’inclut toutefois pas de chaînes françaises ou d’abonnement IPTV. Pour afficher des chaînes provenant d’une liste M3U autorisée, on utilise le client PVR IPTV Simple Client. Il importe les adresses des chaînes ; si votre source fournit un EPG XMLTV, Kodi peut afficher leurs horaires. Le logiciel, le client PVR, la playlist et le guide TV sont quatre éléments distincts. Kodi demande plus de réglages que le guide VLC pour ouvrir une URL M3U et tester un flux ; conserver les ancrages français présents dans le contenu, mais propose une interface conçue pour un téléviseur ou un écran d’ordinateur. Pour les particularités Windows et macOS, consultez le parcours Windows et macOS de première installation ; conserver les ancrages français présents dans le contenu.

PVR IPTV Simple Client : extension officielle, M3U et XMLTV

PVR IPTV Simple Client est un module distribué dans le dépôt officiel Kodi. Sa documentation indique la prise en charge de M3U pour la TV en direct, de la radio et de XMLTV pour le guide électronique. Il s’agit d’un client PVR, pas d’un fournisseur de chaînes ni d’un moteur de recherche de contenus. Vous pouvez lui indiquer une URL M3U distante ou un fichier M3U local. Pour l’EPG, renseignez une source XMLTV si vous en possédez une. Les intitulés des onglets changent selon l’édition de Kodi et l’interface choisie ; la logique d’association M3U + XMLTV reste la même. Le [wiki officiel de Kodi](https://kodi.wiki/view/Add-on:PVR_IPTV_Simple_Client) décrit les formats et l’installation. N’utilisez pas de site tiers qui exige un achat ou une clé d’activation pour ce client libre.

Télécharger Kodi et installer le client PVR depuis le dépôt officiel

Si le module apparaît déjà installé, il peut suffire de l’activer et de le configurer. Si plusieurs clients PVR concurrents sont actifs, identifiez lequel alimente la rubrique TV : des sources multiples peuvent compliquer le diagnostic. Ne remplacez pas la procédure officielle par une « build Kodi avec chaînes illimitées ».

  1. Téléchargez Kodi depuis [kodi.tv](https://kodi.tv/download/) : choisissez la version correspondant à Windows, macOS, Android ou à votre autre appareil pris en charge. Sur Mac, vérifiez le téléchargement Intel ou Apple Silicon.
  2. Installez Kodi et lancez-le ; choisissez la langue française dans les paramètres d’interface si vous le souhaitez.
  3. Allez dans Paramètres > Extensions > Installer depuis un dépôt > Clients PVR (Settings > Add-ons > Install from repository > PVR clients).
  4. Sélectionnez PVR IPTV Simple Client puis Installer ou Activer, selon ce que l’interface propose.
  5. Ouvrez ensuite Mes extensions > Clients PVR > PVR IPTV Simple Client > Configurer.

Ajouter la playlist M3U : URL distante ou fichier local

Dans Configurer > Général, choisissez d’abord la source : URL distante quand la playlist est hébergée en ligne, ou chemin local quand vous disposez d’un fichier .m3u sur l’appareil. Entrez l’adresse complète ou sélectionnez le fichier. Enregistrez les modifications ; selon la version, un redémarrage de Kodi ou du client PVR peut être utile. Une liste valide peut fournir des groupes via group-title, des noms de chaînes et des informations de correspondance EPG via tvg-id. Elle n’assure pas pour autant la disponibilité de chaque chaîne : chaque adresse doit aussi être accessible et sa consultation autorisée. M3U8 désigne souvent un manifeste HLS pour un flux ; ce n’est pas automatiquement une liste de chaînes à importer comme un bouquet. Si votre source ne charge pas, essayez la même playlist dans le guide VLC pour ouvrir une URL M3U et tester un flux ; conserver les ancrages français présents dans le contenu pour distinguer erreur d’accès et configuration Kodi. Guide détaillé : le guide M3U pour la syntaxe, les listes et les mises à jour ; conserver les ancrages français présents dans le contenu.

Configurer le guide TV XMLTV et associer les chaînes

Dans les paramètres du client, ouvrez l’onglet EPG ou équivalent. Choisissez une URL distante XMLTV lorsque le guide est fourni en ligne, ou un fichier local XMLTV, puis enregistrez et actualisez les données. Après le premier chargement, ouvrez la rubrique TV > Guide. Le guide doit faire correspondre ses identifiants de chaîne avec la M3U. Les attributs tvg-id ou les noms des chaînes peuvent servir à cette association. Si les chaînes se lisent mais que le guide reste vide, vérifiez d’abord l’URL XMLTV, les identifiants et la période couverte, plutôt que de réinstaller Kodi. En France, si les émissions sont décalées d’une ou deux heures, examinez le fuseau horaire Europe/Paris, le traitement de l’heure d’été et les options de décalage EPG ; ne modifiez pas au hasard les horaires de la liste. Le dépannage approfondi est dans le diagnostic EPG/XMLTV et l’association des programmes ; conserver les ancrages français présents dans le contenu.

Configurer Kodi IPTV, de zéro à la première chaîne : les étapes

Si le menu TV n’apparaît pas, cherchez d’abord un client désactivé, une source invalide ou un chargement non terminé. L’étape suivante n’est pas l’installation d’une extension inconnue.

  1. Préparez le fichier ou l’URL M3U autorisée ainsi que l’URL XMLTV du guide, si elle est disponible.
  2. Installez Kodi depuis son site officiel sur votre appareil.
  3. Depuis Paramètres > Extensions > Installer depuis un dépôt > Clients PVR, installez ou activez PVR IPTV Simple Client.
  4. Dans Mes extensions > Clients PVR > PVR IPTV Simple Client > Configurer > Général, indiquez la playlist M3U (adresse distante ou fichier local).
  5. Dans EPG, ajoutez le guide XMLTV si vous en avez un et vérifiez son emplacement.
  6. Validez, assurez-vous que le client est activé, puis actualisez la rubrique TV ou redémarrez Kodi si nécessaire.
  7. Dans TV > Chaînes, sélectionnez une chaîne autorisée ; dans TV > Guide, vérifiez que les horaires s’affichent.
  8. Testez une deuxième chaîne, une piste audio et un changement de programme pour confirmer la configuration.

Utiliser Kodi : groupes de chaînes, guide et recherche

Lorsque la playlist est chargée, TV permet de naviguer entre chaînes, groupes, favoris et guide selon les métadonnées réellement fournies. Les catégories peuvent provenir du champ group-title de la playlist. Les logos et numéros peuvent également être lus si la source les inclut correctement. Un EPG avec programmes peut faciliter l’accès à une émission, mais voir son titre dans la grille n’assure pas la disponibilité d’un replay. Les fonctions de recherche, de favoris, de classification et d’affichage dépendent aussi du thème Kodi et du client PVR installé. Pour créer une interface pratique dans un salon, privilégiez des groupes pertinents, un guide à jour et une commande compatible. Sur un PC, clavier et souris suffisent ; sur un téléviseur, vérifiez la télécommande ou le contrôleur.

Kodi et Xtream Codes : pourquoi le client officiel attend du M3U

PVR IPTV Simple Client n’est pas un écran de connexion Xtream Codes utilisant automatiquement les champs serveur, utilisateur et mot de passe. Sa méthode de configuration officielle repose principalement sur M3U pour les flux et XMLTV pour le guide. Si vous n’avez que des identifiants Xtream, ne les saisissez pas dans un champ XMLTV ou dans une URL arbitrairement fabriquée. Demandez à la source de votre accès si elle fournit une playlist M3U compatible et autorisée, ou choisissez un lecteur qui prend réellement en charge XC API. Kodi dispose d’un vaste écosystème de modules, mais installer un module non officiel pour « débloquer Xtream » n’est pas une procédure nécessaire ni une garantie de fiabilité. Pour les trois champs d’authentification, consultez les méthodes d’accès Xtream Codes et leurs champs ; conserver les ancrages français présents dans le contenu et la comparaison des lecteurs la sélection du lecteur adapté au format et au système ; conserver les ancrages français présents dans le contenu.

Ce que le client PVR ne fait pas automatiquement : VOD, replay et enregistrement

Le client PVR officiel est conçu avant tout pour la télévision en direct M3U et l’EPG XMLTV, pas comme une interface universelle de films, séries, posters et saisons accessible avec n’importe quel abonnement.

Si votre objectif principal est l’enregistrement, commencez par les possibilités réelles d’enregistrement et leurs conditions ; conserver les ancrages français présents dans le contenu plutôt que de supposer que le menu TV contient automatiquement un bouton fonctionnel.

Kodi ou VLC : lequel choisir pour l’IPTV ?

Choisissez VLC pour contrôler rapidement une URL ou regarder un flux précis. Choisissez Kodi si vous regardez plusieurs chaînes avec un guide et souhaitez une interface TV. Si vous recevez uniquement un compte Xtream et recherchez VOD/épisodes, comparez les lecteurs dans la sélection du lecteur adapté au format et au système ; conserver les ancrages français présents dans le contenu sans forcer ces usages dans Kodi.

FonctionVLCKodi + IPTV Simple Client
Ouvrir une URL de fluxTrès simpleVia configuration M3U/PVR
Importer une playlist M3UOuiOui
Afficher les groupes de chaînesListe de lecture basiqueInterface TV et catégories
Grille EPG/XMLTVPas de vraie grille IPTV intégréeOui, si XMLTV correct
Connexion directe Xtream par trois champsNonNon dans le client PVR standard
Catalogue films/séries enrichiNon, pas nativementPas garanti avec IPTV Simple Client
Première configurationRapidePlus détaillée

Sécurité Kodi : dépôts officiels, extensions et droit d’accès

Kodi et IPTV Simple Client ne sont pas des services de chaînes. Le logiciel est légal en tant que lecteur, mais la source que vous ajoutez doit disposer des droits nécessaires pour les programmes en France. Utilisez le dépôt officiel Kodi, vérifiez l’auteur et évitez les ensembles préconfigurés ou extensions promettant « chaînes premium gratuites » ; une extension externe peut demander des droits ou accéder à vos fichiers et au réseau. Un fichier ZIP envoyé par un inconnu n’est pas une condition normale pour installer IPTV Simple Client. Maintenez Kodi et l’extension à jour. Si vous échangez un journal de diagnostic, masquez les URL de flux, les jetons et les identifiants. Pour vérifier un programme, partez de l’offre et du diffuseur autorisé, pas du nom d’une extension.

Protéger les adresses M3U et XMLTV dans Kodi

Une URL M3U peut contenir un nom d’utilisateur, un mot de passe ou un jeton dans son chemin. Une URL XMLTV peut aussi être liée au même compte. Elles doivent être traitées comme des informations personnelles de connexion : conservez-les hors des copies d’écran, discussions publiques et sauvegardes non protégées. Pour demander de l’aide, indiquez le message d’erreur, la version de Kodi, le type d’entrée (URL ou fichier) et l’appareil, sans publier le lien complet. N’utilisez pas de « testeur d’accès IPTV » anonyme qui demande votre URL intégrale. Si une adresse a été partagée publiquement, demandez sa réinitialisation auprès de son émetteur et retirez-la des messages accessibles. Pour la différence entre M3U et Xtream, consultez le guide M3U pour la syntaxe, les listes et les mises à jour ; conserver les ancrages français présents dans le contenu et les méthodes d’accès Xtream Codes et leurs champs ; conserver les ancrages français présents dans le contenu.

Kodi IPTV ne fonctionne pas : diagnostiquer les problèmes par étape

Un diagnostic efficace sépare playlist, EPG, lecteur, réseau et droits. Ne réinstallez pas tout Kodi avant d’avoir isolé le maillon défectueux.

SymptômeCause à vérifier en prioritéAction utile
TV absente du menu d’accueilClient PVR non activé, pas de chaînes importéesVérifier Mes extensions > Clients PVR, configurer M3U, relancer Kodi
« Aucune chaîne »URL erronée, liste vide, source expirée, chargement non terminéContrôler M3U, tester dans le guide VLC pour ouvrir une URL M3U et tester un flux ; conserver les ancrages français présents dans le contenu, relancer l’import
Chaînes visibles mais EPG videXMLTV absent ou correspondance chaîne-guide incorrecteVérifier URL, tvg-id, dates, mise à jour du guide dans le diagnostic EPG/XMLTV et l’association des programmes ; conserver les ancrages français présents dans le contenu
Guide décalé d’une heureHeure d’été ou fuseau mal interprétéVérifier Europe/Paris, horloge et options de décalage XMLTV
Écran noir / son absentCodec, protection, URL non autorisée ou flux indisponibleTester une autre chaîne, piste audio, accélération matérielle ; le dépannage des images noires, sons et codecs ; conserver les ancrages français présents dans le contenu
Coupures fréquentesDébit irrégulier, Wi-Fi, source en surchargeComparer Ethernet et réseau dans le diagnostic du réseau, du débit et des coupures ; conserver les ancrages français présents dans le contenu
Import bloqué ou très lentPlaylist volumineuse ou inaccessibleTester une source limitée, actualiser et vérifier le réseau
Replay ou enregistrement impossibleFonction ou droits absentsLire les possibilités réelles d’enregistrement et leurs conditions ; conserver les ancrages français présents dans le contenu et vérifier les capacités précises du service

Kodi sur Windows et Mac : installation et fonctionnement pratiques

Sur Windows 10/11, téléchargez l’installateur adapté sur [Kodi Windows](https://kodi.tv/download/windows/) ou utilisez l’option officielle proposée par l’éditeur. Installez ensuite PVR IPTV Simple Client depuis le dépôt intégré. Le clavier, la souris et une télécommande compatible peuvent servir à naviguer. Sur macOS, la [page officielle Kodi](https://kodi.tv/download/macos/) distingue notamment les téléchargements Intel et Apple Silicon. Vérifiez la version minimale du système indiquée, puis importez vos sources M3U/XMLTV selon la même logique. Les chemins de téléchargement et protections de sécurité ne sont pas identiques à Windows. Sur TV via un ordinateur, choisissez un câble ou adaptateur vidéo pris en charge et réglez le mode d’affichage. Si vous préférez installer directement l’application sur une box ou une TV, sélectionnez d’abord le bon système via le guide d’installation général, pour choisir la procédure adaptée à son appareil ; conserver les ancrages français présents dans le contenu. Le guide le parcours Windows et macOS de première installation ; conserver les ancrages français présents dans le contenu détaille les tests Windows/Mac et la sortie HDMI.

FAQ : Kodi PVR IPTV Simple Client, M3U et guide TV

Kodi inclut-il des chaînes IPTV ? Non. Le logiciel et son extension PVR ne fournissent aucune chaîne ni aucun droit de diffusion. L’extension PVR IPTV Simple Client est-elle gratuite ? Elle fait partie du dépôt officiel Kodi ; cela n’inclut pas d’abonnement aux contenus. Peut-on utiliser une URL M3U ? Oui. Le client officiel peut utiliser une playlist M3U distante ou locale contenant des flux compatibles et autorisés. Comment afficher les programmes à la télévision ? Ajoutez une source XMLTV, puis vérifiez l’association entre ses chaînes et les tvg-id de la liste. Peut-on entrer des codes Xtream directement ? Pas dans le formulaire standard d’IPTV Simple Client ; cherchez une source M3U ou un lecteur adapté à cette méthode. Pourquoi Kodi affiche-t-il « aucune chaîne » ? Vérifiez activation PVR, validité M3U, réseau et actualisation des données. Peut-on installer Kodi sur Mac Apple Silicon ? Oui, le site officiel propose un téléchargement macOS adapté ; vérifiez modèle et version du système. Kodi peut-il enregistrer les programmes IPTV ? Pas automatiquement avec toute playlist ; droits, prise en charge du client ou du backend et stockage comptent. Voir les possibilités réelles d’enregistrement et leurs conditions ; conserver les ancrages français présents dans le contenu. Kodi et VLC sont-ils équivalents ? Non : VLC lit rapidement les flux, Kodi organise la télévision en direct et le guide. Voir le guide VLC pour ouvrir une URL M3U et tester un flux ; conserver les ancrages français présents dans le contenu. Une build Kodi « toutes chaînes » est-elle sûre ? Le nom ne garantit ni sécurité, ni droits. Préférez le Kodi et les extensions officiels.

Configurer Kodi IPTV et choisir la suite adaptée

Pour organiser votre télévision en direct dans Kodi, installez PVR IPTV Simple Client depuis le dépôt officiel, indiquez votre M3U autorisée, puis ajoutez XMLTV si le programme TV est disponible. Vous obtenez une interface de chaînes et guide, avec les limites propres à la source et à l’extension. Pour une simple lecture de flux, le guide VLC pour ouvrir une URL M3U et tester un flux ; conserver les ancrages français présents dans le contenu est souvent plus rapide. Pour un PC ou Mac, consultez le parcours Windows et macOS de première installation ; conserver les ancrages français présents dans le contenu ; pour dépanner le guide, le diagnostic EPG/XMLTV et l’association des programmes ; conserver les ancrages français présents dans le contenu ; et pour vérifier les possibilités d’enregistrement, les possibilités réelles d’enregistrement et leurs conditions ; conserver les ancrages français présents dans le contenu.

Pour tester rapidement la playlist dans un autre lecteur, utilisez le guide VLC pour ouvrir une URL M3U et tester un flux ; conserver les ancrages français présents dans le contenu. Pour comprendre les fichiers de télévision et les identifiants, parcourez le guide M3U pour la syntaxe, les listes et les mises à jour ; conserver les ancrages français présents dans le contenu et les méthodes d’accès Xtream Codes et leurs champs ; conserver les ancrages français présents dans le contenu ; pour corriger la grille, le diagnostic EPG/XMLTV et l’association des programmes ; conserver les ancrages français présents dans le contenu ; pour l’enregistrement et ses limites, les possibilités réelles d’enregistrement et leurs conditions ; conserver les ancrages français présents dans le contenu. Vous pouvez aussi revenir à le parcours Windows et macOS de première installation ; conserver les ancrages français présents dans le contenu ou comparer les clients dans la sélection du lecteur adapté au format et au système ; conserver les ancrages français présents dans le contenu.