De meest voorkomende fout bij het koppelen ontstaat doordat het seizoen- en afleveringsnummer ergens staat waar de scanner het niet betrouwbaar uit de vide bestandsnaam kan uitlezen.
Een mediaserver identificeert televisieafleveringen aan de hand van verschillende lagen: de programmamap, de seizoensmap, het bestandsnaam patroon, de bron voor de afleveringsvolgorde, lokale NFO-gegevens en provider-ID's. Een titel kan onder de juiste serie staan en toch niet worden gekoppeld wanneer het eigenlijke bestand geen ondubbelzinnig kenmerk zoals S01E03 bevat. Diagnoseer één mislukte aflevering naast één correct gekoppelde aflevering voordat je een volledige bibliotheek in één keer hernoemt.
Controleer of de koppeling van de serie, het seizoen of de aflevering fout is
Open het betreffende item en noteer de serie-identiteit, het seizoennummer, het afleveringsnummer, de weergegeven titel, het bestandspad en de provider-ID's. Hiermee kun je vaststellen of de scanner de juiste serie heeft gevonden maar de aflevering niet kon uitlezen, of dat de volledige serie verkeerd is geïdentificeerd.
In een Jellyfin-issue staan bestanden onder de juiste serie en het juiste seizoen, terwijl de afleveringen zelf niet gekoppeld bleven omdat de mediabestandsnaam het afleveringskenmerk niet bevatte.
Als de serie en het seizoen correct zijn maar het afleveringsnummer ontbreekt, richt je dan op de bestandsnaam. Als de serie-identiteit fout is, controleer dan de programmamap, het jaar, de provider-ID en het bibliotheektype voordat je de syntaxis voor afleveringen aanpast.
Plaats een ondubbelzinnig SxxExx-kenmerk in de mediabestandsnaam
Gebruik een voorspelbaar patroon zoals Show Name - S01E03 - Episode Title.mkv. Zorg dat het seizoen- en afleveringskenmerk in de eigenlijke videobestandsnaam staat en vertrouw niet alleen op een releasemap, downloadmap of bovenliggende map.
Alternatieve vormen zoals 1.03, losse afleveringsnummers of release-specifieke codes worden mogelijk niet consistent herkend. In een Jellyfin-melding waarin slechts één aflevering werd gedetecteerd, werden namen zoals 1.01 en 1.02 gebruikt in plaats van een duidelijk seizoen- en afleveringspatroon.
Hernoem één gekopieerd testbestand volgens het standaardpatroon en scan alleen die serie opnieuw. Als de aflevering wordt gekoppeld, maak dan een omkeerbare hernoemingslijst en migreer de rest in kleine batches in plaats van metadata te verwijderen of de database opnieuw op te bouwen.
Voorkom dat serietitels en seizoennummers met de parser concurreren
Geef de programmamap de serietitel en eventueel het jaar, en gebruik vervolgens expliciete seizoensmappen zoals Season 01. Vermijd extra numerieke mappen die als seizoensindicator kunnen worden aangezien.
Nummers in een serietitel kunnen dubbelzinnig worden wanneer de omliggende structuur zwak is. Een Jellyfin-issue beschrijft hoe titels zoals “The 100”, “24” en “Stargate SG-1” werden geïnterpreteerd als seizoensnummers.
Laat de titel intact, maar maak de hiërarchie en het kenmerk in de bestandsnaam duidelijker: The 100 (2014)/Season 01/The 100 - S01E01.mkv. Verwijder legitieme nummers uit de officiële serienaam niet alleen om een dubbelzinnige mapstructuur te compenseren.
Gebruik het juiste patroon voor bestanden met meerdere afleveringen en versies
Een bestand met meer dan één aflevering heeft een ondersteund kenmerk voor meerdere afleveringen nodig, terwijl twee coderingen van dezelfde aflevering de conventie van de server voor versies of delen nodig hebben. Als je deze functies door elkaar haalt, kunnen duplicaten ontstaan of kunnen verschillende afleveringen worden samengevoegd.
Gebruikers hebben gemeld dat verschillende naamgevingsstijlen ertoe leidden dat dezelfde aflevering meer dan één keer verscheen. Een Jellyfin-issue schrijft dubbele vermeldingen toe aan inconsistente naamgeving van afleveringen tussen meerdere kopieën.
Test situaties met meerdere afleveringen en meerdere versies afzonderlijk. Een gecombineerd bestand kan een patroon zoals S01E01-E02 gebruiken, terwijl meerdere kwaliteitsversies dezelfde afleveringsidentiteit moeten behouden, aangevuld met een ondersteund versielabel. Bewaar de oorspronkelijke bestanden totdat de toepassing ze correct groepeert.
Houd specials en bonusmateriaal buiten de normale seizoensnummering
Plaats echte specials in het verwachte specialseizoen van de toepassing, meestal Season 00 met bestandsnamen zoals S00E##. Plaats materiaal achter de schermen in een ondersteunde extras-structuur in plaats van zelf normale afleveringsnummers te bedenken.
Uit recente tests met Jellyfin blijkt dat speciale functies en afleveringsvarianten met elkaar kunnen botsen wanneer verschillende naamgevingsrollen in één seizoen voorkomen. Het probleem betreft gemengde varianten en speciale functies, niet simpelweg een fout in metadata op serieniveau.
Verplaats één bonusbestand naar de ondersteunde locatie voor extras of specials en voer een gerichte scan uit. Als normale afleveringen daarna direct worden gekoppeld, houd je het bonusmateriaal buiten de hoofdreeks met afleveringen die door de parser wordt verwerkt.
Controleer de afleveringsvolgorde voordat je correct genummerde bestanden hernoemt
Een bestand kan een geldig SxxExx-kenmerk bevatten en toch de verkeerde titel weergeven wanneer de bibliotheek de uitzendvolgorde verwacht, terwijl de bestanden de dvd-volgorde, absolute volgorde, productievolgorde of een andere provider-specifieke volgorde gebruiken.
In een Jellyfin-issue werden problemen met de afleveringsvolgorde gekoppeld aan de geselecteerde metadataprovider en de weergavevolgorde. Dit laat zien dat de volgorde per provider kan verschillen, zelfs wanneer de bestandsnamen structureel correct zijn.
Vergelijk één seizoen met de afleveringslijst van de gekozen provider voordat je bestanden hernoemt. Wijzig de volgorde voor de bibliotheek of serie wanneer de bestanden al een legitieme volgorde volgen; hernoem bestanden alleen wanneer hun nummering daadwerkelijk niet overeenkomt met de beoogde bron.
Scan één gecontroleerde map opnieuw en bewaar de hernoemingslijst
Maak een testmap met één normale aflevering, één bestand met meerdere afleveringen, één special en één alternatieve versie. Pas het voorgestelde naamgevingspatroon toe en scan die map vervolgens in een geïsoleerde of tijdelijke bibliotheek.
De ZimaSpace-handleiding over toepassingsspecifieke naamgevingsregels legt uit waarom mediabibliotheken hun eigen voorspelbare conventie nodig hebben in plaats van een algemene standaard voor bestandsnamen.
De oplossing voor de naamgeving is voltooid wanneer elk testitem de juiste serie, het juiste seizoen, de juiste aflevering, editie en titel krijgt, er geen duplicaten verschijnen en het resultaat behouden blijft na een metadata-vernieuwing. Bewaar de oude-naar-nieuwe hernoemingslijst, zodat afspeellijsten, back-uptools en andere toepassingen veilig kunnen worden bijgewerkt.
Ondersteuning & Tips
Meer om te lezen

Waarom herstelt een Docker-volume de bestandsinhoud, maar gaan uitgebreide bestandskenmerken verloren?
Een diagnose van volumeterugzetting met een inventaris van xattrs, tar- en Rsync-opties, naamruimten, ondersteuning voor bestemmingen, machtigingen, labels, app-metagegevens en tests.

Waarom behoudt een actieve container zijn oude geheugenlimiet nadat het Compose-bestand is gewijzigd?
Een diagnose van geheugenlimieten met aandacht voor actieve cgroups, herstarten versus opnieuw aanmaken, Compose-velden, harde en zachte limieten, bovenliggende scopes, swap en runtime-heaps.

Waarom maakt het herstarten van een reverse proxy elke sessie voor één zelfgehoste app ongeldig?
Een diagnose van sessieverlies met aandacht voor de reikwijdte van herstarts, cookie-eigenaarschap, geheimenrotatie, cachegestuurde sessies, sticky routing, authenticatiegateways en herstel.

