Welke naamgevingsfout voorkomt dat tv-afleveringen correct worden herkend?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

De meest voorkomende herkenningsfout ontstaat wanneer het seizoen- en afleveringsnummer ergens staat waar de scanner het niet betrouwbaar uit de bestandsnaam van het videobestand kan uitlezen.

Een mediaserver herkent tv-afleveringen aan de hand van verschillende onderdelen: de seriemap, de seizoensmap, het patroon in de bestandsnaam, de bron voor de volgorde van afleveringen, lokale NFO-gegevens en provider-ID's. Een titel kan onder de juiste serie staan en toch niet gekoppeld zijn als het daadwerkelijke bestand geen eenduidige code bevat, zoals S01E03. Stel vast waarom één aflevering niet wordt herkend en vergelijk die met één correct gekoppelde aflevering voordat je een hele bibliotheek in één keer hernoemt.

Controleer of de serie, het seizoen of de aflevering verkeerd is gekoppeld

Open het betreffende item en noteer de serie, het seizoen- en afleveringsnummer, de weergegeven titel, het bestandspad en de provider-ID's. Zo zie je of de scanner de juiste serie heeft gevonden maar de aflevering niet kon uitlezen, of de hele serie verkeerd heeft geïdentificeerd.

Een Jellyfin-probleem laat zien dat bestanden in de juiste serie en het juiste seizoen werden geplaatst, terwijl de afleveringen zelf niet werden gekoppeld omdat de bestandsnaam van het mediabestand de afleveringcode miste.

Als de serie en het seizoen kloppen, maar het afleveringsnummer ontbreekt, richt je dan op de bestandsnaam. Als de serie zelf verkeerd is herkend, controleer dan de seriemap, het jaar, de provider-ID en het bibliotheektype voordat je de schrijfwijze van de aflevering aanpast.

Zet een eenduidige SxxExx-code in de bestandsnaam van het mediabestand

Gebruik een voorspelbaar patroon, zoals Naam van de serie - S01E03 - Titel van de aflevering.mkv. Zet de seizoen- en afleveringcode in de daadwerkelijke videobestandsnaam en vertrouw niet alleen op een releasemap, downloadmap of bovenliggende map.

Alternatieve schrijfwijzen zoals 1.03, losse afleveringsnummers of codes die specifiek zijn voor een release worden mogelijk niet consistent herkend. In een Jellyfin-melding waarin slechts één aflevering werd herkend, werden namen zoals 1.01 en 1.02 gebruikt in plaats van een duidelijk patroon voor seizoen en aflevering.

Hernoem één gekopieerd testbestand volgens het canonieke patroon en scan alleen die serie opnieuw. Als het overeenkomt, 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 serie- en seizoensnummers door elkaar worden gehaald door de parser

Geef de map van de serie de serietitel en eventueel het jaar als naam, en gebruik vervolgens expliciete seizoensmappen zoals Season 01. Voeg geen extra mappen met cijfers toe die voor seizoensaanduidingen kunnen worden aangezien.

Cijfers in een serietitel kunnen dubbelzinnig zijn als de omringende structuur niet duidelijk is. In een Jellyfin-issue wordt beschreven dat titels zoals “The 100”, “24” en “Stargate SG-1” werden geïnterpreteerd als seizoensnummers.

Behoud de titel, maar maak de hiërarchie en de aanduiding in de bestandsnaam duidelijker: The 100 (2014)/Season 01/The 100 - S01E01.mkv. Verwijder geen legitieme cijfers uit de officiële serienaam alleen om een onduidelijke mapstructuur te compenseren.

Gebruik het juiste patroon voor bestanden met meerdere afleveringen en versies

Een bestand met meer dan één aflevering heeft een ondersteunde aanduiding voor meerdere afleveringen nodig, terwijl twee encodes van dezelfde aflevering de naamgevingsconventie van de server voor versies of delen nodig hebben. Als je deze doeleinden door elkaar haalt, kunnen er dubbele vermeldingen ontstaan of kunnen verschillende afleveringen worden gegroepeerd.

Gebruikers hebben gemeld dat verschillende naamgevingsstijlen ertoe leiden dat dezelfde aflevering meer dan eens verschijnt. Volgens een Jellyfin-issue zijn dubbele vermeldingen te wijten aan inconsistente naamgeving van afleveringen bij meerdere kopieën.

Test gevallen met meerdere afleveringen en meerdere versies afzonderlijk. Een gecombineerde aflevering kan een patroon gebruiken zoals S01E01-E02, terwijl versies met verschillende kwaliteit hetzelfde afleveringsnummer moeten behouden, aangevuld met een ondersteund versielabel. Bewaar de originele bestanden totdat de applicatie ze correct groepeert.

Houd specials en bonusmateriaal buiten de normale seizoensnummering

Plaats echte specials in het speciale seizoen dat de applicatie verwacht, doorgaans Season 00 met bestandsnamen als S00E##. Plaats bonusmateriaal achter de schermen in een ondersteunde structuur voor extra’s, in plaats van gewone afleveringsnummers te verzinnen.

Uit recente tests met Jellyfin blijkt dat speciale functies en afleveringsvarianten met elkaar kunnen botsen wanneer verschillende naamgevingsrollen naast elkaar voorkomen binnen één seizoen. Het probleem bestaat uit gemengde varianten en speciale functies, niet uit een eenvoudige fout in de metadata van de serie.

Verplaats één bonusbestand naar de ondersteunde locatie voor extra's of specials en voer een gerichte scan uit. Als gewone afleveringen daarna meteen goed worden herkend, bewaar bonusmateriaal dan buiten de hoofdafleveringsvolgorde van de parser.

Controleer de afleveringsvolgorde voordat je correct genummerde bestanden hernoemt

Een bestand kan een geldig SxxExx-token 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 providerspecifieke volgorde gebruiken.

Een probleem in Jellyfin bracht afleveringsvolgordeproblemen aan het licht die verband hielden met de gekozen metadataprovider en de weergavevolgorde. Dit laat zien dat de volgorde van de provider kan afwijken, zelfs als de bestandsnamen structureel geldig zijn.

Vergelijk één seizoen met de afleveringenlijst van de gekozen provider voordat je bestanden hernoemt. Wijzig de bibliotheek- of serievolgorde als de bestanden al overeenkomen met een geldige volgorde; hernoem bestanden alleen als hun nummering daadwerkelijk afwijkt van de bedoelde bron.

Scan één gecontroleerde map opnieuw en bewaar de naamkoppeling

Maak een testmap met één gewone 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.

In de ZimaSpace-gids over toepassingsspecifieke naamgevingsregels wordt uitgelegd waarom mediabibliotheken een eigen voorspelbare conventie nodig hebben in plaats van een algemene standaard voor bestandsnamen.

De oplossing voor de naamgeving is compleet wanneer elk testitem de juiste serie, het juiste seizoen, de juiste aflevering, de juiste editie en de juiste titel krijgt, er geen duplicaten verschijnen en het resultaat behouden blijft na het vernieuwen van de metadata. Bewaar de oude-naar-nieuwe-naamkoppeling, zodat afspeellijsten, back-uptools en andere toepassingen veilig kunnen worden bijgewerkt.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.