Guida alla nomenclatura di Kodi: Film, Serie TV, Anime, Musica e File NFO (2026)

Concetti fondamentali della nomenclatura di Kodi

Tre concetti su come Kodi esegue le scansioni si differenziano abbastanza da Plex e Jellyfin da meritare una spiegazione a parte. Salta questa sezione e continuerai a incappare negli stessi tre errori: scraper sbagliato per la tua libreria, tipo di contenuto configurato male e file NFO imprevisti che sovrascrivono le tue scansioni.

Scraper, non agenti

Dove Plex ha gli "agenti" e Jellyfin ha i "fornitori di metadati", Kodi ha gli "scraper" — add-on mantenuti dalla comunità che interrogano database specifici. Quelli predefiniti sono lo scraper di The Movie Database per i film, lo scraper di The Movie Database o di The TVDB per le serie TV e l'Universal Album Scraper per la musica. Gli anime sono la grande eccezione: Kodi non ha uno scraper per anime integrato, quindi gli utenti installano add-on della comunità come Hama (lo stesso usato in Plex) per l'integrazione con AniDB. La scelta dello scraper avviene per sorgente, non per libreria. Apri una sorgente video di Kodi nel browser dei file, modificala e scegli "Imposta contenuto" per assegnare uno scraper. La stessa sorgente può essere scansionata da diversi add-on su dispositivi Kodi diversi nella stessa rete — motivo per cui la frase "il mio Kodi funziona ma quello del mio amico no" è così comune.

Sorgenti della libreria e tipi di contenuto

La libreria di Kodi è costruita da "sorgenti" che aggiungi manualmente: cartelle, condivisioni di rete o percorsi remoti. Quando aggiungi una sorgente, indichi a Kodi che tipo di contenuto contiene (Film, Serie TV, Video musicali, Musica, Nessuno) e quale scraper usare per quel contenuto. Mischiare tipi di contenuto in una singola sorgente è una causa comune di file non abbinati: una cartella che contiene sia film che serie TV può essere analizzata solo come l'uno o l'altro. La soluzione è dividere i contenuti misti in cartelle separate di primo livello, ognuna con la propria sorgente e il proprio tipo di contenuto. Questo è più rigido del rilevamento per cartella di Plex, ma più prevedibile una volta che ti attieni alla struttura.

Quattro regole per prevenire il 90% degli errori

Quattro regole che prevengono la stragrande maggioranza degli errori di scansione di Kodi: Regola 1 — Un tipo di contenuto per sorgente. Non mischiare film e serie TV in una singola cartella che Kodi analizza come "Film". Regola 2 — Imposta il tipo di contenuto e lo scraper PRIMA della prima scansione. Modificarli in seguito richiede un "Aggiorna" e talvolta una pulizia completa del database per eliminare i vecchi abbinamenti errati. Regola 3 — Usa sXXeYY per gli episodi delle serie TV, in minuscolo e con zero-padding. Kodi accetta più variazioni di Plex, ma schemi prevedibili evitano i casi limite dello scraper. Regola 4 — Quando uno scraper fallisce ripetutamente su un elemento specifico, aggiungi un file NFO accanto ad esso. I file NFO sovrascrivono completamente gli scraper: sono la via di fuga di Kodi.

Need it from zero? guida passo-passo.

Nomenclatura dei Film per Kodi

Kodi accetta due layout validi per i film: uno per cartella e uno piatto (flat). Lo schema a cartelle è raccomandato per le stesse ragioni di Plex e Jellyfin (extra, poster, file NFO), più una funzionalità specifica di Kodi: i film multi-parte impilati (stacked), che Kodi gestisce nativamente a differenza di Plex e Jellyfin.

Layout delle cartelle raccomandato

Il layout delle cartelle raccomandato:

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

Il nome del file corrisponde al nome della cartella. I file della grafica usano i nomi locali di Kodi: poster.jpg, fanart.jpg, clearart.png, landscape.jpg. I sottotitoli seguono la convenzione Titolo (Anno).en.srt, .fr.srt ecc. — Kodi legge il codice della lingua dal suffisso separato da un punto.

Il suffisso (Anno) non è opzionale

L'anno tra parentesi non è negoziabile per le stesse ragioni di Plex e Jellyfin: TheMovieDB restituisce corrispondenze con titoli duplicati ordinate per popolarità, e Kodi sceglierà silenziosamente quella sbagliata. Formato: Titolo (AAAA). Le parentesi quadre [AAAA], i punti Titolo.AAAA e gli anni senza parentesi funzionano con alcuni scraper ma non con altri — le parentesi tonde sono universali. Per i film completamente assenti su TMDB (rare pellicole d'essai, uscite regionali), un file NFO con un ID TMDB manuale è l'unica soluzione affidabile. Vedi la sezione NFO qui sotto.

Film multi-parte impilati (stacked) (solo Kodi)

Kodi ha il supporto nativo per i film multi-parte archiviati come file separati — una funzionalità dell'era dei DVD-rip ancora utile per film molto lunghi (LotR Extended, Once Upon a Time in America) divisi su più dischi. Usa i modelli di suffisso 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 li riproduce in sequenza come un unico film e li analizza come una singola voce di libreria. Lo schema di corrispondenza non distingue tra maiuscole e minuscole e accetta cd, part, dvd, pt e alcuni altri — ma cd1/cd2 è il più sicuro e documentato.

Versioni multiple dello stesso film

Kodi non ha la funzione di versioni multiple unificate offerta da Plex e Jellyfin — non puoi archiviare una versione 1080p e una 4K sotto un'unica voce di libreria e far scegliere a Kodi quella giusta per il client. Ogni file diventa una voce di libreria a sé stante. Due soluzioni alternative: Approccio 1 — Mantieni una versione per film nella libreria di Kodi e archivia le altre versioni al di fuori della sorgente analizzata dallo scraper. Cambia manualmente la sorgente della libreria quando desideri l'altra qualità. Approccio 2 — Dividi in due librerie (Movies-1080p, Movies-4K) con due sorgenti. Usa i profili di Kodi o le scorciatoie della skin per passare da una all'altra. Richiede più lavoro, ma permette a tutte le versioni di coesistere nella stessa installazione di Kodi. Se la gestione di versioni multiple è centrale per il tuo flusso di lavoro, questa è l'area in cui Plex e Jellyfin sono oggettivamente più capaci.

Saghe e collezioni di film

Kodi supporta le saghe di film (a volte chiamate "collezioni") — Star Wars, Marvel Cinematic Universe, Il Signore degli Anelli — raggruppando i film sotto un unico nodo di collezione sfogliabile. Le saghe vengono popolate automaticamente dai dati delle collezioni di TMDB per i film che ne fanno parte. Nessuna modifica al nome è richiesta; Kodi legge l'ID della collezione dai metadati TMDB ottenuti dallo scraper. Per le saghe personalizzate (un tuo raggruppamento non presente su TMDB), usa un file NFO a livello del film con un tag <set> che punta a un nome di saga personalizzato.

Quattro errori che causano la maggior parte dei fallimenti dello scraper

1. Tipo di contenuto della sorgente impostato su "Nessuno" o su un tipo errato. Senza un tipo di contenuto, Kodi non esegue affatto la scansione come film. 2. Anno mancante o tra parentesi quadre. "Inception 2010.mkv" viene abbinato per fortuna; "Inception [2010].mkv" fallisce con lo scraper di TMDB. 3. File del film nella cartella radice della sorgente, senza una cartella dedicata. Funziona per l'abbinamento ma compromette il materiale grafico, i file NFO e le funzioni per le parti multiple. 4. Voci obsolete da una precedente scansione errata. Anche dopo aver corretto i nomi, Kodi mostra la vecchia corrispondenza errata. Soluzione: menu contestuale della libreria → "Pulisci libreria" → quindi esegui una nuova scansione.

Esempi completi

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 Equivalenti per Plex.

Nominare le serie TV per Kodi

Le serie TV sono il campo in cui la flessibilità di Kodi è più utile: vengono accettati più schemi di nomi file validi e lo scraper è tollerante verso piccole variazioni. Il compromesso: quando qualcosa non corrisponde, la causa è raramente ovvia. Questa sezione illustra gli schemi sicuri e i casi in cui Kodi si differenzia da Plex/Jellyfin.

Struttura delle cartelle

Struttura standard a due livelli: cartella della serie, poi sottocartelle per le stagioni.

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

Nome della cartella della serie: "Title (Year)". L'anno serve a distinguere i remake — The Office UK 2001 vs US 2005, House of Cards UK 1990 vs US 2013. Cartella della stagione: "Season XX" con due cifre e zero iniziale, oppure "Season 0" (o "Season 00") per gli speciali. Kodi accetta sia "Season 0" che "Season 00"; scegline uno e mantienilo. A differenza della convenzione di Plex per la cartella "Specials", Kodi NON riconosce il nome letterale della cartella "Specials". Usa Season 0 o Season 00.

Formato del nome file dell'episodio

Lo schema consigliato da Kodi per il nome file degli episodi: Show Name - sXXeYY - Episode Title.ext Lettere minuscole, numeri a due cifre con zero iniziale, titolo dell'episodio opzionale per la leggibilità. Kodi accetta maiuscole (SXXEYY), Show.S01E01, Show 1x01, Show 101 e diverse altre varianti — ma la forma in minuscolo separata da trattini è la più affidabile con tutti gli scraper. Il titolo dell'episodio nel nome del file è solo per la leggibilità umana — lo scraper di Kodi lo sovrascrive con il titolo canonico da TheTVDB o TheMovieDB. Se il titolo fornito dallo scraper è sbagliato, modificalo tramite la GUI di Kodi (clic destro sull'episodio → "Information" → "Edit") o tramite il file NFO (trattato più avanti).

Speciali in Season 0

Speciali, OVA, episodi pilota, dietro le quinte e contenuti bonus vanno in "Season 0" (o "Season 00" — Kodi li tratta entrambi in modo identico). All'interno, usa una numerazione sequenziale: Show - s00e01.mkv, Show - s00e02.mkv. L'ordine di numerazione dovrebbe corrispondere alla lista degli speciali di TheTVDB per quella serie. La community di TheTVDB li organizza in un ordine specifico (spesso basato sulla data di messa in onda); Kodi si aspetta che tu segua quell'ordine. Se i tuoi speciali appaiono in disordine nell'interfaccia di Kodi, controlla la scheda degli speciali su TheTVDB per la serie e riordina i tuoi numeri s00eYY di conseguenza.

File multi-episodio

Per episodi doppi in un unico file:

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

Kodi crea un singolo elemento riproducibile che si collega a entrambi gli episodi nei metadati. La forma con l'intervallo (e15-e16) è più pulita; anche la forma alternativa (s05e15-s05e16) funziona. Entrambe si estendono a episodi tripli o quadrupli se necessario (e15-e16-e17), anche se è raro nella pratica.

Show giornalieri (basati sulla data)

Gli show giornalieri (talk show, notiziari) senza i tradizionali numeri di stagione/episodio usano il formato data AAAA-MM-GG:

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

Lo scraper TheTVDB di Kodi abbina la data con l'indice delle date dello show giornaliero. Assicurati che la fonte usi lo scraper TheTVDB, non TheMovieDB — TheMovieDB ha un supporto limitato per gli show giornalieri.

Esempi completi

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 Equivalenti per Jellyfin.

Nomenclatura degli Anime per Kodi (con lo Scraper Hama)

Kodi non ha uno scraper per anime integrato: gli add-on predefiniti TheMovieDB e TheTVDB trattano gli anime come normali serie TV, il che funziona per gli shonen stagionali moderni ma fallisce con le serie a numerazione assoluta (One Piece, Detective Conan, Bleach). La soluzione è Hama, lo stesso scraper della community usato in Plex per le librerie di anime. Installandolo una volta sblocchi l'integrazione con AniDB per tutte le tue fonti di anime su Kodi.

Configurazione di Hama (10 minuti, una tantum)

La configurazione di Hama in Kodi richiede circa 10 minuti: 1. Scarica Hama da github.com/ZeroQI/Hama.bundle (il bundle per Plex funziona su Kodi tramite il wrapper dell'add-on Hama per Kodi). In alternativa: installa "Hama" dalla repository ufficiale degli add-on di Kodi, se disponibile nella tua versione di Kodi. 2. In Kodi: Impostazioni → Add-on → Installa da repository → Fornitori di informazioni → Serie TV → installa Hama (e Hama.bundle se elencato separatamente). 3. Crea una fonte dedicata per gli anime. Aggiungi una fonte video che punta alla tua cartella degli anime, imposta il tipo di contenuto su "Serie TV" e scegli "Hama" come scraper al posto di TheMovieDB o TheTVDB. 4. Hama usa AniDB come database primario per impostazione predefinita. Puoi cambiare l'ordine di priorità nelle impostazioni dello scraper — AniDB per primo è consigliato per le serie a numerazione assoluta; TheTVDB per primo per le serie di cui vuoi i metadati del doppiaggio inglese. 5. Esegui uno scrape sulla fonte. Il primo scrape è lento (Hama interroga più database) — sii paziente. Gli scrape successivi sono molto più veloci.

Numerazione assoluta degli episodi

Per le serie a numerazione assoluta come One Piece (episodio 1.064), usa la stagione 01 con i numeri di episodio assoluti con padding a 4 cifre:

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

Il suffisso [anidbid-X] nel nome della cartella forza Hama a usare direttamente la voce di AniDB, saltando la corrispondenza approssimativa del titolo (fuzzy matching). Trova l'ID su anidb.net cercando la serie — l'ID si trova nell'URL. Il padding a 4 cifre non è necessario per la corrispondenza, ma mantiene l'ordinamento del filesystem uguale all'ordine di riproduzione. Senza padding, il file e1064 viene ordinato dopo e11 invece che dopo e1063, il che rende confusionaria la navigazione della cartella al di fuori di Kodi.

Stagioni e archi narrativi divisi

Gli anime moderni divisi in "parti" (Attack on Titan Final Season Parts 1/2/3, gli archi di Demon Slayer) causano la stessa confusione nello scraping che si verifica in Plex e Jellyfin. La soluzione: decidi quale database corrisponde al tuo modello mentale della struttura della serie, forzalo tramite il suffisso ID nella cartella e mantieni la coerenza per tutti i tuoi anime.

Anime/
├── Attack on Titan [anidbid-9541]/
│   ├── Season 01/
│   ├── Season 02/
│   ├── Season 03/
│   └── Season 04/   ← Final Season Parte 1
├── Attack on Titan - Final Season Part 2 [anidbid-15689]/
│   └── Season 01/   ← AniDB tratta la Parte 2 come una voce a sé
└── Demon Slayer (2019)/
    ├── Season 01/
    ├── Season 02/   ← Mugen Train + Quartiere dei Divertimenti
    └── Season 03/

Esempi completi

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? Anime su Plex (stesso scraper HAMA).

Nomenclatura della musica per Kodi

La musica in Kodi è gestita principalmente tramite tag e secondariamente tramite cartelle, esattamente come Plex e Jellyfin. Lo Universal Album Scraper (predefinito in Kodi 19+) legge i tag ID3 e interroga MusicBrainz e TheAudioDB per copertine e metadati. Prima sistema i tag, poi preoccupati della struttura delle cartelle.

Struttura delle cartelle consigliata

Struttura consigliata:

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

È consigliato includere l'anno dell'album nel nome della cartella. Gli album multi-disco usano sottocartelle "Disc XX". Le compilation usano un tag album-artist "Various Artists" (tag Album Artist = "Various Artists", mentre il tag Artist individuale rimane l'esecutore della traccia).

Tag ID3 effettivamente usati da Kodi

Tag ID3 richiesti per una corrispondenza pulita in Kodi: Artist, Album, Title, Track Number. Fortemente consigliati: Album Artist (distinto da Artist nelle compilation), Year, Genre, Disc Number, ID MusicBrainz. Gli ID di MusicBrainz (Album ID e Recording ID, incorporati come frame TXXX ID3v2.3 o commenti Vorbis) permettono allo Universal Album Scraper di Kodi di trovare corrispondenze esatte, evitando l'abbinamento approssimativo basato sul titolo. Usa MusicBrainz Picard per scrivere questi ID una volta e la libreria di Kodi diventerà quasi infallibile. La modalità musica di RenameFlow legge MusicBrainz e produce nomi di file e strutture di cartelle accurati; non scrive tag ID3. Usalo dopo un tagger come Picard, non in sua sostituzione.

Esempi completi

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

File NFO — Il sistema di override dei metadati di Kodi

I file NFO sono la più grande differenza tra Kodi e Plex/Jellyfin per quanto riguarda la denominazione. Un NFO è un piccolo file XML che posizioni accanto a un video, e Kodi lo legge INVECE di interrogare gli scraper online. Sono opzionali ma estremamente utili: ti permettono di sovrascrivere le corrispondenze errate dello scraper, documentare collezioni personalizzate e fissare metadati che altrimenti potrebbero variare con le modifiche dei database online. Plex non ha nulla di equivalente; Jellyfin ha un supporto parziale tramite immagini locali e XML minimali. Il sistema NFO di Kodi è l'implementazione più matura in qualsiasi media center open-source.

Quando scrivere i file NFO (e quando no)

Non hai bisogno di file NFO per tutto: gli scraper gestiscono correttamente il 90% delle corrispondenze. I quattro scenari in cui vale la pena usare i file NFO: 1. Lo scraper sceglie il film/la serie sbagliata e la modifica tramite "Modifica" nell'interfaccia di Kodi non viene salvata (comune per le serie con molti remake). 2. Un film o una serie non è affatto presente su TMDB/TVDB (uscite regionali, fan edit, contenuti di nicchia). 3. Vuoi raggruppamenti di collezioni personalizzati oltre a quelli offerti da TMDB (ad esempio, il tuo set "Miglior Fantascienza anni '90"). 4. Stai archiviando metadati che non puoi perdere: la libreria di Kodi può essere ricostruita solo dai file NFO se il database si corrompe. Per librerie con meno di 200 elementi, i file NFO sono solitamente eccessivi. Per librerie con più di 1.000 elementi in cui hai passato del tempo a correggere i metadati, sono un'assicurazione.

movie.nfo — l'NFO più utile

Formato NFO per i film. Posiziona il file accanto al film e chiamalo movie.nfo (o Titolo (Anno).nfo, in modo che corrisponda al nome del file video — entrambi funzionano, ma la convenzione è movie.nfo):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<movie>
  <title>Blade Runner</title>
  <originaltitle>Blade Runner</originaltitle>
  <year>1982</year>
  <plot>Un blade runner deve inseguire ed eliminare quattro replicanti...</plot>
  <runtime>117</runtime>
  <mpaa>R</mpaa>
  <genre>Fantascienza</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>

Il campo <uniqueid type="tmdb"> forza Kodi a usare la voce specifica di TMDB invece di fare una corrispondenza approssimativa del titolo. Questo è il tag più utile in assoluto: se scrivi una sola cosa nei tuoi file NFO, che sia questa.

tvshow.nfo — override a livello di serie TV

I file NFO per le serie TV vanno nella cartella principale della serie, con il nome tvshow.nfo. Il formato è simile a movie.nfo ma con campi a livello di serie:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tvshow>
  <title>Breaking Bad</title>
  <year>2008</year>
  <plot>Un insegnante di chimica di un liceo a cui viene diagnosticato un cancro...</plot>
  <genre>Crime</genre>
  <genre>Drammatico</genre>
  <uniqueid type="tvdb" default="true">81189</uniqueid>
  <uniqueid type="tmdb">1396</uniqueid>
  <uniqueid type="imdb">tt0903747</uniqueid>
  <status>Terminata</status>
  <studio>AMC</studio>
</tvshow>

Il tag <uniqueid type="tvdb"> è il modo più affidabile per 'bloccare' le serie TV, poiché TheTVDB è lo scraper TV predefinito di Kodi per la maggior parte degli utenti.

NFO per singolo episodio (raramente necessario)

I file NFO per singolo episodio sono raramente necessari: il file NFO a livello di serie e i metadati degli episodi recuperati dallo scraper coprono la maggior parte dei casi. Usali solo quando un episodio specifico non viene riconosciuto correttamente e un aggiornamento della serie non risolve il problema. Formato: posiziona il file Show - s01e01.nfo accanto al file video:

<?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, un insegnante di chimica di un liceo in difficoltà...</plot>
  <uniqueid type="tvdb" default="true">349232</uniqueid>
</episodedetails>

Tag di metadati avanzati

Oltre ai tag di base <title>, <year>, <plot>, Kodi comprende un ricco set di campi di metadati che ti permettono di personalizzare come gli elementi appaiono nella tua libreria. I più utili per gli utenti esperti: <originaltitle> — il titolo in lingua originale, visualizzato nelle pagine informative accanto al titolo localizzato. Fondamentale per i film stranieri in cui il titolo del distributore locale differisce significativamente dall'originale (pensa a La città incantata vs Sen to Chihiro no Kamikakushi). <sorttitle> — sovrascrive il comportamento di ordinamento predefinito. Usalo per forzare l'ordinamento di "The Matrix" sotto la "M" invece che sotto la "T", o per raggruppare i sequel indipendentemente dai loro titoli canonici. Esempio: ordinare tutti i film di Mission: Impossible come "Mission Impossible 01", "Mission Impossible 02" ecc. <tagline> — la breve frase di marketing mostrata sotto il titolo (pensa a "Nello spazio, nessuno può sentirti urlare"). Aggiunge un tocco di classe alle pagine informative della tua libreria. <status> per le serie TV — "Continuing", "Ended" o "Returning Series". Permette alla skin di Kodi di mostrare indicatori appropriati sulle schede delle serie. <premiered> — la data ufficiale della prima messa in onda. Utile per le serie antologiche o gli anime in cui la data dello scraper è sbagliata. <fileinfo> blocchi — metadati del file pre-caricati (codec, risoluzione, tracce audio). Utile se crei file NFO programmaticamente e vuoi saltare l'analisi dei media alla prima scansione di Kodi.

Più fonti di valutazione fianco a fianco

Kodi 19+ supporta la visualizzazione simultanea di più fonti di valutazione. Aggiungi un blocco <ratings> con tutte le fonti che desideri:

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

Le skin predefinite di Kodi mostrano in modo prominente la valutazione "default" e ti permettono di scorrere le altre nella finestra delle informazioni. Per le librerie in cui hai curato quali fonti ritieni affidabili, questo è un significativo miglioramento della qualità della vita rispetto alla valutazione da una singola fonte fornita dallo scraper.

File NFO per la musica (artista, album, traccia)

La musica ha un suo formato NFO con tre livelli: artista, album e per-traccia. Il file NFO a livello di artista va nella cartella principale dell'artista, con il nome 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 Artista di MusicBrainz permette alla libreria musicale di Kodi di collegarsi alla voce canonica senza corrispondenze approssimative (fuzzy matching) — estremamente utile per artisti con nomi comuni o più omonimi. Il file NFO a livello di album (album.nfo nella cartella dell'album) accetta campi simili più <title>, <year>, <musicBrainzAlbumID>. Il file NFO per-traccia è usato raramente; il modello musicale di Kodi, basato sui tag, gestisce le tracce tramite tag ID3 anziché file NFO.

Errori comuni con i file NFO

Quattro errori che in pratica rompono i file NFO: 1. XML non valido — caratteri &, < o > non sottoposti a escape all'interno dei tag <plot> o <title>. La soluzione: racchiudi il contenuto testuale in <![CDATA[...]]> o esegui l'escape manualmente (&amp;, &lt;, &gt;). 2. Codifica errata — i file NFO DEVONO essere in UTF-8. Alcuni editor di testo di Windows salvano di default in Windows-1252, il che corrompe i caratteri non-ASCII (accenti, cirillico, giapponese). Usa un editor che supporti UTF-8 (VS Code, Sublime Text, Notepad++). 3. Dichiarazione XML mancante — la prima riga <?xml version="1.0" encoding="UTF-8" standalone="yes"?> è obbligatoria. Senza di essa, alcune versioni di Kodi ignorano silenziosamente il file. 4. Conflitti tra NFO e metadati dello scraper — se sia un NFO che uno scraper forniscono dati per lo stesso campo, Kodi dà la priorità all'NFO. Di solito è quello che vuoi, ma a volte sorprende gli utenti che non si rendono conto che il loro NFO sta sovrascrivendo gli aggiornamenti online. Per tornare ai dati dello scraper, elimina l'NFO e aggiorna.

Come posizionare i file NFO accanto ai tuoi file multimediali

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

TV Shows/
└── Breaking Bad (2008)/
    ├── tvshow.nfo              ← ID TVDB bloccato
    ├── Season 01/
    │   ├── Breaking Bad - s01e01 - Pilot.mkv
    │   └── Breaking Bad - s01e01.nfo   ← override per episodio (raro)
    └── Season 02/

Don't want to hand-write NFOs? o usa lo scrittore di NFO di FileBot.

Risoluzione problemi di denominazione Kodi

Sei errori comuni coprono circa l'85% dei problemi di denominazione in Kodi. Ognuno ha una causa prevedibile e una soluzione chiara.

L'alternativa da 60 secondi

Tutto ciò che è stato descritto sopra è il metodo manuale: capire gli scraper, digitare i nomi dei file corretti, scrivere file NFO per i casi più ostinati. Vale la pena farlo una volta per una nuova libreria. Ma è un'agonia per una libreria di 2.000 file ereditata da anni di download non strutturati.

Il metodo manuale

A mano, rinominare un elemento della libreria Kodi richiede circa 30-60 secondi: controllare il titolo, formattare l'anno, impostare correttamente lo schema sXXeYY e scrivere override NFO per i pochi casi problematici. Una libreria di 2.000 file richiede un lungo weekend.

Il metodo da 60 secondi

RenameFlow rinomina i file in pochi secondi. Trascina una cartella, il parser rileva se contiene film / serie TV / anime, interroga TMDB / TheTVDB / AniDB / MusicBrainz in parallelo e mostra un'anteprima della rinomina compatibile con Kodi. Conferma e le rinomine avvengono localmente sul tuo disco tramite la File System Access API — nessun upload. Gratis per i primi 15 file al giorno; 49 EUR una tantum per un uso illimitato. Per la generazione di file NFO, RenameFlow non scrive direttamente i file NFO, ma produce nomi di file che vengono riconosciuti senza problemi dagli scraper predefiniti di Kodi, eliminando la necessità di file NFO nel 90% dei casi. Per il restante 10%, scrivere manualmente il file NFO è un'operazione da fare una sola volta.

See Prezzi di RenameFlow.

Nomenclatura per Kodi — Domande Frequenti

→ Vedi tutte le FAQ di RenameFlow

Approfondimenti

• → Guida alla nomenclatura di Plex (le equivalenze)
• → Guida alla nomenclatura di Jellyfin
• → Guida passo dopo passo alla rinomina
• → Tutte le FAQ di RenameFlow

Official references: Nomenclatura dei file video per Kodi (wiki ufficiale) · File NFO per Kodi (wiki ufficiale) · Hama scraper su GitHub