Guide de nommage Kodi : Films, Séries télé, Anime, Musique & Fichiers NFO (2026)

    Kodi est reconnu pour sa flexibilité dans le nommage des fichiers — et c'est précisément pourquoi tant de bibliothèques plantent. Le scanneur accepte une douzaine de patrons valides, mais les applique de manière inconstante selon les scrapers. Choisis le bon patron pour ton scraper et Kodi trouvera les affiches, les résumés et les titres d'épisodes en quelques secondes. Trompe-toi, et tu fixeras un message « aucune information trouvée » pendant des heures.

    Ce guide est la référence pratique qu'on aurait aimé avoir en configurant notre première bibliothèque Kodi — chaque type de média, chaque bizarrerie de scraper, le système de fichiers NFO qui te permet de contourner complètement les scrapers, et les étapes de dépannage quand la bibliothèque refuse de scanner. Les exemples suivent le wiki officiel de Kodi et sont vérifiés avec le comportement de Kodi 21 (Omega), avec des notes pour les versions antérieures Kodi 20 (Nexus) et plus vieilles.

    À la fin, tu auras une bibliothèque Kodi qui se scanne proprement du premier coup — que tu partes de zéro, que tu répares un fouillis existant, ou que tu arrives de Plex ou Jellyfin en te demandant pourquoi « les patrons que j'ai toujours utilisés » ont soudainement cessé de fonctionner.

    Mis à jour en 2026 Contre-vérifié avec le wiki de Kodi 21 (Omega) Créé par l'équipe derrière RenameFlow Lecture d'environ 12 min

    Évite le travail manuel — renomme un dossier en quelques secondes

    Commencer gratuitement

    Les bases du nommage Kodi

    Trois concepts sur la façon dont Kodi scanne diffèrent assez de Plex et Jellyfin pour mériter leur propre explication. Saute cette section et tu continueras de rencontrer les trois mêmes problèmes : mauvais scraper pour ta bibliothèque, type de contenu mal configuré, et des fichiers NFO inattendus qui écrasent tes résultats de scrape.

    Scrapers, pas des agents

    Là où Plex a des « agents » et Jellyfin des « fournisseurs de métadonnées », Kodi a des « scrapers » — des add-ons maintenus par la communauté qui interrogent des bases de données spécifiques. Les scrapers par défaut sont The Movie Database pour les films, The Movie Database ou The TVDB pour les séries télé, et le Universal Album Scraper pour la musique. L'anime est la grande exception : Kodi n'a pas de scraper d'anime intégré, donc les utilisateurs installent des add-ons communautaires comme Hama (le même utilisé dans Plex) pour l'intégration avec AniDB. Le choix du scraper se fait par source, pas par bibliothèque. Ouvre une source vidéo Kodi dans l'explorateur de fichiers, modifie-la et choisis « Définir le contenu » pour assigner un scraper. La même source peut être analysée par différents add-ons sur plusieurs appareils Kodi sur le même réseau — c'est l'une des raisons pour lesquelles la situation « mon Kodi fonctionne mais pas celui de mon ami » est si fréquente.

    Sources de bibliothèque et types de contenu

    La bibliothèque de Kodi est construite à partir de « sources » que tu ajoutes manuellement — des dossiers, des partages réseau ou des chemins d'accès distants. Quand tu ajoutes une source, tu indiques à Kodi quel type de contenu elle contient (Films, Séries télé, Vidéoclips, Musique, Aucun) et quel scraper utiliser pour ce contenu. Mélanger les types de contenu dans une seule source est une cause fréquente de fichiers non correspondants : un dossier contenant à la fois des films et des séries télé ne peut être analysé que comme l'un ou l'autre. La solution est de séparer le contenu mixte dans des dossiers de premier niveau distincts, chacun étant sa propre source, avec son propre type de contenu. C'est plus rigide que la détection de bibliothèque par dossier de Plex, mais plus prévisible une fois que tu t'engages à respecter la structure.

    Quatre règles pour éviter 90 % des problèmes

    Quatre règles qui préviennent la grande majorité des échecs d'analyse de Kodi : Rule 1 — Un seul type de contenu par source. Ne mélange pas les films et les séries télé dans un même dossier que Kodi analyse comme « Films ». Rule 2 — Définis le type de contenu et le scraper AVANT la première analyse. Les modifier plus tard nécessite un « Rafraîchissement » et parfois une suppression complète de la base de données pour nettoyer les anciennes correspondances erronées. Rule 3 — Utilise sXXeYY pour les épisodes de séries télé, en minuscules et avec des zéros non significatifs. Kodi accepte plus de variantes que Plex, mais des motifs prévisibles évitent les cas limites des scrapers. Rule 4 — Quand un scraper échoue de façon répétée sur un élément spécifique, dépose un fichier NFO à côté. Les fichiers NFO remplacent complètement les scrapers — c'est la porte de sortie de Kodi.

    Need it from zero? guide étape par étape.

    Nommer les films pour Kodi

    Kodi accepte deux structures valides pour les films : un dossier par film et une structure à plat. La structure par dossier est recommandée pour les mêmes raisons que pour Plex et Jellyfin (extras, affiches, fichiers NFO), plus une fonctionnalité spécifique à Kodi : les films en plusieurs parties empilées (« stacked »), que Kodi gère nativement, contrairement à Plex et Jellyfin.

    Structure de dossiers recommandée

    La structure de dossiers recommandée :

    Movies/
    ├── Blade Runner (1982)/
    │   ├── Blade Runner (1982).mkv
    │   ├── Blade Runner (1982).en.srt
    │   ├── movie.nfo
    │   ├── poster.jpg
    │   └── fanart.jpg
    ├── Dune (2021)/
    │   └── Dune (2021).mkv
    └── The Matrix (1999)/
        └── The Matrix (1999).mkv

    Le nom du fichier correspond au nom du dossier. Les fichiers d'illustrations utilisent les noms d'illustrations locales de Kodi : poster.jpg, fanart.jpg, clearart.png, landscape.jpg. Les sous-titres suivent la convention Titre (Année).en.srt, .fr.srt, etc. — Kodi lit le code de langue à partir du suffixe séparé par un point.

    Le suffixe (Année) n'est pas optionnel

    L'année entre parenthèses n'est pas négociable pour les mêmes raisons que pour Plex et Jellyfin : TheMovieDB retourne les correspondances de titres en double classées par popularité, et Kodi choisira silencieusement la mauvaise. Format : Titre (AAAA). Les crochets [AAAA], les points Titre.AAAA et les années seules fonctionnent avec certains scrapers mais pas avec d'autres — les parenthèses sont universelles. Pour les films complètement absents de TMDB (films d'art et d'essai rares, sorties régionales), un fichier NFO avec un ID TMDB manuel est la seule solution fiable. Consulte la section NFO ci-dessous.

    Films en plusieurs parties empilées (« stacked ») (Kodi seulement)

    Kodi a un support natif pour les films en plusieurs parties stockés dans des fichiers séparés — une fonctionnalité de l'ère du rip de DVD qui est encore utile pour les films très longs (LotR Extended, Once Upon a Time in America) répartis sur plusieurs disques. Utilise les motifs de suffixe cd1 / cd2 / partN / dvdN :

    Movies/
    └── Lord of the Rings - The Fellowship of the Ring (2001)/
        ├── Lord of the Rings - The Fellowship of the Ring (2001) - cd1.mkv
        └── Lord of the Rings - The Fellowship of the Ring (2001) - cd2.mkv

    Kodi les lit l'un après l'autre comme un seul film et les indexe comme une seule entrée dans la bibliothèque. Le modèle de correspondance est insensible à la casse et accepte cd, part, dvd, pt et quelques autres — mais cd1/cd2 est la méthode la plus sûre et la mieux documentée.

    Versions multiples du même film

    Kodi n'a pas la fonction de fusion multi-version offerte par Plex et Jellyfin — tu ne peux pas stocker une version 1080p et une version 4K sous une seule entrée de bibliothèque et laisser Kodi choisir la bonne pour le client. Chaque fichier devient sa propre entrée dans la bibliothèque. Deux solutions de rechange : Approche 1 — Garde une version par film dans la bibliothèque de Kodi et stocke les autres versions hors de la source indexée. Change manuellement la source de la bibliothèque quand tu veux l'autre qualité. Approche 2 — Sépare en deux bibliothèques (Movies-1080p, Movies-4K) avec deux sources. Utilise les profils Kodi ou les raccourcis de l'habillage pour passer de l'une à l'autre. C'est plus de travail, mais ça permet à toutes les versions de coexister dans la même installation de Kodi. Si le multi-version est central à ton flux de travail, c'est le domaine où Plex et Jellyfin sont objectivement plus performants.

    Sagas de films et collections

    Kodi prend en charge les sagas de films (parfois appelées « collections ») — Star Wars, Marvel Cinematic Universe, Lord of the Rings — regroupant les films sous un seul nœud de collection navigable. Les sagas sont peuplées automatiquement à partir des données de collection de TMDB pour les films qui en font partie. Aucun changement de nom n'est requis; Kodi lit l'ID de la collection à partir des métadonnées TMDB indexées. Pour les sagas personnalisées (ton propre regroupement qui n'est pas sur TMDB), utilise un fichier NFO au niveau du film avec une balise <set> pointant vers un nom de saga personnalisé.

    Quatre erreurs qui expliquent la plupart des échecs d'indexation

    1. Type de contenu de la source réglé sur « Aucun » ou sur le mauvais type. Sans type de contenu, Kodi ne l'analyse pas du tout comme des films. 2. Année manquante ou entre crochets. « Inception 2010.mkv » fonctionne par chance; « Inception [2010].mkv » échoue avec le scraper de TMDB. 3. Fichier de film à la racine de la source sans dossier. Ça fonctionne pour la correspondance, mais ça brise les pochettes, les NFO et les fonctions de fichiers en plusieurs parties. 4. Entrées obsolètes d'une mauvaise indexation précédente. Même après avoir corrigé les noms, Kodi affiche l'ancienne mauvaise correspondance. Solution : menu contextuel de la bibliothèque → « Nettoyer la médiathèque » → puis ré-analyser.

    Exemples complets

    Movies/
    ├── The Matrix (1999)/
    │   ├── The Matrix (1999).mkv
    │   ├── movie.nfo
    │   └── fanart.jpg
    ├── Lord of the Rings - The Fellowship of the Ring (2001)/
    │   ├── Lord of the Rings - The Fellowship of the Ring (2001) - cd1.mkv
    │   └── Lord of the Rings - The Fellowship of the Ring (2001) - cd2.mkv
    ├── Dune (2021)/
    │   └── Dune (2021).mkv
    └── 1917 (2019)/
        └── 1917 (2019).mkv

    Compare to Équivalents pour Plex.

    Évite la saisie — renomme un dossier de films en quelques secondes

    Commencer gratuitement

    Nommer les séries télé pour Kodi

    C'est pour les séries télé que la flexibilité de Kodi est la plus utile — plusieurs modèles de noms de fichiers valides sont acceptés, et le scraper est indulgent avec les variations mineures. Le compromis : quand quelque chose ne correspond pas, la cause est rarement évidente. Cette section couvre les modèles sûrs et les cas où Kodi diffère de Plex/Jellyfin.

    Structure des dossiers

    Structure standard à deux niveaux : dossier de la série, puis sous-dossiers de saison.

    TV Shows/
    ├── Breaking Bad (2008)/
    │   ├── tvshow.nfo
    │   ├── poster.jpg
    │   ├── Season 01/
    │   │   ├── Breaking Bad - s01e01 - Pilot.mkv
    │   │   └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
    │   └── Season 02/
    │       └── Breaking Bad - s02e01.mkv
    └── The Office (2005)/
        └── Season 03/
            └── The Office - s03e12.mkv

    Nom du dossier de la série : "Title (Year)". L'année sert à différencier les remakes — The Office UK 2001 vs US 2005, House of Cards UK 1990 vs US 2013. Dossier de saison : "Season XX" avec un format à deux chiffres (zéro initial), ou "Season 0" (ou "Season 00") pour les épisodes spéciaux. Kodi accepte "Season 0" et "Season 00"; choisis-en un et sois constant. Contrairement à la convention de Plex pour le dossier "Specials", Kodi ne reconnaît PAS le nom de dossier littéral "Specials". Utilise Season 0 ou Season 00.

    Format du nom de fichier d'épisode

    Le format de nom de fichier d'épisode recommandé par Kodi : Show Name - sXXeYY - Episode Title.ext Lettres minuscules, numéros à deux chiffres avec zéro initial, titre d'épisode optionnel pour la lisibilité. Kodi accepte les majuscules (SXXEYY), Show.S01E01, Show 1x01, Show 101 et plusieurs autres variantes — mais la forme en minuscules séparée par des tirets est la plus fiable avec tous les scrapers. Le titre de l'épisode dans le nom de fichier est seulement pour la lisibilité humaine — le scraper de Kodi le remplace par le titre canonique de TheTVDB ou TheMovieDB. Si le titre fourni par le scraper est incorrect, modifie-le via l'interface de Kodi (clic droit sur l'épisode → "Information" → "Modifier") ou via le fichier NFO (sujet abordé plus tard).

    Épisodes spéciaux dans Season 0

    Les épisodes spéciaux, OVAs, épisodes pilotes, contenu en coulisses et bonus vont dans "Season 0" (ou "Season 00" — Kodi traite les deux de manière identique). À l'intérieur, utilise une numérotation séquentielle : Show - s00e01.mkv, Show - s00e02.mkv. L'ordre de numérotation doit correspondre à la liste des épisodes spéciaux de TheTVDB pour cette série. La communauté TheTVDB organise ces épisodes dans un ordre précis (souvent basé sur la date de diffusion); Kodi s'attend à ce que tu suives cet ordre. Si tes épisodes spéciaux semblent en désordre dans l'interface de Kodi, vérifie l'onglet des spéciaux sur TheTVDB pour la série et réorganise tes numéros s00eYY en conséquence.

    Fichiers multi-épisodes

    Pour les épisodes doubles dans un seul fichier :

    Breaking Bad - s05e15-e16 - Granite State + Felina.mkv

    Kodi crée un seul élément de lecture qui correspond aux deux épisodes dans les métadonnées. La forme avec une plage (e15-e16) est plus propre; la forme alternative (s05e15-s05e16) fonctionne aussi. Les deux s'étendent aux épisodes triples ou quadruples si nécessaire (e15-e16-e17), bien que ce soit rare en pratique.

    Émissions quotidiennes (basées sur la date)

    Les émissions quotidiennes (talk-shows, nouvelles) sans numéros de saison/épisode traditionnels utilisent le format de date YYYY-MM-DD :

    The Daily Show (1996)/
    └── Season 29/
        └── The Daily Show - 2024-03-15.mkv

    Le scraper TheTVDB de Kodi fait correspondre la date avec l'index des dates de l'émission quotidienne. Assure-toi que la source utilise le scraper TheTVDB, et non TheMovieDB — TheMovieDB a un support limité pour les émissions quotidiennes.

    Exemples complets

    Séries télé/
    ├── Breaking Bad (2008)/
    │   ├── tvshow.nfo
    │   ├── Season 01/
    │   │   ├── Breaking Bad - s01e01 - Pilot.mkv
    │   │   └── Breaking Bad - s01e02 - Cat's in the Bag.mkv
    │   ├── Season 05/
    │   │   └── Breaking Bad - s05e15-e16 - Granite State + Felina.mkv
    │   └── Season 00/
    │       └── Breaking Bad - s00e01 - No Half Measures.mkv
    ├── Chernobyl (2019)/
    │   └── Season 01/
    │       └── Chernobyl - s01e01 - 1:23:45.mkv
    └── The Daily Show (1996)/
        └── Season 29/
            └── The Daily Show - 2024-03-15.mkv

    Compare to Équivalents pour Jellyfin.

    Nommer les animes pour Kodi (avec le scraper Hama)

    Kodi n'a pas de scraper d'anime intégré — les add-ons par défaut TheMovieDB et TheTVDB traitent les animes comme des séries télé régulières, ce qui fonctionne pour les shonen saisonniers modernes, mais échoue pour les séries à numérotation absolue (One Piece, Detective Conan, Bleach). La solution est Hama, le même scraper communautaire utilisé dans Plex pour les bibliothèques d'animes. L'installer une seule fois débloque l'intégration d'AniDB pour toutes tes sources d'animes sur Kodi.

    Configuration de Hama (10 minutes, une seule fois)

    La configuration de Hama dans Kodi prend environ 10 minutes : 1. Télécharge Hama depuis github.com/ZeroQI/Hama.bundle (le bundle Plex fonctionne pour Kodi via le wrapper de l'add-on Hama pour Kodi). Alternative : installe « Hama » depuis le dépôt d'add-ons officiel de Kodi s'il est disponible dans ta version de Kodi. 2. Dans Kodi : Paramètres → Add-ons → Installer depuis un dépôt → Fournisseurs d'informations → Séries télé → installe Hama (et Hama.bundle s'il est listé séparément). 3. Crée une source dédiée aux animes. Ajoute une source vidéo qui pointe vers ton dossier d'animes, définis le type de contenu à « Séries télé » et choisis « Hama » comme scraper au lieu de TheMovieDB ou TheTVDB. 4. Par défaut, Hama utilise AniDB comme base de données principale. Tu peux changer l'ordre de priorité dans les paramètres du scraper — AniDB en premier est recommandé pour les séries à numérotation absolue; TheTVDB en premier pour les séries dont tu veux les métadonnées de la version doublée en anglais. 5. Lance un scrape sur la source. Le premier scrape est lent (Hama interroge plusieurs bases de données) — sois patient. Les scrapes suivants sont beaucoup plus rapides.

    Numérotation absolue des épisodes

    Pour les séries à numérotation absolue comme One Piece (épisode 1064), utilise la saison 01 avec les numéros d'épisode absolus complétés avec des zéros jusqu'à 4 chiffres :

    Anime/
    └── One Piece [anidbid-69]/
        └── Season 01/
            ├── One Piece - s01e0001.mkv
            ├── One Piece - s01e0002.mkv
            └── One Piece - s01e1064.mkv

    Le suffixe [anidbid-X] dans le nom du dossier force Hama à utiliser directement l'entrée AniDB, évitant la correspondance approximative par titre. Trouve l'ID sur anidb.net en cherchant la série — l'ID se trouve dans l'URL. Le complètement sur 4 chiffres n'est pas requis pour la correspondance, mais il assure que l'ordre de tri du système de fichiers correspond à l'ordre de lecture. Sans ce complètement, le fichier e1064 est trié après e11 au lieu d'après e1063, ce qui rend la navigation dans le dossier déroutante en dehors de Kodi.

    Saisons divisées et arcs

    Les animes modernes divisés en « parties » (Attack on Titan Final Season Parts 1/2/3, les arcs de Demon Slayer) causent la même confusion de scraping que dans Plex et Jellyfin. La solution : décide quelle base de données correspond à ta représentation mentale de la structure de la série, force-la via le suffixe d'ID dans le dossier, et reste cohérent pour tous tes animes.

    Anime/
    ├── Attack on Titan [anidbid-9541]/
    │   ├── Season 01/
    │   ├── Season 02/
    │   ├── Season 03/
    │   └── Season 04/   ← Final Season Partie 1
    ├── Attack on Titan - Final Season Part 2 [anidbid-15689]/
    │   └── Season 01/   ← AniDB considère la Partie 2 comme une entrée distincte
    └── Demon Slayer (2019)/
        ├── Season 01/
        ├── Season 02/   ← Mugen Train + Entertainment District
        └── Season 03/

    Exemples complets

    Anime/
    ├── One Piece [anidbid-69]/
    │   ├── Season 01/
    │   │   ├── One Piece - s01e0001.mkv
    │   │   └── One Piece - s01e1064.mkv
    │   └── Season 00/
    │       └── One Piece - s00e001 - Movie 14 Stampede.mkv
    ├── Attack on Titan [anidbid-9541]/
    │   ├── Season 01/
    │   └── Season 04/
    └── Demon Slayer (2019)/
        └── Season 02/
            └── Demon Slayer - s02e01.mkv

    Same scraper in Plex? Animes sur Plex (HAMA, même scraper).

    Nommer la musique pour Kodi

    Dans Kodi, la musique est d'abord gérée par les tags, puis par les dossiers — exactement comme avec Plex et Jellyfin. Le Universal Album Scraper (par défaut dans Kodi 19+) lit les tags ID3 et interroge MusicBrainz et TheAudioDB pour les illustrations et les métadonnées. Corrige d'abord les tags, puis occupe-toi de la structure des dossiers.

    Structure de dossiers recommandée

    Structure recommandée :

    Music/
    ├── Pink Floyd/
    │   ├── The Dark Side of the Moon (1973)/
    │   │   ├── 01 - Speak to Me.flac
    │   │   └── 02 - Breathe.flac
    │   └── Wish You Were Here (1975)/
    │       └── 01 - Shine On You Crazy Diamond Pts. 1-5.flac
    ├── Various Artists/
    │   └── Pulp Fiction Soundtrack (1994)/
    │       ├── 01 - Misirlou - Dick Dale.flac
    │       └── 02 - Royale with Cheese - John Travolta.flac
    └── Tool/
        └── Lateralus (2001)/
            ├── Disc 01/
            │   └── 01 - The Grudge.flac
            └── Disc 02/
                └── 01 - Faaip de Oiad.flac

    Il est recommandé d'inclure l'année de l'album dans le nom du dossier. Les albums multi-disques utilisent des sous-dossiers « Disc XX ». Les compilations utilisent un tag d'artiste d'album « Various Artists » (tag Album Artist = « Various Artists », tandis que le tag Artist individuel reste l'interprète de la piste).

    Les tags ID3 que Kodi utilise vraiment

    Tags ID3 requis pour une correspondance propre dans Kodi : Artist, Album, Title, Track Number. Fortement recommandés : Album Artist (distinct de Artist pour les compilations), Year, Genre, Disc Number, MusicBrainz IDs. Les ID MusicBrainz (Album ID et Recording ID, intégrés comme des trames TXXX ID3v2.3 ou des commentaires Vorbis) permettent au Universal Album Scraper de Kodi de faire une correspondance exacte, évitant la correspondance approximative par titre. Utilise MusicBrainz Picard pour écrire ces ID une bonne fois pour toutes et ta bibliothèque Kodi deviendra quasi infaillible. Le mode musique de RenameFlow lit MusicBrainz et produit des noms de fichiers et une structure de dossiers précis; il n'écrit pas de tags ID3. Utilise-le après un éditeur de tags comme Picard, pas en remplacement.

    Exemples complets

    Music/
    └── Pink Floyd/
        ├── The Dark Side of the Moon (1973)/
        │   ├── 01 - Speak to Me.flac
        │   └── 10 - Eclipse.flac
        └── The Wall (1979)/
            ├── Disc 01/
            │   └── 01 - In the Flesh?.flac
            └── Disc 02/
                └── 01 - Hey You.flac

    Fichiers NFO — Le système de remplacement des métadonnées de Kodi

    Les fichiers NFO sont la plus grande différence entre Kodi et Plex/Jellyfin en matière de nommage. Un NFO est un petit fichier XML que tu places à côté d'une vidéo, et Kodi le lit AU LIEU d'interroger les scrapers en ligne. Ils sont optionnels mais extrêmement utiles : ils te permettent de corriger les mauvaises correspondances du scraper, de documenter des collections personnalisées et de figer des métadonnées qui pourraient changer avec les mises à jour des bases de données en ligne. Plex n'a rien d'équivalent; Jellyfin offre un support partiel via des images locales et un XML minimal. Le système NFO de Kodi est l'implémentation la plus mature de tous les media centers open-source.

    Quand créer des fichiers NFO (et quand ne pas le faire)

    Tu n'as pas besoin de fichiers NFO pour tout — les scrapers trouvent la bonne correspondance dans 90 % des cas. Voici quatre scénarios où les fichiers NFO valent la peine : 1. Le scraper choisit le mauvais film/la mauvaise série et la fonction « Modifier » dans l'interface de Kodi ne fonctionne pas (fréquent pour les séries avec plusieurs remakes). 2. Un film ou une série n'est pas du tout sur TMDB/TheTVDB (versions régionales, montages de fans, contenu de niche). 3. Tu veux des regroupements de collections personnalisés au-delà de ce que TMDB propose (par exemple, ta propre collection « Meilleurs films de science-fiction des années 90 »). 4. Tu stockes des métadonnées que tu ne peux pas te permettre de perdre — la bibliothèque de Kodi peut être entièrement reconstruite à partir des fichiers NFO si la base de données est corrompue. Pour les bibliothèques de moins de 200 éléments, les fichiers NFO sont généralement superflus. Pour les bibliothèques de plus de 1 000 éléments où tu as passé du temps à corriger les métadonnées, ils sont une assurance.

    movie.nfo — le NFO le plus utile

    Format NFO pour les films. Place le fichier à côté du film avec le nom movie.nfo (ou Titre (Année).nfo qui correspond au nom du fichier vidéo — les deux fonctionnent, movie.nfo est la convention) :

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <movie>
      <title>Blade Runner</title>
      <originaltitle>Blade Runner</originaltitle>
      <year>1982</year>
      <plot>A blade runner must pursue and terminate four replicants...</plot>
      <runtime>117</runtime>
      <mpaa>R</mpaa>
      <genre>Science Fiction</genre>
      <genre>Thriller</genre>
      <director>Ridley Scott</director>
      <actor>
        <name>Harrison Ford</name>
        <role>Rick Deckard</role>
      </actor>
      <uniqueid type="tmdb" default="true">78</uniqueid>
      <uniqueid type="imdb">tt0083658</uniqueid>
      <set>
        <name>Blade Runner Collection</name>
      </set>
    </movie>

    Le champ <uniqueid type="tmdb"> force Kodi à utiliser l'entrée TMDB spécifique au lieu de faire une correspondance approximative du titre. C'est la balise la plus utile — si tu n'écris qu'une seule chose dans tes fichiers NFO, écris celle-là.

    tvshow.nfo — Remplacements au niveau de la série

    Les fichiers NFO pour les séries télé vont dans le dossier racine de la série, nommés tvshow.nfo. Le format est similaire à movie.nfo, mais avec des champs spécifiques à la série :

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <tvshow>
      <title>Breaking Bad</title>
      <year>2008</year>
      <plot>A high school chemistry teacher diagnosed with cancer...</plot>
      <genre>Crime</genre>
      <genre>Drama</genre>
      <uniqueid type="tvdb" default="true">81189</uniqueid>
      <uniqueid type="tmdb">1396</uniqueid>
      <uniqueid type="imdb">tt0903747</uniqueid>
      <status>Ended</status>
      <studio>AMC</studio>
    </tvshow>

    Le <uniqueid type="tvdb"> est l'identifiant le plus fiable pour les séries télé, car TheTVDB est le scraper par défaut de Kodi pour la plupart des utilisateurs.

    NFO par épisode (rarement nécessaire)

    Les fichiers NFO par épisode sont rarement nécessaires — le NFO de la série et les métadonnées d'épisode récupérées par le scraper couvrent la plupart des cas. Utilise-les seulement quand un épisode spécifique est mal identifié et que rafraîchir la série ne corrige pas le problème. Format : place Show - s01e01.nfo à côté du fichier vidéo :

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <episodedetails>
      <title>Pilot</title>
      <season>1</season>
      <episode>1</episode>
      <aired>2008-01-20</aired>
      <plot>Walter White, a struggling high school chemistry teacher...</plot>
      <uniqueid type="tvdb" default="true">349232</uniqueid>
    </episodedetails>

    Balises de métadonnées avancées

    Au-delà des balises de base <title>, <year> et <plot>, Kodi comprend un riche ensemble de champs de métadonnées qui te permettent de personnaliser l'affichage des éléments dans ta bibliothèque. Les plus utiles pour les utilisateurs avancés : <originaltitle> — le titre dans la langue originale, affiché dans les pages d'info à côté du titre localisé. Essentiel pour les films étrangers où le titre du distributeur local diffère grandement de l'original (pense à Spirited Away vs Sen to Chihiro no Kamikakushi). <sorttitle> — remplace le comportement de tri par défaut. Utilise-la pour forcer « The Matrix » à être trié sous « M » au lieu de « T », ou pour regrouper les suites ensemble peu importe leurs titres canoniques. Exemple : trier tous les films Mission: Impossible comme « Mission Impossible 01 », « Mission Impossible 02 », etc. <tagline> — le court slogan marketing affiché sous le titre (pense à « In space, no one can hear you scream »). Ça ajoute une touche de finition aux pages d'info de ta bibliothèque. <status> pour les séries télé — « Continuing », « Ended » ou « Returning Series ». Permet à l'habillage de Kodi d'afficher des indicateurs appropriés sur les fiches des séries. <premiered> — la date de première diffusion officielle. Utile pour les séries d'anthologie ou les animes où la date du scraper est erronée. <fileinfo> — blocs de métadonnées de fichier pré-mis en cache (codec, résolution, pistes de langue audio). Utile si tu crées des fichiers NFO par programmation et que tu veux sauter l'analyse des médias lors du premier scan de Kodi.

    Plusieurs sources de cotes côte à côte

    Kodi 19+ prend en charge l'affichage simultané de plusieurs sources de cotes. Ajoute un bloc <ratings> avec autant de sources que tu le désires :

    <ratings>
      <rating name="imdb" max="10" default="true">
        <value>8.1</value>
        <votes>826543</votes>
      </rating>
      <rating name="themoviedb" max="10">
        <value>8.2</value>
        <votes>9876</votes>
      </rating>
      <rating name="rottentomatoes" max="100">
        <value>89</value>
        <votes>410</votes>
      </rating>
    </ratings>

    Les habillages par défaut de Kodi affichent la cote « default » en évidence et te permettent de parcourir les autres dans la boîte de dialogue d'info. Pour les bibliothèques où tu as sélectionné les sources auxquelles tu fais confiance, c'est une amélioration significative de la qualité de vie par rapport à la cote unique qui provient du scraper.

    Fichiers NFO pour la musique (artiste, album, piste)

    La musique a son propre format NFO à trois niveaux — artiste, album et par piste. Le NFO de niveau artiste va à la racine du dossier de l'artiste, nommé artist.nfo :

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <artist>
      <name>Pink Floyd</name>
      <disambiguation>British rock band</disambiguation>
      <formed>1965</formed>
      <disbanded>2014</disbanded>
      <genre>Progressive Rock</genre>
      <musicBrainzArtistID>83d91898-7763-47d7-b03b-b92132375c47</musicBrainzArtistID>
    </artist>

    L'ID d'artiste MusicBrainz permet à la bibliothèque musicale de Kodi de faire le lien avec l'entrée canonique sans fuzzy matching — extrêmement utile pour les artistes ayant des noms communs ou pour les groupes multiples. Le NFO de niveau album (album.nfo dans le dossier de l'album) accepte des champs similaires en plus de <title>, <year>, <musicBrainzAlbumID>. Le NFO par piste est rarement utilisé; le modèle musical de Kodi, basé sur les balises, gère les pistes via les balises ID3 plutôt que par des fichiers NFO.

    Pièges courants avec les NFO

    Quatre erreurs courantes qui brisent les fichiers NFO en pratique : 1. XML invalide — caractères &, < ou > non échappés à l'intérieur des balises <plot> ou <title>. La solution : encadre le contenu textuel avec <![CDATA[...]]> ou échappe-le manuellement (&amp;, &lt;, &gt;). 2. Mauvais encodage — les fichiers NFO DOIVENT être en UTF-8. Certains éditeurs de texte Windows enregistrent en Windows-1252 par défaut, ce qui corrompt les caractères non-ASCII (accents, cyrillique, japonais). Utilise un éditeur compatible UTF-8 (VS Code, Sublime Text, Notepad++). 3. Déclaration XML manquante — la première ligne <?xml version="1.0" encoding="UTF-8" standalone="yes"?> est requise. Sans elle, certaines versions de Kodi ignorent silencieusement le fichier. 4. Conflits entre le NFO et les métadonnées du scraper — si un NFO et un scraper fournissent des données pour le même champ, Kodi priorise le NFO. C'est généralement ce que tu veux, mais ça surprend parfois les utilisateurs qui ne réalisent pas que leur NFO écrase les mises à jour en ligne. Pour revenir aux données du scraper, supprime le NFO et rafraîchis.

    Emplacement des fichiers NFO avec tes médias

    Movies/
    └── Blade Runner (1982)/
        ├── Blade Runner (1982).mkv
        ├── movie.nfo               ← ID TMDB verrouillé
        └── poster.jpg
    
    TV Shows/
    └── Breaking Bad (2008)/
        ├── tvshow.nfo              ← ID TVDB verrouillé
        ├── Season 01/
        │   ├── Breaking Bad - s01e01 - Pilot.mkv
        │   └── Breaking Bad - s01e01.nfo   ← remplacement par épisode (rare)
        └── Season 02/

    Don't want to hand-write NFOs? ou utilise l'éditeur NFO de FileBot.

    Dépannage du nommage pour Kodi

    Six problèmes courants expliquent environ 85 % des plaintes liées au nommage sur Kodi. Chacun a une cause prévisible et une solution claire.

    La bibliothèque ne s'analyse pas du tout — rien ne se passe lors d'une nouvelle analyse

    Causes probables

    • Type de contenu de la source réglé sur 'Aucun'
    • Chemin de la source inaccessible (partage réseau non monté, lecteur renommé)
    • Add-on du scraper désactivé ou désinstallé
    • Service Kodi en pause

    Étapes de résolution

    1. Clic droit sur la source → 'Changer le contenu' → régler sur Films / Séries TV / Musique
    2. Vérifie que le chemin est accessible : Fichiers → navigue manuellement jusqu'à la source
    3. Paramètres → Add-ons → Mes add-ons → Fournisseurs d'informations → vérifie que le scraper est activé
    4. Redémarre Kodi si le problème persiste
    Le film s'affiche avec la mention 'Aucune information trouvée'

    Causes probables

    • Année manquante ou dans un mauvais format
    • Le titre contient des caractères spéciaux qui embrouillent le scraper
    • Film absent de TMDB (sortie régionale rare)

    Étapes de résolution

    1. Ajoute (YYYY) entre parenthèses au dossier et au nom de fichier
    2. Retire les tags de la scène : 'Title.YYYY.BluRay.x264-SPARKS' → 'Title (YYYY)'
    3. Crée un fichier movie.nfo avec <uniqueid type='tmdb'> qui pointe vers le bon ID, ou <uniqueid type='imdb'> si TMDB ne l'a pas
    Mauvaise série associée (The Office US vs The Office UK)

    Causes probables

    • Année manquante dans le dossier de la série
    • Le scraper a choisi la version la plus populaire
    • Entrée obsolète d'un précédent scrape erroné

    Étapes de résolution

    1. Ajoute (Year) au nom du dossier de la série
    2. Crée un fichier tvshow.nfo avec <uniqueid type='tvdb' default='true'> réglé sur le bon ID
    3. Menu contextuel de la bibliothèque → 'Rafraîchir' sur la série, ou 'Nettoyer la bibliothèque' pour retirer les entrées obsolètes
    Épisodes non associés mais la série est correcte

    Causes probables

    • Formats de noms de fichiers mélangés dans la même saison
    • Jeton d'épisode mal tapé (s01E01 avec casse mixte, ou s1e1 sans zéro de remplissage)
    • Fichiers à la racine de la série au lieu d'un sous-dossier Season XX

    Étapes de résolution

    1. Standardise tous les épisodes d'une saison sur un seul format. Le format sXXeYY en minuscules est recommandé
    2. Utilise un renommeur par lots pour normaliser la saison entière
    3. Déplace les épisodes dans des sous-dossiers 'Season XX/' s'ils sont à la racine de la série
    Épisodes d'anime associés aux mauvaises saisons

    Causes probables

    • Le scraper par défaut de Kodi (TheMovieDB / TheTVDB) ne comprend pas la structure d'AniDB
    • Scraper Hama non installé ou non sélectionné comme scraper de la source
    • Tag [anidbid-X] manquant dans le nom du dossier pour une série au titre ambigu

    Étapes de résolution

    1. Installe Hama depuis le dépôt d'add-ons de Kodi
    2. Modifier la source → règle le 'Fournisseur d'informations' sur Hama
    3. Ajoute [anidbid-X] au dossier de la série (trouve l'ID sur anidb.net)
    4. Clic droit sur la série → 'Rafraîchir' pour relancer le scrape avec le nouveau fournisseur
    La bibliothèque affiche d'anciennes métadonnées erronées même après avoir corrigé les fichiers

    Causes probables

    • Kodi met en cache les métadonnées du scrape jusqu'à ce que tu les rafraîchisses explicitement
    • Des entrées obsolètes d'une association erronée précédente sont encore dans la base de données
    • Champ verrouillé — modifié manuellement, puis censé se mettre à jour automatiquement

    Étapes de résolution

    1. Clic droit sur l'élément → 'Rafraîchir' (récupère à nouveau les données du scraper)
    2. Menu contextuel de la bibliothèque → 'Nettoyer la bibliothèque' pour retirer les entrées orphelines
    3. Pour une réinitialisation complète : Paramètres → Média → Bibliothèque → 'Nettoyer la bibliothèque' globalement, puis relance une analyse

    L'alternative de 60 secondes

    Tout ce qui précède est la méthode manuelle : comprendre les scrapers, taper les bons noms de fichiers, créer des fichiers NFO pour les cas tenaces. Ça vaut la peine de le faire une fois pour une nouvelle bibliothèque. C'est pénible pour une bibliothèque de 2 000 fichiers héritée d'années de téléchargements non structurés.

    La méthode manuelle

    À la main, renommer un élément de la bibliothèque Kodi prend environ 30 à 60 secondes : vérifier le titre, formater l'année, utiliser le bon format sXXeYY et écrire des fichiers NFO pour les quelques cas problématiques. Une bibliothèque de 2 000 fichiers, c'est une longue fin de semaine.

    La méthode de 60 secondes

    RenameFlow renomme tes fichiers en quelques secondes. Glisse-dépose un dossier, l'analyseur détecte s'il s'agit de films / séries TV / animes, interroge TMDB / TheTVDB / AniList / MusicBrainz en parallèle, et affiche un aperçu du renommage compatible Kodi. Confirme, et les fichiers sont renommés localement sur ton disque via l'API File System Access — aucun upload. Gratuit pour les 15 premiers fichiers par jour ; paiement unique de 69 EUR pour un usage illimité. Pour la génération de fichiers NFO, RenameFlow ne les écrit pas directement — mais il produit des noms de fichiers qui se scannent parfaitement avec les scrapers par défaut de Kodi, ce qui élimine le besoin de fichiers NFO dans 90 % des cas. Pour les 10 % restants, écrire le NFO à la main est un effort unique.

    See Tarifs de RenameFlow.

    Gratuit : 15 fichiers/jour, compte gratuit en 30 secondes, aucun upload.

    Essayer RenameFlow gratuitement

    Nommage pour Kodi — Foire aux questions

    Quelle est la règle de nommage la plus importante pour Kodi?
    Choisis un modèle de nom de fichier par type de contenu et applique-le constamment. Le scanner de Kodi est indulgent avec les variations de modèles entre les bibliothèques, mais des modèles incohérents dans un même dossier de série ou de film causent les problèmes les plus fréquents où seulement la moitié d'une saison est reconnue.
    Dois-je vraiment installer Hama pour les animes dans Kodi?
    Pour les animes saisonniers modernes qui correspondent bien aux saisons de TheMovieDB ou TheTVDB (Demon Slayer, Spy x Family, Jujutsu Kaisen), non — les scrapers par défaut s'en chargent. Pour les séries à numérotation absolue (One Piece, Naruto Shippuden, Detective Conan, Bleach), oui — Hama est la seule option réaliste. L'installation est une affaire de 10 minutes, faite une seule fois.
    Quelle est la différence entre movie.nfo et Title (Year).nfo?
    Les deux fonctionnent identiquement. movie.nfo est la convention parce qu'il est indépendant du nom de fichier (renomme le fichier vidéo et le NFO s'applique toujours). Title (Year).nfo lie le NFO à ce nom de fichier vidéo exact — utile si tu as plusieurs fichiers vidéo dans un dossier et que tu veux des NFO par fichier. La plupart des utilisateurs utilisent movie.nfo.
    Dois-je utiliser Season 0 ou Season 00 pour les épisodes spéciaux?
    Les deux fonctionnent — Kodi les traite identiquement. Season 00 se classe bien à côté de Season 01, Season 02, etc. Season 0 est plus court. Choisis-en un et applique-le à toutes tes séries par souci de cohérence.
    Pourquoi le scan de Kodi est-il plus lent que celui de Plex sur les mêmes fichiers?
    Kodi communique davantage avec les scrapers que les agents de Plex — il récupère les métadonnées et les illustrations de chaque épisode séparément. Pour accélérer le processus, diminue la résolution des illustrations dans les paramètres du scraper, désactive le téléchargement de 'fanart' si tu ne l'utilises pas, et lance les scans pendant les heures creuses lorsque les bases de données externes sont plus réactives.
    Kodi peut-il partager sa bibliothèque sur plusieurs appareils?
    Oui, via un backend MySQL (configuration avancée) ou via l'exportation NFO + illustrations intégrée. Avec l'exportation NFO activée dans les paramètres, chaque instance de Kodi pointant vers les mêmes fichiers lit des métadonnées identiques sans avoir à scraper de nouveau. C'est le moyen le plus rapide de garder une bibliothèque partagée familiale cohérente sur plusieurs téléviseurs.
    Puis-je importer une bibliothèque nommée pour Plex ou Jellyfin dans Kodi sans tout renommer?
    En grande partie, oui. Le nommage des dossiers de films et les conventions sXXeYY pour les séries se transfèrent directement. Les principales incompatibilités : les éditions entre accolades de Plex ({edition-X}) et les tags [edition-X] de Jellyfin sont tous deux ignorés par Kodi — l'info sur l'édition n'est pas conservée à moins de l'écrire dans un NFO. Pour une migration typique de Plex vers Kodi, attends-toi à passer 30 minutes à convertir les éditions de films; tout le reste se transfère sans problème.
    Puis-je automatiser le nommage pour les nouveaux téléchargements Kodi?
    Oui. Deux approches. Pour les chaînes automatisées : Sonarr + Radarr pré-nomment les fichiers avant qu'ils n'arrivent dans ta bibliothèque Kodi — configure la convention de nommage de Sonarr avec les modèles Kodi de ce guide. Pour une révision manuelle : utilise RenameFlow comme outil de batch lors de l'importation. Les deux approches produisent des noms compatibles avec Kodi; le choix dépend du niveau de révision manuelle que tu souhaites.
    Puis-je utiliser Sonarr et Radarr pour gérer une bibliothèque Kodi?
    Oui, et c'est l'un des flux de travail les plus populaires. Configure les modèles de nommage de Sonarr et Radarr pour qu'ils correspondent aux conventions de Kodi (sXXeYY pour les épisodes, Title (Year) pour les films), fais-les pointer vers les mêmes dossiers que Kodi scrape, et active les mises à jour de la bibliothèque Kodi via la fonction de connexion des *arrs. Sonarr peut déclencher une actualisation de la bibliothèque Kodi après l'arrivée de chaque nouvel épisode, ainsi ta bibliothèque reste à jour sans scans manuels.
    Quelle est la différence entre Kodi et Plex/Jellyfin pour le nommage?
    Trois différences principales. Premièrement, Kodi n'a pas de service de métadonnées en ligne — ta bibliothèque réside entièrement sur ton appareil ou ton réseau. Deuxièmement, Kodi accepte plus de variations de modèles de noms de fichiers que le regex strict de Plex, ce qui est plus indulgent mais aussi moins prévisible en cas de problème. Troisièmement, le système de fichiers NFO de Kodi te donne un contrôle local total pour outrepasser toute métadonnée récupérée par un scraper, ce qui n'a pas d'équivalent dans Plex (et n'est que partiellement supporté dans Jellyfin). Si tu accordes de l'importance à une structure stricte et à la synchro en ligne, Plex l'emporte. Si tu préfères le contrôle local et un haut niveau de personnalisation, Kodi l'emporte. Jellyfin se situe entre les deux.

    → Voir toutes les FAQ de RenameFlow