Kodi Naamgevingsgids: Films, TV Series, Anime, Muziek & NFO-bestanden (2026)

Basisprincipes van Kodi Naamgeving

Drie concepten over hoe Kodi scant verschillen genoeg van Plex en Jellyfin om een eigen uitleg te verdienen. Sla dit gedeelte over en je zult steeds tegen dezelfde drie problemen aanlopen: de verkeerde scraper voor je bibliotheek, een verkeerd geconfigureerd contenttype, en onverwachte NFO-bestanden die je scrapes overschrijven.

Scrapers, geen agents

Waar Plex "agents" heeft en Jellyfin "metadata providers", heeft Kodi "scrapers" — add-ons die door de community worden onderhouden en specifieke databases doorzoeken. De standaardinstellingen zijn de The Movie Database scraper voor films, de The Movie Database scraper of The TVDB scraper voor tv-series, en de Universal Album Scraper voor muziek. Anime is de grote uitzondering: Kodi heeft geen ingebouwde anime-scraper, dus installeren gebruikers community-add-ons zoals Hama (dezelfde die in Plex wordt gebruikt) voor AniDB-integratie. De keuze van de scraper gebeurt per bron, niet per bibliotheek. Open een Kodi-videobron in de bestandsbrowser, bewerk deze en kies "Set content" om een scraper toe te wijzen. Dezelfde bron kan door verschillende add-ons worden gescrapet op verschillende Kodi-apparaten in hetzelfde netwerk — wat een van de redenen is waarom "mijn Kodi werkt wel, maar die van mijn vriend niet" zo vaak voorkomt.

Bibliotheekbronnen en contenttypes

De bibliotheek van Kodi wordt opgebouwd uit "sources" die je handmatig toevoegt — mappen, netwerkshares of externe paden. Wanneer je een source toevoegt, vertel je Kodi welk type content deze bevat (Movies, TV shows, Music videos, Music, None) en welke scraper voor die content gebruikt moet worden. Het mixen van contenttypes in één source is een veelvoorkomende oorzaak van niet-gematchte bestanden: een map met zowel films als tv-series kan maar als één van de twee worden gescrapet. De oplossing is om gemixte content op te splitsen in afzonderlijke hoofdmappen, elk als een eigen source met een eigen contenttype. Dit is strakker dan de bibliotheekdetectie per map van Plex, maar voorspelbaarder zodra je je aan de structuur houdt.

Vier regels om 90% van de fouten te voorkomen

Vier regels die de overgrote meerderheid van Kodi-scanproblemen voorkomen: Regel 1 — Eén contenttype per source. Mix geen films en tv-series in een map die Kodi als "Movies" scrapet. Regel 2 — Stel het contenttype en de scraper in VOOR de eerste scan. Als je dit later wijzigt, is een "Refresh" nodig en soms moet de hele database gewist worden om oude, foute matches op te ruimen. Regel 3 — Gebruik sXXeYY voor tv-afleveringen, in kleine letters en met voorloopnullen. Kodi accepteert meer variaties dan Plex, maar voorspelbare patronen voorkomen problemen met de scraper. Regel 4 — Als een scraper herhaaldelijk faalt bij een specifiek item, plaats er dan een NFO-bestand naast. NFO-bestanden overschrijven de scrapers volledig — ze zijn de noodoplossing van Kodi.

Need it from zero? stap-voor-stap handleiding.

Bestandsnamen voor films in Kodi

Kodi accepteert twee geldige structuren voor films — een map per film en een platte structuur. De mappenstructuur wordt aanbevolen om dezelfde redenen als bij Plex en Jellyfin (extra's, posters, NFO-bestanden), plus een Kodi-specifieke functie: 'stacked' films die uit meerdere delen bestaan. Kodi ondersteunt dit standaard, in tegenstelling tot Plex en Jellyfin.

Aanbevolen mappenstructuur

De aanbevolen mappenstructuur:

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

De bestandsnaam komt overeen met de mapnaam. Artwork-bestanden gebruiken de lokale artwork-namen van Kodi: poster.jpg, fanart.jpg, clearart.png, landscape.jpg. Ondertitels volgen de conventie Titel (Jaar).en.srt, .fr.srt etc. — Kodi leest de taalcode uit het achtervoegsel na de punt.

Het (Jaar) achtervoegsel is niet optioneel

Het jaartal tussen haakjes is niet onderhandelbaar, om dezelfde redenen als bij Plex en Jellyfin: TheMovieDB geeft matches voor dubbele titels terug, gesorteerd op populariteit, en Kodi kiest dan stilzwijgend de verkeerde. Formaat: Titel (JJJJ). Vierkante haken [JJJJ], punten Titel.JJJJ en losse jaartallen werken in sommige scrapers, maar niet in andere — ronde haakjes zijn universeel. Voor films die volledig ontbreken op TMDB (zeldzame arthouse, regionale releases), is een NFO-bestand met een handmatig TMDB ID de enige betrouwbare oplossing. Zie de NFO-sectie hieronder.

'Stacked' films uit meerdere delen (alleen Kodi)

Kodi heeft standaard ondersteuning voor films die uit meerdere delen bestaan en als losse bestanden zijn opgeslagen — een functie uit het tijdperk van DVD-rips die nog steeds handig is voor zeer lange films (LotR Extended, Once Upon a Time in America) die over meerdere schijven zijn verdeeld. Gebruik de achtervoegselpatronen 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 speelt ze achter elkaar af als één film en scraped ze als één item in je bibliotheek. Het patroon is niet-hoofdlettergevoelig en accepteert cd, part, dvd, pt en een paar andere — maar cd1/cd2 is de veiligste en best gedocumenteerde optie.

Meerdere versies van dezelfde film

Kodi heeft niet de samengevoegde multi-versie functie die Plex en Jellyfin bieden — je kunt geen 1080p en 4K-versie onder één bibliotheekitem opslaan en Kodi de juiste laten kiezen voor de client. Elk bestand wordt een apart item in je bibliotheek. Twee oplossingen: Methode 1 — Bewaar één versie per film in je Kodi-bibliotheek en sla de andere versies buiten de gescrapete bron op. Wissel handmatig van bibliotheekbron als je de andere kwaliteit wilt. Methode 2 — Splits je bibliotheek op in tweeën (Movies-1080p, Movies-4K) met twee bronnen. Gebruik Kodi-profielen of skin-snelkoppelingen om ertussen te wisselen. Meer werk, maar zo kunnen alle versies naast elkaar bestaan in dezelfde Kodi-installatie. Als multi-versie centraal staat in je workflow, is dit het enige gebied waar Plex en Jellyfin objectief gezien beter presteren.

Filmsets en collecties

Kodi ondersteunt filmsets (ook wel "collecties" genoemd) — Star Wars, Marvel Cinematic Universe, Lord of the Rings — die films groeperen onder één bladerbare collectie. Sets worden automatisch gevuld met collectiedata van TMDB voor films die er deel van uitmaken. Er is geen aanpassing van de bestandsnaam nodig; Kodi leest de collectie-ID uit de gescrapete TMDB-metadata. Voor aangepaste sets (je eigen groepering die niet op TMDB staat), gebruik je een NFO-bestand op filmniveau met een <set>-tag die verwijst naar een aangepaste setnaam.

Vier fouten die de meeste scraping-problemen veroorzaken

1. Brontype ingesteld op "None" of een verkeerd type. Zonder contenttype scant Kodi de bestanden helemaal niet als films. 2. Jaartal ontbreekt of staat tussen haakjes. "Inception 2010.mkv" matcht met geluk; "Inception [2010].mkv" mislukt met de TMDB scraper. 3. Filmbestand in de hoofdmap van de bron zonder eigen map. Dit werkt voor matching, maar verstoort artwork, NFO en de 'stacked part'-functies. 4. Verouderde data van een eerdere foute scrape. Zelfs na het corrigeren van de namen toont Kodi de oude, foute match. Oplossing: contextmenu van de bibliotheek → "Clean library" → en dan opnieuw scannen.

Volledige voorbeelden

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 Plex-equivalenten.

Naamgeving van tv-series voor Kodi

Bij tv-series komt de flexibiliteit van Kodi het best tot zijn recht — meerdere bestandsnaampatronen worden geaccepteerd en de scraper is vergevingsgezind bij kleine afwijkingen. De keerzijde: als iets niet matcht, is de oorzaak zelden duidelijk. Dit gedeelte behandelt de veilige patronen en de gevallen waarin Kodi verschilt van Plex/Jellyfin.

Mapstructuur

Standaardindeling met twee niveaus: een map voor de serie, met daarin submappen per seizoen.

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

Mapnaam voor de serie: "Titel (Jaar)". Het jaartal onderscheidt remakes — The Office UK 2001 vs US 2005, House of Cards UK 1990 vs US 2013. Seizoensmap: "Season XX" met een voorloopnul (twee cijfers), of "Season 0" (of "Season 00") voor specials. Kodi accepteert zowel "Season 0" als "Season 00"; kies er één en wees consequent. In tegenstelling tot de "Specials"-mapconventie van Plex, herkent Kodi de letterlijke mapnaam "Specials" NIET. Gebruik Season 0 of Season 00.

Bestandsnaamformaat voor afleveringen

Kodi's aanbevolen bestandsnaampatroon voor afleveringen: Show Name - sXXeYY - Episode Title.ext Kleine letters, nummers met voorloopnul (twee cijfers), en een optionele afleveringstitel voor de leesbaarheid. Kodi accepteert ook hoofdletters (SXXEYY), Show.S01E01, Show 1x01, Show 101 en diverse andere variaties — maar de vorm met kleine letters en koppeltekens is het meest betrouwbaar voor alle scrapers. De afleveringstitel in de bestandsnaam is alleen voor menselijke leesbaarheid — Kodi's scraper overschrijft deze met de officiële titel van TheTVDB of TheMovieDB. Als de titel die de scraper levert niet klopt, pas deze dan aan via de GUI van Kodi (rechtermuisknop op aflevering → "Information" → "Edit") of via het NFO-bestand (wordt later behandeld).

Specials in Season 0

Specials, OVA's, pilotafleveringen, 'behind-the-scenes' en bonusmateriaal plaats je in "Season 0" (of "Season 00" — Kodi behandelt beide identiek). Gebruik daarin een opeenvolgende nummering: Show - s00e01.mkv, Show - s00e02.mkv. De volgorde van de nummering moet overeenkomen met de specials-lijst van die serie op TheTVDB. De TheTVDB-community beheert deze in een specifieke volgorde (vaak op basis van uitzenddatum); Kodi verwacht dat je die volgorde aanhoudt. Als je specials door elkaar lijken te staan in de interface van Kodi, controleer dan het 'specials'-tabblad van de serie op TheTVDB en pas de s00eYY-nummers van je bestanden aan.

Bestanden met meerdere afleveringen

Voor dubbele afleveringen in één bestand:

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

Kodi maakt één afspeelbaar item aan dat in de metadata aan beide afleveringen is gekoppeld. De bereikvorm (e15-e16) is overzichtelijker; de alternatieve vorm (s05e15-s05e16) werkt ook. Beide kunnen worden uitgebreid voor drie of vier afleveringen (e15-e16-e17), hoewel dat in de praktijk zelden voorkomt.

Dagelijkse programma's (op datum gebaseerd)

Dagelijkse programma's (talkshows, nieuws) zonder traditionele seizoen-/afleveringsnummers gebruiken het datumnotatie YYYY-MM-DD:

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

Kodi's TheTVDB scraper koppelt de datum aan de datumbaseerde index voor dagelijkse programma's. Zorg ervoor dat de bron de TheTVDB scraper gebruikt, niet TheMovieDB — TheMovieDB heeft beperkte ondersteuning voor dagelijkse programma's.

Volledige voorbeelden

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 Jellyfin-equivalenten.

Anime een naam geven voor Kodi (met de Hama Scraper)

Kodi heeft geen ingebouwde anime-scraper. De standaard TheMovieDB- en TheTVDB-add-ons behandelen anime als gewone tv-series, wat werkt voor moderne seizoensgebonden shonen, maar faalt bij series met absolute nummering (One Piece, Detective Conan, Bleach). De oplossing is Hama, dezelfde community-scraper die in Plex wordt gebruikt voor anime-bibliotheken. Door deze eenmalig te installeren, ontgrendel je AniDB-integratie voor al je Kodi-animebronnen.

Hama instellen (10 minuten, eenmalig)

Het instellen van Hama in Kodi duurt ongeveer 10 minuten: 1. Download Hama van github.com/ZeroQI/Hama.bundle (de Plex-bundle werkt voor Kodi via de Kodi Hama add-on wrapper). Alternatief: installeer "Hama" vanuit de officiële Kodi add-on repository als deze beschikbaar is in jouw Kodi-versie. 2. In Kodi: Settings → Add-ons → Install from repository → Information providers → TV shows → installeer Hama (en Hama.bundle als die apart wordt vermeld). 3. Maak een speciale anime-bron aan. Voeg een videobron toe die naar je anime-map verwijst, stel het inhoudstype in op "TV shows" en kies "Hama" als scraper in plaats van TheMovieDB of TheTVDB. 4. Hama gebruikt standaard AniDB als primaire database. Je kunt de prioriteitsvolgorde wijzigen via de instellingen van de scraper. AniDB eerst wordt aanbevolen voor series met absolute nummering; TVDB eerst voor series waarvan je Engelstalige metadata wilt. 5. Voer een scrape uit op de bron. De eerste scrape is traag (Hama doorzoekt meerdere databases) — heb geduld. Volgende scrapes zijn veel sneller.

Absolute afleveringsnummering

Gebruik voor series met absolute nummering zoals One Piece (aflevering 1.064) seizoen 01 met absolute afleveringsnummers, aangevuld tot 4 cijfers:

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

Het [anidbid-X]-achtervoegsel in de mapnaam dwingt Hama om de AniDB-vermelding direct te gebruiken, waardoor 'fuzzy' titelmatching wordt overgeslagen. Je vindt de ID op anidb.net door de serie te zoeken — de ID staat in de URL. De 4-cijferige opvulling ('padding') is niet vereist voor matching, maar zorgt ervoor dat de sorteervolgorde in je bestandssysteem overeenkomt met de afspeelvolgorde. Zonder padding wordt bestand e1064 na e11 gesorteerd in plaats van na e1063, wat het bladeren door de map buiten Kodi verwarrend maakt.

Gesplitste seizoenen en arcs

Moderne anime die is opgesplitst in "parts" (Attack on Titan Final Season Parts 1/2/3, Demon Slayer arcs) veroorzaakt dezelfde verwarring bij het scrapen als in Plex en Jellyfin. De oplossing: beslis welke database overeenkomt met jouw beeld van de seriestructuur, dwing dit af met het ID-achtervoegsel in de mapnaam en wees consistent voor al je anime.

Anime/
├── Attack on Titan [anidbid-9541]/
│   ├── Season 01/
│   ├── Season 02/
│   ├── Season 03/
│   └── Season 04/   ← Final Season Part 1
├── Attack on Titan - Final Season Part 2 [anidbid-15689]/
│   └── Season 01/   ← AniDB tracks Part 2 as its own entry
└── Demon Slayer (2019)/
    ├── Season 01/
    ├── Season 02/   ← Mugen Train + Entertainment District
    └── Season 03/

Volledige voorbeelden

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? Plex anime (HAMA is dezelfde scraper).

Muziek een naam geven voor Kodi

Muziek in Kodi wordt primair door tags en secundair door mappen gestuurd — precies zoals bij Plex en Jellyfin. De Universal Album Scraper (standaard in Kodi 19+) leest ID3-tags en zoekt bij MusicBrainz en TheAudioDB naar artwork en metadata. Corrigeer eerst de tags, en maak je daarna pas zorgen over de mappenstructuur.

Aanbevolen mappenstructuur

Aanbevolen structuur:

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

Het jaartal van het album in de mapnaam wordt aanbevolen. Albums met meerdere schijven gebruiken submappen genaamd "Disc XX". Compilaties gebruiken een "Various Artists" album-artiest tag (Album Artist-tag = "Various Artists", de individuele Artist-tag blijft de artiest van het nummer).

ID3-tags die Kodi daadwerkelijk gebruikt

Vereiste ID3-tags voor een zuivere match in Kodi: Artist, Album, Title, Track Number. Sterk aanbevolen: Album Artist (anders dan Artist bij compilaties), Year, Genre, Disc Number, MusicBrainz ID's. De MusicBrainz ID's (Album ID en Recording ID, ingebed als ID3v2.3 TXXX-frames of Vorbis-comments) laten Kodi's Universal Album Scraper exact matchen, waardoor 'fuzzy' titelmatching wordt omzeild. Gebruik MusicBrainz Picard om deze ID's eenmalig te schrijven en je Kodi-bibliotheek wordt bijna onfeilbaar. De muziekmodus van RenameFlow leest MusicBrainz en produceert nauwkeurige bestandsnamen + mappenstructuur; het schrijft geen ID3-tags. Gebruik het na een tagger zoals Picard, niet als vervanging.

Volledige voorbeelden

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

NFO-bestanden — Kodi's systeem om metadata te overschrijven

NFO-bestanden zijn het allergrootste verschil tussen Kodi en Plex/Jellyfin wat betreft naamgeving. Een NFO is een klein XML-bestand dat je naast een videobestand plaatst, en Kodi leest dit IN PLAATS van online scrapers te raadplegen. Ze zijn optioneel maar extreem handig: je kunt er foute scraper-matches mee corrigeren, aangepaste collecties documenteren en metadata vastzetten die anders zou kunnen veranderen als online databases worden bijgewerkt. Plex heeft niets vergelijkbaars; Jellyfin heeft gedeeltelijke ondersteuning via lokale afbeeldingen en minimale XML. Het NFO-systeem van Kodi is de meest volwassen implementatie in welk open-source mediacenter dan ook.

Wanneer je NFO-bestanden moet gebruiken (en wanneer niet)

Je hebt niet voor alles NFO-bestanden nodig — de scrapers vinden in 90% van de gevallen de juiste match. De vier scenario's waarin NFO-bestanden de moeite waard zijn: 1. De scraper kiest de verkeerde film/serie en de "Edit"-functie in de Kodi-interface slaat de wijziging niet op (komt vaak voor bij series met veel remakes). 2. Een film of serie staat helemaal niet op TMDB/TVDB (regionale releases, fan-edits, niche-content). 3. Je wilt aangepaste collecties maken die verder gaan dan wat TMDB biedt (bijvoorbeeld je eigen "Beste Sci-Fi uit de jaren 90"-set). 4. Je wilt metadata opslaan die je niet kunt verliezen — de bibliotheek van Kodi kan volledig worden herbouwd vanuit NFO-bestanden als de database corrupt raakt. Voor bibliotheken met minder dan 200 items zijn NFO-bestanden meestal overbodig. Voor bibliotheken met meer dan 1.000 items waar je tijd hebt besteed aan het corrigeren van metadata, zijn ze een verzekering.

movie.nfo — de meest nuttige NFO

NFO-formaat voor films. Plaats het bestand naast je film met de naam movie.nfo (of Titel (Jaar).nfo, overeenkomend met de videobestandsnaam — beide werken, movie.nfo is de conventie):

<?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>

Het veld <uniqueid type="tmdb"> dwingt Kodi om de specifieke TMDB-vermelding te gebruiken in plaats van op de titel te matchen. Dit is de allernuttigste tag — als je maar één ding in je NFO-bestanden zet, gebruik dan deze.

tvshow.nfo — aanpassingen op serieniveau

NFO-bestanden voor tv-series plaats je in de hoofdmap van de serie, onder de naam tvshow.nfo. Het formaat is vergelijkbaar met movie.nfo, maar dan met velden op serieniveau:

<?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>

De <uniqueid type="tvdb"> is de meest betrouwbare manier om tv-series vast te zetten, omdat TheTVDB voor de meeste gebruikers de standaard TV scraper van Kodi is.

NFO per aflevering (zelden nodig)

NFO-bestanden per aflevering zijn zelden nodig — de NFO op serieniveau plus de door de scraper opgehaalde metadata dekt de meeste gevallen. Gebruik ze alleen als een specifieke aflevering verkeerd gematcht is en het vernieuwen van de serie het probleem niet oplost. Formaat: plaats Show - s01e01.nfo naast het videobestand:

<?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>

Geavanceerde metadata-tags

Naast de basis <title>, <year>, <plot> tags, begrijpt Kodi een rijke set aan metadatavelden waarmee je kunt aanpassen hoe items in je bibliotheek verschijnen. De meest nuttige voor power users: <originaltitle> — de titel in de oorspronkelijke taal, weergegeven op infopagina's naast de gelokaliseerde titel. Cruciaal voor buitenlandse films waarbij de titel van de lokale distributeur aanzienlijk verschilt van het origineel (denk aan Spirited Away vs Sen to Chihiro no Kamikakushi). <sorttitle> — overschrijft het standaard sorteergedrag. Gebruik dit om "The Matrix" te sorteren onder "M" in plaats van "T", of om sequels te groeperen ongeacht hun canonieke titels. Voorbeeld: alle Mission: Impossible-films sorteren als "Mission Impossible 01", "Mission Impossible 02" etc. <tagline> — de korte marketing-tagline die onder de titel wordt getoond (denk aan "In space, no one can hear you scream"). Geeft de infopagina's van je bibliotheek een professionele uitstraling. <status> voor tv-series — "Continuing", "Ended" of "Returning Series". Hiermee kan de skin van Kodi passende indicatoren op de seriekaarten tonen. <premiered> — de officiële eerste uitzenddatum. Handig voor anthologieseries of anime waarbij de datum van de scraper onjuist is. <fileinfo> blokken — vooraf gecachte bestandsmetadata (codec, resolutie, audiotaalsporen). Handig als je NFO-bestanden programmatisch bouwt en Kodi's media-analyse bij de eerste scan wilt overslaan.

Meerdere beoordelingsbronnen naast elkaar

Kodi 19+ ondersteunt de weergave van meerdere beoordelingsbronnen tegelijk. Voeg een <ratings>-blok toe met zoveel bronnen als je wilt:

<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>

De standaardskins van Kodi tonen de "default" beoordeling prominent en laten je door de andere bladeren in het infodialoogvenster. Voor bibliotheken waar je zelf hebt gekozen welke bronnen je vertrouwt, is dit een aanzienlijke verbetering ten opzichte van de enkele beoordeling die van de scraper komt.

Muziek NFO-bestanden (artiest, album, track)

Muziek heeft zijn eigen NFO-formaat met drie niveaus — artiest, album en per track. Het NFO-bestand op artiestniveau plaats je in de hoofdmap van de artiest, met de naam 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>

Met de MusicBrainz Artist ID kan Kodi's muziekbibliotheek linken naar de canonieke vermelding zonder 'fuzzy matching' — extreem handig voor artiesten met veelvoorkomende namen of meerdere acts. Een NFO op albumniveau (album.nfo in de albummap) accepteert vergelijkbare velden plus <title>, <year>, <musicBrainzAlbumID>. Een NFO per track wordt zelden gebruikt; Kodi's tag-gestuurde muziekmodel verwerkt tracks via ID3-tags in plaats van NFO-bestanden.

Veelvoorkomende valkuilen bij NFO's

Vier veelgemaakte fouten die NFO-bestanden in de praktijk onbruikbaar maken: 1. Ongeldige XML — niet-geëscapete &, < of > tekens binnen <plot>- of <title>-tags. De oplossing: plaats de tekstinhoud binnen <![CDATA[...]]> of escape handmatig (&amp;, &lt;, &gt;). 2. Verkeerde codering — NFO-bestanden MOETEN UTF-8 zijn. Sommige Windows-teksteditors slaan standaard op als Windows-1252, wat niet-ASCII-tekens (accenten, Cyrillisch, Japans) beschadigt. Gebruik een editor die UTF-8 ondersteunt (VS Code, Sublime Text, Notepad++). 3. Ontbrekende XML-declaratie — de eerste regel <?xml version="1.0" encoding="UTF-8" standalone="yes"?> is verplicht. Zonder deze regel slaan sommige Kodi-versies het bestand stilzwijgend over. 4. NFO-conflicten met gescrapete metadata — als zowel een NFO als een scraper data voor hetzelfde veld aanleveren, geeft Kodi voorrang aan de NFO. Dit is meestal wat je wilt, maar het verrast soms gebruikers die niet beseffen dat hun NFO online updates overschrijft. Om terug te gaan naar gescrapete data, verwijder je de NFO en ververs je de metadata.

Hoe NFO-bestanden naast je media staan

Movies/
└── Blade Runner (1982)/
    ├── Blade Runner (1982).mkv
    ├── movie.nfo               ← TMDB ID vastgezet
    └── poster.jpg

TV Shows/
└── Breaking Bad (2008)/
    ├── tvshow.nfo              ← TVDB ID vastgezet
    ├── Season 01/
    │   ├── Breaking Bad - s01e01 - Pilot.mkv
    │   └── Breaking Bad - s01e01.nfo   ← aanpassing per aflevering (zelden)
    └── Season 02/

Don't want to hand-write NFOs? of gebruik de NFO-schrijver van FileBot.

Problemen met Kodi-naamgeving oplossen

Zes problemen veroorzaken ongeveer 85% van alle klachten over Kodi-naamgeving. Elk probleem heeft een voorspelbare oorzaak en een duidelijke oplossing.

Het alternatief van 60 seconden

Alles hierboven is de handmatige manier: de scrapers begrijpen, de juiste bestandsnamen typen, NFO-bestanden schrijven voor hardnekkige gevallen. De moeite waard om één keer te doen voor een nieuwe bibliotheek. Een pijnlijke klus voor een bibliotheek met 2.000 bestanden, geërfd van jarenlange ongestructureerde downloads.

De handmatige manier

Handmatig duurt het hernoemen van een item in je Kodi-bibliotheek ongeveer 30 tot 60 seconden — de titel controleren, het jaartal formatteren, het sXXeYY-patroon correct krijgen en NFO-overrides schrijven voor de enkele probleemgevallen. Een bibliotheek van 2.000 bestanden kost je een lang weekend.

De 60-seconden manier

Met RenameFlow hernoem je bestanden in seconden. Sleep een map, de parser detecteert of het films / series / anime is, zoekt tegelijkertijd in TMDB / TheTVDB / AniDB / MusicBrainz en toont een voorbeeld van de nieuwe, Kodi-compatibele naam. Bevestig en de bestanden worden lokaal op je schijf hernoemd via de File System Access API — geen upload. Gratis voor de eerste 15 bestanden per dag; eenmalig 49 EUR voor onbeperkt gebruik. Wat betreft het genereren van NFO-bestanden: RenameFlow schrijft geen NFO's direct weg, maar het produceert bestandsnamen die probleemloos worden gescrapet door de standaard Kodi scrapers. Hierdoor zijn NFO's in 90% van de gevallen overbodig. Voor de overige 10% is het handmatig schrijven van de NFO een eenmalige moeite.

See RenameFlow-prijzen.

Kodi-bestandsnamen — Veelgestelde vragen

→ Bekijk alle RenameFlow FAQ's

Verder lezen

• → Plex naming guide (de equivalenten)
• → Jellyfin naming guide
• → Stapsgewijze handleiding voor hernoemen
• → Alle RenameFlow FAQ's

Official references: Naamgeving van Kodi-videobestanden (officiële wiki) · Kodi NFO-bestanden (officiële wiki) · Hama scraper op GitHub