Knowledgebase

A well-organized, correctly-tagged media library makes automatic metadata matching (posters, descriptions, cast info) work reliably. This guide covers naming conventions and automation tools for keeping a library clean.

Why Naming Conventions Matter

Media servers like Jellyfin and Plex match files to metadata primarily through filename/folder naming patterns — inconsistent naming causes incorrect matches, missing artwork, or files not being recognized at all.

Standard Movie Naming Convention

Movies/
  Movie Title (2023)/
    Movie Title (2023).mkv

Standard TV Show Naming Convention

TV Shows/
  Show Name/
    Season 01/
      Show Name - S01E01 - Episode Title.mkv

Standard Music Naming Convention

Music/
  Artist Name/
    Album Name (Year)/
      01 - Track Title.mp3

Even more important for music: correct embedded ID3 tags matter more than filenames for most music servers, since they read metadata directly from the file rather than primarily from folder structure.

Automating File Renaming

Several open-source tools exist specifically for automatically renaming and organizing media files based on matched metadata — commonly used alongside download automation tools to move new files into a properly-structured library automatically.

Fixing Music Metadata in Bulk

Dedicated audio tagging tools can batch-correct ID3 tags across a large music collection, pulling correct metadata from online music databases — valuable if your library has accumulated inconsistent tagging over time from multiple sources.

Handling Multi-Part or Special Editions

Movie Title (2023) {edition-Director's Cut}/

Most media servers support edition tagging in folder names for distinguishing multiple versions of the same title.

Setting Up a Watch Folder for Automatic Import

Combine a watch-folder script (see the transcoding automation pattern in How to Set Up a Video Transcoding Pipeline with FFmpeg) with your media server's library refresh API to automatically detect and import newly added files without manual intervention.

Scheduling Regular Library Scans

Configure your media server to periodically re-scan library folders (most support a configurable schedule) — catches new additions and corrects any metadata that failed to match on first attempt.

Handling Non-English Content

Most media servers support alternate metadata language preferences — configure this explicitly if your library includes content where the default (often English) metadata source doesn't have complete information.

Backing Up Metadata Customizations

If you've manually corrected posters, descriptions, or other metadata within your media server, verify these customizations are included in your regular backup routine (typically part of the server's own database, not the media files themselves) — see how the specific platform's backup guidance handles this.

Common Errors

Wrong movie/show matched — usually caused by an ambiguous or incorrect filename; manually correct the match within the media server's interface, or fix the underlying filename to be more specific (including the release year is often key).

Some files never get metadata — verify the naming convention is followed correctly; a small deviation from the expected pattern is a common cause of failed automatic matching.

Continue Reading

• How to Install Jellyfin Media Server on a VPS
• How to Install Navidrome (Self-Hosted Music Streaming/Spotify Alternative)
• How to Set Up a Video Transcoding Pipeline with FFmpeg

Browse more articles in Media & Streaming Servers.