Hoe je het herschrijven van mediametadata tijdens bibliotheekonderhoud voorkomt

Eva Wong is de Technisch Schrijver en en vaste knutselaar bij ZimaSpace. Een levenslange geek met een passie voor homelabs en open-source software, zij is gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva gelooft dat zelf-hosting leuk moet zijn, niet intimiderend. Met haar tutorials stelt ze de community in staat om hardware-setup te ontrafelen, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Herschrijven van mediametadata is het eenvoudigst te voorkomen wanneer samengestelde velden en artwork vóór het begin van onderhoud worden ondersteund door duurzame bronnen.

Een scan, vernieuwingsactie van een provider, databaseopschoning, padwijziging of serverupgrade kan heel verschillende lagen van een mediabibliotheek raken. Bepaal vóór het onderhoud welke titels, posters, collecties, NFO-bestanden en handmatig bewerkte velden leidend zijn; vergrendel wat de server ondersteunt, maak een back-up van lokale sidecars en artwork en voer de minst ingrijpende vernieuwingsmodus uit op één testitem. Kies niet voor ‘alle metadata vervangen’ alleen omdat de onderhoudstaak toevallig de hele bibliotheek betreft.

Breng vóór het onderhoud in kaart welke metadata is samengesteld

Kies een representatieve set films en afleveringen en noteer aangepaste titels, sorteernamen, provider-ID's, collecties, posters, achtergronden, edities en handmatig gecorrigeerde beschrijvingen. Noteer ook of elke waarde alleen in de database bestaat of daarnaast in een lokaal NFO- of artworkbestand staat.

Een actuele Jellyfin-metadatagids raadt aan om velden die je hebt samengesteld te vergrendelen voordat je brede metadatabewerkingen uitvoert.

Als je niet kunt vaststellen welke waarden bewust zijn ingesteld, begin dan niet met een vernieuwing waarbij alles wordt vervangen. Exporteer eerst een kleine auditset of maak er screenshots van, zodat je een ongewenste wijziging kunt detecteren in plaats van die pas weken later op te merken.

Maak back-ups van NFO-bestanden en lokaal artwork als duurzame bronnen

Wanneer de bibliotheek lokale NFO-bestanden, posters of achtergronden als leidende metadata gebruikt, kopieer ze dan samen met de media of neem ze op in de onderhoudsback-up. Controleer de tijdstempels en checksums van enkele voorbeelden.

Jellyfin ondersteunt NFO-bestanden als lokale metadata en kan metadata terugschrijven naar die bestanden wanneer de NFO-schrijver is ingeschakeld.

Ga er niet van uit dat alleen een databaseback-up alle handmatig beheerde sidecars bewaart. Ga omgekeerd ook niet ervan uit dat het NFO-bestand leidend is als de bibliotheek bewerkingen altijd alleen in de serverdatabase heeft opgeslagen.

Geef de voorkeur aan lokaal artwork wanneer stabiliteit van posters belangrijk is

Voor posters of achtergronden die providerwijzigingen moeten overleven, sla je de gekozen afbeelding op volgens de ondersteunde lokale naamgevingsconventie van de mediaserver en maak je er samen met de mediabibliotheek een back-up van.

Plexopedia laat zien dat lokale posters bestand zijn tegen wijzigingen door providers doordat artwork als een duurzame lokale asset wordt bewaard.

Test één titel voordat je de conventie op de hele bibliotheek toepast. Lokaal artwork verbetert de reproduceerbaarheid, maar zorgt ook voor bestanden die door back-up-, synchronisatie- en rechtenbeleid behouden moeten blijven.

Gebruik de minst ingrijpende vernieuwingsmodus

Maak onderscheid tussen een normale bibliothe scans, een metadatavernieuwing, een bewerking waarbij alle metadata wordt vervangen en een optie waarbij bestaande afbeeldingen worden vervangen. Onderhoud waarbij alleen opslagpaden of database-indexen worden gewijzigd, vereist zelden dat elk veld en elke afbeelding wordt vervangen.

Een geval uit de probleemoplossing van Emby laat zien hoe alles vervangen artwork kan overschrijven tijdens een handmatige vernieuwing.

Begin met ‘scannen naar nieuwe of bijgewerkte bestanden’ of het beperkte equivalent van het platform wanneer dat het doel bereikt. Schakel alleen over naar een destructieve vernieuwing voor items waarvan de metadata bewust opnieuw wordt opgebouwd.

Controleer de bron van waarheid voordat je terugschrijft naar mediamappen

Als meerdere toepassingen dezelfde mediamap delen, bepaal dan welke toepassing NFO-bestanden, artwork of tags mag schrijven. Twee servers die dezelfde sidecars schrijven, kunnen routineonderhoud veranderen in een metadataconflict tussen toepassingen.

De metadata-instructies van Firecore laten zien dat artwork bewust kan worden overschreven op client- en bibliotheekniveau.

Gebruik waar mogelijk één duurzame schrijver voor gedeelde sidecars, of maak de mediamount alleen-lezen voor toepassingen die de bestanden uitsluitend hoeven te lezen. Het doel is een duidelijke bron van waarheid, niet het grootst mogelijke aantal schrijvers van metadata.

Voer onderhoud eerst uit op een kleine testbibliotheek

Maak een tijdelijke bibliotheek of selecteer een kleine map met aangepast artwork, lokale NFO-bestanden, collecties, een bewerkte titel en een normaal, ongewijzigd item. Voer daar eerst exact de geplande onderhoudsactie uit.

Plex documenteert dat ondersteunde lokale assets naamgevingsregels volgen, zodat je in een testbibliotheek kunt controleren of duurzame lokale assets na het onderhoud nog steeds worden gelezen.

Vergelijk de testitems vóór en na de scan, vernieuwing, padwijziging of upgrade. Het onderhoudsbeleid is alleen veilig wanneer samengestelde velden stabiel blijven en bedoelde updates van providers nog steeds werken. Het gerelateerde ZimaSpace-artikel over aangepaste posters die na een vernieuwing terugvallen is de herstelroute als samengesteld artwork al is gewijzigd.

Veelgestelde vragen

Herschrijft een normale bibliotheeks scan altijd metadata?

Nee. Scan- en vernieuwingsmodi verschillen, en het gedrag hangt af van de server, metadatabronnen en geselecteerde opties. Test de exacte onderhoudsactie in plaats van elke scan als ‘alles vervangen’ te behandelen.

Moeten mediamappen tijdens het onderhoud alleen-lezen zijn?

Alleen-lezen mounts kunnen bronbestanden en sidecars beschermen wanneer de server daar niet hoeft te schrijven, maar ze kunnen het bewust opslaan van NFO-bestanden of artwork ook blokkeren. Bepaal de grens op basis van je beleid voor de bron van waarheid.

Is een back-up van de metadatadatabase voldoende om aangepaste posters te beschermen?

Alleen als de poster daadwerkelijk in die database of back-up van appgegevens is opgeslagen en daaruit kan worden hersteld. Van lokale artworkbestanden moet je ook afzonderlijk een bestandsback-up maken.

Ondersteuning & 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.