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

    Kodi est réputé pour sa flexibilité quant au nommage de tes fichiers — et c'est précisément pourquoi tant de bibliothèques se cassent. Le scanner accepte une douzaine de modèles valides mais les applique de manière incohérente selon les scrapers. Choisis le bon modèle pour ton scraper et Kodi trouvera les affiches, résumés et titres d'épisodes en quelques secondes. Fais-le mal et tu fixeras "aucune information trouvée" pendant des heures.

    Ce guide est la référence pratique que nous aurions aimé avoir en créant 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 sur le comportement de Kodi 21 (Omega), avec des notes de compatibilité pour Kodi 20 (Nexus) et les versions antérieures.

    À 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 bazar existant, ou que tu viennes de Plex ou Jellyfin en te demandant pourquoi "les modèles que j'ai toujours utilisés" ont soudainement cessé de fonctionner.

    Mis à jour en 2026 Vérifié avec le wiki de Kodi 21 (Omega) Créé par l'équipe derrière RenameFlow ~12 min de lecture

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

    Commencer gratuitement

    Les bases du nommage sur Kodi

    Trois concepts sur la manière dont Kodi scanne diffèrent suffisamment de Plex et Jellyfin pour mériter leur propre explication. Saute cette section et tu continueras à rencontrer les trois mêmes échecs : mauvais scraper pour ta bibliothèque, type de contenu mal configuré, et des fichiers NFO inattendus qui écrasent tes scrapes.

    Des 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. Par défaut, on trouve le scraper The Movie Database pour les films, le scraper The Movie Database ou le scraper The TVDB pour les séries TV, 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 que celui utilisé dans Plex) pour l'intégration d'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 scrapée par différents add-ons sur des appareils Kodi du 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 courante.

    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 distants. Quand tu ajoutes une source, tu indiques à Kodi quel type de contenu elle contient (Movies, TV shows, Music videos, Music, None) 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 reconnus : un dossier contenant à la fois des films et des séries TV ne peut être analysé que comme l'un ou l'autre. La solution est de séparer les contenus mixtes 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 échecs

    Quatre règles qui évitent 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 TV dans un seul dossier que Kodi analyse en tant que « Movies ». Rule 2 — Définis le type de contenu et le scraper AVANT la première analyse. Les modifier plus tard nécessite un « Refresh » 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 TV, en minuscules, avec des zéros non significatifs. Kodi accepte plus de variantes que Plex, mais des schémas prévisibles évitent les cas limites des scrapers. Rule 4 — Quand un scraper échoue de manière répétée sur un élément spécifique, dépose un fichier NFO à côté. Les fichiers NFO remplacent entièrement les scrapers — c'est la porte de sortie de Kodi.

    Need it from zero? guide pas à pas.

    Nommer les films pour Kodi

    Kodi accepte deux organisations valides pour les films — un dossier par film et une structure plate. 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 (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 locaux de Kodi : poster.jpg, fanart.jpg, clearart.png, landscape.jpg. Les sous-titres suivent la convention Title (Year).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 renvoie les correspondances de titres en double triées par popularité, et Kodi choisira silencieusement la mauvaise. Format : Title (YYYY). Les crochets [YYYY], les points Title.YYYY et les années seules fonctionnent avec certains scrapers mais échouent avec d'autres — les parenthèses sont universelles. Pour les films totalement 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 (stacked) (spécifique à Kodi)

    Kodi prend en charge nativement les films en plusieurs parties stockés dans des fichiers séparés — une fonctionnalité de l'ère du rip de DVD qui reste utile pour les films très longs (LotR Extended, Once Upon a Time in America) répartis sur plusieurs disques. Utilise les schémas 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 à la suite comme un seul film et les scrape comme une seule entrée dans la médiathèque. Le format de nommage est insensible à la casse et accepte cd, part, dvd, pt et quelques autres — mais cd1/cd2 est le plus sûr et le mieux documenté.

    Plusieurs versions du même film

    Kodi n'a pas la fonctionnalité de fusion multi-version que proposent Plex et Jellyfin — tu ne peux pas stocker une version 1080p et une 4K sous une seule entrée et laisser Kodi choisir la bonne pour le client. Chaque fichier devient sa propre entrée dans la médiathèque. Deux solutions de contournement : Approche 1 — Garde une version par film dans la médiathèque de Kodi, et stocke les autres versions en dehors de la source scrapée. Change la source de la médiathèque manuellement quand tu veux l'autre qualité. Approche 2 — Sépare en deux médiathèques (Movies-1080p, Movies-4K) avec deux sources. Utilise les profils Kodi ou les raccourcis de skin pour basculer entre elles. 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 dans ton workflow, c'est le seul domaine où Plex et Jellyfin sont objectivement plus performants.

    Sagas de films et collections

    Kodi gère 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 depuis les métadonnées TMDB scrapé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 responsables de la plupart des échecs de scraping

    1. Type de contenu de la source défini sur "Aucun" ou sur le mauvais type. Sans type de contenu, Kodi ne le scanne pas du tout comme des films. 2. Année manquante ou entre crochets. "Inception 2010.mkv" est trouvé par chance ; "Inception [2010].mkv" échoue avec le scraper TMDB. 3. Fichier de film à la racine de la source sans dossier. Ça fonctionne pour la correspondance mais casse les illustrations, les NFO et les fonctionnalités de fichiers en plusieurs parties. 4. Entrées obsolètes d'un précédent scraping incorrect. Même après avoir corrigé les noms, Kodi affiche l'ancienne mauvaise correspondance. Solution : menu contextuel de la médiathèque → "Nettoyer la médiathèque" → puis relancer un scan.

    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 manuelle — renomme un dossier de films en quelques secondes

    Commencer gratuitement

    Nommer les séries TV pour Kodi

    C'est pour les séries TV que la flexibilité de Kodi est la plus utile — plusieurs formats de nom de fichier valides sont acceptés, et le scraper est tolérant aux variations mineures. Le compromis : quand quelque chose ne correspond pas, la cause est rarement évidente. Cette section couvre les formats sûrs et les cas où Kodi diffère de Plex/Jellyfin.

    Structure des dossiers

    Structure standard à deux niveaux : un dossier pour la série, puis des sous-dossiers par 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 permet de 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 zéro initial pour les nombres à deux chiffres, ou "Season 0" (ou "Season 00") pour les épisodes spéciaux. Kodi accepte à la fois "Season 0" et "Season 00" ; choisis-en un et sois cohérent. Contrairement à la convention de dossier "Specials" de Plex, Kodi ne reconnaît PAS un 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 pour tous les scrapers. Le titre de l'épisode dans le nom de fichier n'est là que 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 (abordé plus loin).

    Épisodes spéciaux dans Season 0

    Les épisodes spéciaux, OAV, épisodes pilotes, coulisses et contenus 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 spécifique (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 lisible 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 également. Les deux s'étendent aux épisodes triples ou quadruples si nécessaire (e15-e16-e17), bien que ce soit rare en pratique.

    Séries quotidiennes (basées sur la date)

    Les séries quotidiennes (talk-shows, actualités) 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 la série quotidienne. Assure-toi que la source utilise le scraper TheTVDB, et non TheMovieDB — TheMovieDB a un support limité pour les séries quotidiennes.

    Exemples complets

    TV Shows/
    ├── 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 TV normales, ce qui fonctionne pour les shonen saisonniers modernes mais échoue avec les séries à numérotation absolue (One Piece, Détective 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.

    Configurer 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 TV → 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 pointant vers ton dossier d'animes, définis le type de contenu sur "Séries TV", 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é via les paramètres du scraper — AniDB en premier est recommandé pour les séries à numérotation absolue ; TVDB en premier pour les séries dont tu veux les métadonnées en anglais (doublage). 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'épisodes absolus paddés sur 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, en ignorant la recherche approximative par titre. Trouve l'ID sur anidb.net en cherchant la série — l'ID se trouve dans l'URL. Le padding sur 4 chiffres n'est pas requis pour la détection mais permet de conserver un ordre de tri dans le système de fichiers qui correspond à l'ordre de lecture. Sans padding, le fichier e1064 est trié après e11 au lieu d'être après e1063, ce qui rend la navigation dans le dossier déroutante en dehors de Kodi.

    Saisons découpées et arcs narratifs

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

    Anime/
    ├── Attack on Titan [anidbid-9541]/
    │   ├── Season 01/
    │   ├── Season 02/
    │   ├── Season 03/
    │   └── Season 04/   ← Partie 1 de la Saison Finale
    ├── Attack on Titan - Final Season Part 2 [anidbid-15689]/
    │   └── Season 01/   ← AniDB traite la Partie 2 comme une entrée séparée
    └── Demon Slayer (2019)/
        ├── Season 01/
        ├── Season 02/   ← Arc du Train de l'Infini + Arc du Quartier des Plaisirs
        └── 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 pour Plex et Jellyfin. Le Universal Album Scraper (par défaut dans Kodi 19+) lit les tags ID3 et interroge MusicBrainz et TheAudioDB pour obtenir les illustrations et les métadonnées. Corrige d'abord les tags, et ne t'occupe de la structure des dossiers qu'après.

    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" (le tag Album Artist est "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 sur les compilations), Year, Genre, Disc Number, MusicBrainz IDs. Les ID MusicBrainz (Album ID et Recording ID, intégrés en tant que trames TXXX ID3v2.3 ou commentaires Vorbis) permettent au Universal Album Scraper de Kodi de faire une correspondance exacte, en é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 tagueur 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 surcharge 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 autrement changer avec les mises à jour des bases de données en ligne. Plex n'a pas 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 gèrent correctement 90 % des correspondances. Voici les quatre scénarios où les fichiers NFO valent le coup : 1. Le scraper choisit le mauvais film/la mauvaise série et la fonction "Modifier" dans l'interface de Kodi ne sauvegarde pas le changement (fréquent pour les séries avec de nombreux remakes). 2. Un film ou une série n'est pas du tout sur TMDB/TheTVDB (sorties régionales, fan edits, contenu de niche). 3. Tu veux des regroupements de collections personnalisés au-delà de ce que propose TMDB (ton propre ensemble "Meilleure SF des années 90", par exemple). 4. Tu stockes des métadonnées que tu ne peux pas te permettre de perdre — la bibliothèque de Kodi peut être reconstruite uniquement à 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 sous le nom movie.nfo (ou Title (Year).nfo pour correspondre 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 d'une correspondance floue sur le titre. C'est la balise la plus utile — si tu ne dois écrire qu'une seule chose dans tes fichiers NFO, écris celle-ci.

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

    Les fichiers NFO pour les séries TV se placent 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>

    La balise <uniqueid type="tvdb"> est le verrouillage le plus fiable pour les séries TV, car TheTVDB est le scraper TV 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 uniquement lorsqu'un épisode spécifique est mal identifié et que l'actualisation de la série ne résout pas le problème. Format : place le fichier 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>, <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é sur les pages d'info à côté du titre localisé. Crucial 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 indépendamment de leurs titres officiels. Exemple : trier tous les films Mission: Impossible comme "Mission Impossible 01", "Mission Impossible 02", etc. <tagline> — la courte phrase d'accroche marketing affichée sous le titre (pense à "In space, no one can hear you scream"). Ajoute une touche de finition aux pages d'info de ta bibliothèque. <status> pour les séries TV — "Continuing", "Ended" ou "Returning Series". Permet au skin 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 fausse. blocs <fileinfo> — métadonnées de fichier pré-mises en cache (codec, résolution, pistes audio). Utile si tu génères des fichiers NFO par programme et veux sauter l'analyse des médias au premier scan de Kodi.

    Plusieurs sources de notation côte à côte

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

    <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 skins par défaut de Kodi affichent la note "default" en évidence et te permettent de parcourir les autres dans la boîte de dialogue d'information. 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 note unique provenant 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 au niveau de l'artiste se place à 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 correspondance approximative — extrêmement utile pour les artistes aux noms courants ou ayant plusieurs formations. Le NFO au niveau de l'album (album.nfo dans le dossier de l'album) accepte des champs similaires plus <title>, <year>, <musicBrainzAlbumID>. Le NFO par piste est rarement utilisé ; le modèle musical de Kodi, basé sur les tags, gère les pistes via les tags ID3 plutôt que par des fichiers NFO.

    Pièges courants avec les NFO

    Quatre erreurs qui cassent les fichiers NFO en pratique : 1. XML invalide — caractères &, < ou > non échappés dans les balises <plot> ou <title>. La solution : encapsule le contenu textuel dans <![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 obligatoire. Sans elle, certaines versions de Kodi ignorent silencieusement le fichier. 4. Conflits entre NFO et métadonnées du scraper — si un NFO et un scraper fournissent des données pour le même champ, Kodi donne la priorité au NFO. C'est généralement ce que tu veux, mais cela 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 actualise.

    Comment les fichiers NFO sont placés à côté de 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 utiliser l'éditeur NFO de Filebot.

    Dépannage du nommage pour Kodi

    Six problèmes couvrent environ 85 % des plaintes concernant le nommage sur Kodi. Chacun a une cause prévisible et une solution simple.

    La bibliothèque ne scanne rien du tout — rien ne se passe lors d'un nouveau scan

    Causes probables

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

    Étapes de résolution

    1. Clic droit sur la source → 'Changer le contenu' → définir 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
    Un film s'affiche comme 'Aucune information trouvée'

    Causes probables

    • Année manquante ou au 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 (AAAA) entre parenthèses au dossier et au nom de fichier
    2. Supprime les tags de la scène : 'Title.YYYY.BluRay.x264-SPARKS' → 'Title (YYYY)'
    3. Crée un fichier movie.nfo avec <uniqueid type='tmdb'> pointant vers le bon ID, ou <uniqueid type='imdb'> si TMDB ne l'a pas
    Mauvaise série identifié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 scan incorrect

    Étapes de résolution

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

    Causes probables

    • Formats de noms de fichiers mélangés au sein d'une même saison
    • Identifiant d'épisode mal saisi (s01E01 avec casse mixte, ou s1e1 sans padding)
    • Fichiers à la racine de la série au lieu d'un sous-dossier Saison 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 lot (batch renamer) pour normaliser toute la saison
    3. Déplace les épisodes dans des sous-dossiers 'Saison 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 → définir 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 rescanner 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 scannées jusqu'à ce que tu les rafraîchisses explicitement
    • Des entrées obsolètes d'une précédente identification incorrecte sont toujours 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 supprimer les entrées orphelines
    3. Pour une réinitialisation complète : Paramètres → Média → Bibliothèque → 'Nettoyer la bibliothèque' globalement, puis relancer un scan

    L'alternative en 60 secondes

    Tout ce qui précède est la méthode manuelle : comprendre les scrapers, saisir les bons noms de fichiers, écrire des fichiers NFO pour les cas récalcitrants. Ça vaut le coup 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, obtenir le bon format sXXeYY, et écrire des fichiers NFO pour les quelques cas problématiques. Une bibliothèque de 2 000 fichiers, c'est un long week-end de travail.

    La méthode en 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 Kodi — Questions fréquentes

    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 de manière cohérente. Le scanner de Kodi est tolérant aux variations de modèles entre les bibliothèques, mais des modèles incohérents au sein d'un même dossier de série ou de film provoquent les échecs les plus courants où seule la moitié d'une saison est identifiée.
    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 avec une numérotation absolue (One Piece, Naruto Shippuden, Detective Conan, Bleach), oui — Hama est la seule option réaliste. L'installation ne prend que 10 minutes, une seule fois.
    Quelle est la différence entre movie.nfo et Title (Year).nfo ?
    Les deux fonctionnent de manière identique. movie.nfo est la convention car il est indépendant du nom de fichier (renomme le fichier vidéo et le NFO s'appliquera toujours). Title (Year).nfo lie le NFO à ce nom de fichier vidéo précis — utile si tu as plusieurs fichiers vidéo dans un même dossier et que tu veux des NFO par fichier. La plupart des utilisateurs emploient movie.nfo.
    Dois-je utiliser Season 0 ou Season 00 pour les épisodes spéciaux ?
    Les deux fonctionnent — Kodi les traite de manière identique. Season 00 se trie proprement à côté de Season 01, Season 02, etc. Season 0 est plus court. Choisis-en un et applique-le à toutes tes séries pour rester cohérent.
    Pourquoi le scan de Kodi est-il plus lent que celui de Plex sur les mêmes fichiers ?
    Kodi interroge les scrapers de manière plus 'bavarde' que les agents de Plex — il récupère les métadonnées et les illustrations pour chaque épisode séparément. Accélère le processus en réduisant la résolution des illustrations dans les paramètres du scraper, en désactivant le téléchargement des 'fanart' si tu ne les utilises pas, et en lançant 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'export intégré des NFO et des illustrations. Avec l'export NFO activé dans les paramètres, chaque instance de Kodi pointant vers les mêmes fichiers lit des métadonnées identiques sans avoir à refaire de scraping. C'est le moyen le plus rapide de garder une bibliothèque partagée par la famille cohérente sur plusieurs téléviseurs.
    Puis-je importer une bibliothèque nommée pour Plex ou Jellyfin dans Kodi sans la renommer ?
    Oui, en grande partie. Le nommage des dossiers de films et les conventions sXXeYY pour les séries sont directement compatibles. Les principales incompatibilités : les éditions entre accolades de Plex ({edition-X}) et les balises d'édition de Jellyfin ([edition-X]) sont toutes deux ignorées par Kodi — l'information d'é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 des films ; tout le reste est transféré.
    Puis-je automatiser le nommage pour les nouveaux téléchargements de Kodi ?
    Oui. Il y a 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 un outil de traitement par lot 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 workflows 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 *arr. 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 en matière de 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 les regex stricts de Plex, ce qui est plus tolérant 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 n'importe quelle 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 synchronisation en ligne, Plex l'emporte. Si tu préfères le contrôle local et la profondeur de personnalisation, Kodi l'emporte. Jellyfin se situe entre les deux.

    → Voir toutes les FAQ de RenameFlow