L’errore di corrispondenza più comune consiste nel collocare il numero di stagione e di episodio in un punto che lo scanner non riesce a interpretare in modo affidabile dal nome del file video.
Un media server identifica gli episodi televisivi attraverso diversi livelli: cartella della serie, cartella della stagione, formato del nome file, origine dell’ordine degli episodi, dati NFO locali e identificativi del provider. Un titolo può trovarsi nella serie corretta e rimanere comunque non associato quando il file effettivo non contiene un token non ambiguo come S01E03. Prima di rinominare un’intera libreria in blocco, analizza un episodio non riconosciuto insieme a uno correttamente associato.
Verifica se l’associazione della serie, della stagione o dell’episodio è errata
Apri l’elemento interessato e annota l’identità della serie, il numero della stagione, il numero dell’episodio, il titolo visualizzato, il percorso del file e gli ID del provider. Questi dati mostrano se lo scanner ha trovato la serie corretta ma non è riuscito a interpretare l’episodio, oppure se ha identificato erroneamente l’intera serie.
Un problema di Jellyfin mostra file inseriti nella serie e nella stagione corrette, mentre gli episodi rimanevano non associati perché nel nome del file multimediale mancava il token dell’episodio.
Se la serie e la stagione sono corrette ma manca il numero dell’episodio, concentrati sul nome del file. Se l’identità della serie è errata, controlla la cartella della serie, l’anno, l’ID del provider e il tipo di libreria prima di modificare la sintassi degli episodi.
Inserisci un token SxxExx non ambiguo nel nome del file multimediale
Usa un formato prevedibile come Nome serie - S01E03 - Titolo episodio.mkv. Mantieni il token della stagione e dell’episodio nel nome effettivo del file video, invece di affidarti soltanto a una cartella di release, a una directory di download o alla cartella principale.
Formati alternativi come 1.03, numeri di episodio isolati o codici specifici delle release potrebbero non essere riconosciuti in modo coerente. Un rapporto di Jellyfin in cui era stato rilevato un solo episodio utilizzava nomi come 1.01 e 1.02 invece di un formato chiaro per stagione ed episodio.
Rinomina un file di test copiato usando il formato canonico e analizza nuovamente solo quella serie. Se viene associato correttamente, crea una mappa di rinomina reversibile e migra il resto in piccoli gruppi invece di eliminare i metadati o ricostruire il database.
Evita che i numeri della serie e della stagione entrino in conflitto con il parser
Nomina la cartella della serie usando il titolo della serie e, facoltativamente, l’anno, quindi utilizza cartelle di stagione esplicite come Season 01. Evita di introdurre altre cartelle numeriche che potrebbero essere scambiate per indicatori di stagione.
I numeri incorporati nel titolo di una serie possono diventare ambigui quando la struttura circostante è poco chiara. Un problema di Jellyfin descrive titoli come “The 100”, “24” e “Stargate SG-1” interpretati come numeri di stagione.
Mantieni intatto il titolo, ma rafforza la gerarchia e il token nel nome del file: The 100 (2014)/Season 01/The 100 - S01E01.mkv. Non rimuovere i numeri legittimi dal nome ufficiale della serie solo per compensare una struttura di cartelle ambigua.
Usa il formato corretto per i file con più episodi e per le versioni
Un file che contiene più di un episodio richiede un token supportato per gli episodi multipli, mentre due codifiche dello stesso episodio richiedono la convenzione del server per la denominazione delle versioni o delle parti. Confondere questi scopi può creare duplicati o raggruppare episodi diversi.
Gli utenti hanno segnalato che stili di denominazione diversi facevano comparire più volte lo stesso episodio. Un problema di Jellyfin attribuisce le voci duplicate alla denominazione incoerente degli episodi tra più copie.
Testa separatamente i casi con più episodi e quelli con più versioni. Un episodio combinato potrebbe usare un formato come S01E01-E02, mentre più versioni con qualità diverse dovrebbero mantenere la stessa identità dell’episodio insieme a un’etichetta di versione supportata. Conserva i file originali finché l’applicazione non li raggruppa correttamente.
Tieni gli speciali e i contenuti extra fuori dalla numerazione delle stagioni normali
Inserisci gli speciali effettivi nella stagione prevista dall’applicazione, generalmente Season 00 con nomi file S00E##. Inserisci i contenuti dietro le quinte in una struttura supportata per gli extra, invece di inventare numeri di episodi normali.
I test attuali di Jellyfin mostrano che gli speciali e le varianti degli episodi possono entrare in conflitto quando diversi ruoli di denominazione coesistono nella stessa stagione. Il problema riguarda varianti e speciali mescolati, non un semplice errore dei metadati a livello di serie.
Sposta un file extra nella posizione supportata per gli extra o gli speciali ed esegui una nuova scansione mirata. Se gli episodi normali vengono associati immediatamente, mantieni i contenuti extra fuori dalla sequenza principale degli episodi interpretata dal parser.
Controlla l’ordine degli episodi prima di rinominare file numerati correttamente
Un file può contenere un token SxxExx valido e visualizzare comunque il titolo errato quando la libreria si aspetta l’ordine di trasmissione, mentre i file utilizzano l’ordine DVD, assoluto, di produzione o un altro ordine specifico del provider.
Un problema di Jellyfin ha rilevato problemi nell’ordine degli episodi legati al provider di metadati selezionato e all’ordine di visualizzazione, mostrando che l’ordine del provider può differire anche quando i nomi dei file sono strutturalmente validi.
Confronta una stagione con l’elenco degli episodi del provider scelto prima di rinominare i file. Modifica l’ordine della libreria o della serie quando i file corrispondono già a un ordine legittimo; rinomina i file solo quando la loro numerazione non è effettivamente coerente con l’origine desiderata.
Analizza una sola cartella controllata e conserva la mappa di rinomina
Crea una cartella di test contenente un episodio normale, un file con più episodi, uno speciale e una versione alternativa. Applica il formato di denominazione proposto, quindi analizza quella cartella in una libreria isolata o temporanea.
La guida di ZimaSpace sulle regole di denominazione specifiche dell’applicazione spiega perché le librerie multimediali necessitano di una convenzione prevedibile propria, invece di uno standard generico per i nomi dei file.
La correzione della denominazione è completa quando ogni elemento di test riceve la serie, la stagione, l’episodio, l’edizione e il titolo corretti; non compaiono duplicati; e il risultato rimane invariato dopo un aggiornamento dei metadati. Conserva la mappa di rinomina dal vecchio al nuovo nome, così da poter aggiornare in sicurezza playlist, strumenti di backup e altre applicazioni.
Supporto e consigli
Altro da leggere

Perché il ripristino di un volume Docker ricrea il contenuto dei file, ma elimina gli attributi estesi?
Una diagnosi del ripristino del volume che copre l’inventario degli xattr, le opzioni di tar e Rsync, gli spazi dei nomi, il supporto della...

Perché un container in esecuzione mantiene il vecchio limite di memoria dopo la modifica del file Compose?
Una diagnosi dei limiti di memoria che copre i cgroup attivi, il riavvio rispetto alla ricreazione, i campi di Compose, i limiti rigidi e...

Perché il riavvio di un proxy inverso invalida ogni sessione per una determinata app self-hosted?
Una diagnosi della perdita di sessione che copra l’ambito dei riavvii, la gestione dei cookie, la rotazione dei segreti, le sessioni basate sulla cache,...

