Movie library guide
How to rename movie files and organize your movie library
A movie collection usually starts as a folder of downloads and rips with names like Dune.Part.Two.2024.2160p.WEB-DL.DDP5.1.Atmos.DV.HDR.H.265-GROUP.mkv, dune 1984 dvdrip.avi and movie_final_v2.mp4. Plex, Jellyfin, Emby and Kodi can read some of that, but they guess, and wrong guesses mean the wrong poster, the wrong year or two films merged into one.
This guide gives you one naming convention and one folder structure that all four servers understand. It covers the Title (Year) rule, scene names, editions like the Director's Cut, keeping 4K and 1080p copies of the same film, multi-part files, extras, franchises, foreign titles, how to lay out your drives or NAS, and how to back up before you rename anything.
The universal rule: Title (Year)
Every media server matches a movie by looking up its title and year in a metadata database, usually TMDB (The Movie Database), sometimes IMDb. So the single most useful thing you can do is give each file a clean title followed by the release year in parentheses:
Title (Year).ext
Inception (2010).mkv
The Matrix (1999).mkv
Spider-Man Across the Spider-Verse (2023).mkvWhy the year matters so much
Titles are not unique. Without a year, Dune.mkv could be David Lynch's 1984 film or Denis Villeneuve's 2021 film, and the server has to pick one. The same trap exists for dozens of remakes and reboots:
| Ambiguous title | Correct file names |
|---|---|
| Dune | Dune (1984).mkv and Dune (2021).mkv |
| The Lion King | The Lion King (1994).mkv and The Lion King (2019).mkv |
| Total Recall | Total Recall (1990).mkv and Total Recall (2012).mkv |
| True Grit | True Grit (1969).mkv and True Grit (2010).mkv |
| Suspiria | Suspiria (1977).mkv and Suspiria (2018).mkv |
Use the year shown on TMDB for that film, which is normally its first release. If a festival premiere and the theatrical release fall in different years, go with TMDB rather than the date on your disc or download, because that is the database your server queries.
Characters to avoid
Windows refuses < > : " / \ | ? * in file names, and a NAS shared over SMB inherits the same limits. Titles with a colon are the usual victims: Mission: Impossible - Dead Reckoning Part One becomes Mission Impossible - Dead Reckoning Part One (2023).mkv. Dropping the colon or replacing it with - both match fine. Also avoid a trailing period or space at the end of a name, which Windows silently strips.
Put the year in round brackets, not square ones. Jellyfin and Emby reserve square brackets for database IDs such as [tmdbid-438631], and Plex uses curly braces for {tmdb-438631} and {edition-...}.
Best folder structure for movies: one folder per film
You can drop every file loose in one Movies folder and servers will still scan it, but one folder per movie is the structure that Plex, Jellyfin, Emby and Kodi all recommend. It gives each film a home for its subtitles, posters, extras and alternate versions, and it stops a stray trailer.mp4 from being mistaken for a whole film.
Movies/
├── Dune (1984)/
│ └── Dune (1984).mkv
├── Dune (2021)/
│ ├── Dune (2021).mkv
│ └── Dune (2021).en.srt
└── Inception (2010)/
├── Inception (2010).mkv
└── poster.jpgThe folder name and the file name should be identical apart from the extension. Jellyfin depends on this for multiple versions, and it keeps things predictable for every other server.
Optional: add the database ID
If a film keeps matching the wrong entry, add its TMDB or IMDb ID to the folder name. The syntax differs per server:
| Server | Folder name with an ID |
|---|---|
| Plex | Dune (2021) {tmdb-438631} or Dune (2021) {imdb-tt1160419} |
| Jellyfin | Dune (2021) [tmdbid-438631] or Dune (2021) [imdbid-tt1160419] |
| Emby | Dune (2021) [tmdbid=438631] or Dune (2021) [imdbid=tt1160419] |
| Kodi | No folder tag: use an .nfo file or choose the match manually |
You find the TMDB ID in the address bar of the film's page on themoviedb.org (/movie/438631-dune) and the IMDb ID on imdb.com (/title/tt1160419/). Server-specific details are in the Plex naming guide, the Jellyfin naming guide, the Emby naming guide and the Kodi naming guide.
Decoding scene and release names
Release names pack the title, year and technical details into one string separated by dots. Here is a typical one taken apart:
Dune.Part.Two title (Dune: Part Two)
2024 release year
2160p resolution (4K UHD)
WEB-DL source: file taken from a streaming service, not re-encoded
DDP5.1 audio: Dolby Digital Plus, 5.1 channels
Atmos Dolby Atmos object audio inside that track
DV Dolby Vision HDR
HDR HDR10 base layer for screens without Dolby Vision
H.265 video codec, also called HEVC
-GROUP the release group that published itEverything after the year is useful information about the file, but it is not part of the movie's identity. The clean name is Dune Part Two (2024).mkv. Your server reads resolution, codec, HDR and audio format directly from the file, so you lose nothing by removing those tags.
| Tag | Meaning |
|---|---|
BluRay, BDRip, REMUX | From a Blu-ray. REMUX keeps the original video and audio untouched; BDRip is re-encoded |
WEB-DL, WEBRip | From a streaming service. WEB-DL is the original stream, WEBRip was captured and re-encoded |
HDTV, DVDRip | Recorded from TV or ripped from a DVD |
x264, H.264, AVC | Older, very compatible video codec |
x265, H.265, HEVC | More efficient codec used for most 4K files |
DTS-HD.MA, TrueHD, AAC, DDP | Audio formats |
PROPER, REPACK | A corrected re-release of an earlier, faulty one |
If you want to remember the quality at a glance, keep it as a version label rather than in the title: Dune Part Two (2024) - 2160p.mkv. Plex, Jellyfin and Emby ignore what comes after - when matching.
Editions, Director's Cuts and 4K plus 1080p copies
Two different situations get confused here. A version is the same cut of the film in another quality (4K and 1080p). An edition is a different cut (Theatrical, Director's Cut, Extended). Servers handle them differently.
4K and 1080p of the same movie
Put both files in the same movie folder and add a label after - . Plex, Jellyfin and Emby group them into one library entry and let you pick the version at playback:
Movies/
└── Dune (2021)/
├── Dune (2021) - 2160p.mkv
└── Dune (2021) - 1080p.mkvJellyfin is strict about one detail: each file must start with exactly the folder name, character for character, including any ID tag. If the folder is Dune (2021) [tmdbid-438631], the files must be Dune (2021) [tmdbid-438631] - 2160p.mkv and so on, or they show up as separate movies. Jellyfin sorts resolution labels from highest to lowest, so the 4K copy becomes the default.
Some people prefer two separate libraries instead (Movies and Movies 4K on different folders), so that remote users on weak connections only see the 1080p copies. Both approaches work; just do not mix them for the same film.
Director's Cut and other editions
Plex has a dedicated edition tag in curly braces. Each edition goes in its own folder and appears as a separate entry. Plex documents that this feature requires a Plex Pass on the server owner's account; without it, the files fall back to being listed as versions.
Movies/
├── Blade Runner (1982) {edition-Final Cut}/
│ └── Blade Runner (1982) {edition-Final Cut}.mkv
└── Blade Runner (1982) {edition-Theatrical}/
└── Blade Runner (1982) {edition-Theatrical}.mkvJellyfin and Emby have no separate edition syntax. Treat the edition as a version label in the same folder: Blade Runner (1982) - Final Cut.mkv and Blade Runner (1982) - Theatrical.mkv. Kodi 21 added movie versions and extras to its library; older Kodi releases list each file as its own movie.
Do not write the edition inside the parentheses, as in Blade Runner (1982 Final Cut). The year stops being recognized and the film may not match at all.
Multi-part files (CD1, CD2), extras and trailers
Films split across several files
Old DVD rips often split a long film into two files. Name the parts with a standard suffix and the server plays them back to back as one movie:
Movies/
└── The Lord of the Rings The Return of the King (2003)/
├── The Lord of the Rings The Return of the King (2003) - cd1.avi
└── The Lord of the Rings The Return of the King (2003) - cd2.aviThe recognized words are cd, disc, disk, dvd, part and pt, followed by a number: -part1, - pt2, .cd1 all work in Plex, Jellyfin and Kodi. Keep the parts in the same folder, give them the same format, and do not mix a part suffix with a version label on the same file. If you can, join the parts into a single file with a tool like MKVToolNix: it is the most reliable option on every player.
Extras, trailers and featurettes
Bonus material lives inside the movie folder, either in named subfolders or with a suffix on the file name. These folder names work in Plex, Jellyfin and Emby:
Movies/
└── Inception (2010)/
├── Inception (2010).mkv
├── Behind The Scenes/
│ └── The Dream Is Collapsing.mkv
├── Deleted Scenes/
├── Featurettes/
├── Interviews/
└── Trailers/
└── Official Trailer.mkvOther recognized folders include Scenes, Shorts and Other. If you prefer to keep everything flat, add a suffix instead: Inception (2010)-trailer.mkv, Dream Sequence-deleted.mkv, Making Of-behindthescenes.mkv, Cast Interview-interview.mkv, Visual Effects-featurette.mkv.
An extra sitting loose in the Movies folder with no suffix and no subfolder is scanned as a movie. That is how libraries end up with a film called "Official Trailer".
Collections and franchises
It is tempting to group a franchise on disk, with a Star Wars folder holding every episode. Resist it. Media servers build collections from metadata, not from your folders: TMDB already knows that The Matrix (1999), The Matrix Reloaded (2003) and The Matrix Resurrections (2021) belong to the same collection.
Movies/
├── The Matrix (1999)/
├── The Matrix Reloaded (2003)/
├── The Matrix Revolutions (2003)/
└── The Matrix Resurrections (2021)/- Plex can create collections automatically from TMDB data; the threshold is the library's *Minimum automatic collection size* setting under Advanced. You can also build collections by hand from the movie's Edit menu.
- Jellyfin and Emby have a library option to add movies to collections automatically using TMDB collection data.
- Kodi groups films into *Movie sets* when the scraper returns collection information.
The flat layout also keeps sorting simple, survives a change of server and avoids nested paths that some scanners and backup tools handle badly. Name each film by its own title, not a franchise prefix: Rogue One (2016), not Star Wars - Rogue One (2016), because TMDB lists it as "Rogue One: A Star Wars Story" and an invented prefix can break the match.
Foreign films: original title or translated title?
TMDB stores every film with its original title (the one in its original language) and a list of translated titles per language. Amélie (2001) has the original title *Le Fabuleux Destin d'Amélie Poulain*; Studio Ghibli's Spirited Away (2001) is *千と千尋の神隠し* in Japanese.
TMDB search finds a film by its original title, its English title or most translations, so any of these file names will usually match as long as the year is correct:
Amélie (2001).mkv
Le Fabuleux Destin d'Amélie Poulain (2001).mkv
Die fabelhafte Welt der Amélie (2001).mkvWhat your library displays does not depend on the file name: Plex, Jellyfin and Emby show the title in the metadata language you set on the library. So choose the file name for yourself and stay consistent. Two sensible rules:
- Use the title in your library's language (
Le Voyage de Chihiro (2001)in a French library) if you browse your folders by hand. - Use the original title for films whose localized names vary a lot between countries, and add the TMDB ID if the match is unreliable. Accents and non-Latin characters are fine on modern Windows, macOS, Linux and NAS systems.
Organizing a movie collection on a hard drive or NAS
Media servers choose how to identify files from the library type: a Movies library looks for Title (Year), a TV library looks for S01E01. Mixing films and episodes in one folder is the most common cause of bad matches, so give each type its own top-level folder and its own library.
Media/
├── Movies/
│ └── Dune (2021)/
├── TV Shows/
│ └── Breaking Bad/
│ └── Season 01/
├── Anime/
│ └── Frieren Beyond Journey's End/
│ └── Season 01/
└── Anime Movies/
└── Your Name (2016)/- Anime films are movies: name them
Title (Year)and keep them in a Movies-type library. A separateAnime Movieslibrary just keeps them out of your main movie list. - On a NAS, create one shared folder (for example
mediaon a Synology, mounted as/volume1/mediainside the NAS and\\NAS\mediafrom Windows) and point each library at its subfolder. Avoid pointing two libraries at the same folder. - Several drives are fine: a library can include
D:\MoviesandE:\Moviesat once, as long as each film exists on only one of them. - Keep the drive layout stable. Changing a drive letter or share path makes the server think every film disappeared and came back.
Back up before you rename anything
Renaming is not destructive in itself, but a large batch can confuse your server and a wrong match can give a file the wrong title. A few minutes of preparation makes every mistake reversible:
- Save a list of the current names. On Windows, open a terminal in the folder and run
dir /s /b > before.txt; on macOS or Linux,find . -type f > before.txt. You can always find what a file used to be called. - Take a snapshot if your NAS supports it. Synology and QNAP volumes on Btrfs or ZFS can snapshot a shared folder in seconds, and restoring names from a snapshot is instant.
- Pause automatic cleanup in your server. In Plex, turn off *Empty trash automatically after every scan* under Settings > Library, so renamed files are re-detected instead of removed with their watch history.
- Start with one folder. Rename ten films, scan, check posters and years, then do the rest.
- Stop Radarr or other download managers from renaming the same folder at the same time, or set them to your new convention.
Never rename files inside VIDEO_TS or BDMV disc structures. Players rely on those exact internal names; name the folder that contains them instead, for example Dune (1984)/VIDEO_TS/.
Renaming movie files in bulk with RenameFlow
Renaming a few films by hand is easy. Renaming hundreds of scene names is where a tool saves real time. RenameFlow is a web app that runs in Chrome, Edge or Opera on a desktop computer, with nothing to install. Your files are renamed in place on your own disk and are never uploaded; only the detected titles are sent to the metadata services.
- Open a folder of movies. RenameFlow reads the scene names (title, year, quality, source, codec, group) and finds each film on TMDB.
- Check the proposed matches. You confirm or change each one, which is where you catch
Dune (1984)versusDune (2021). - Pick the Plex, Jellyfin or Kodi preset. For movies all three produce
Title (Year).ext, soDune.Part.Two.2024.2160p.WEB-DL.DDP5.1.Atmos.DV.HDR.H.265-GROUP.mkvbecomesDune Part Two (2024).mkv, with characters Windows forbids (like the colon) removed. - Rename. Every change is kept in the rename history, which you can export.
Be aware of what it does not do: RenameFlow renames files only. It does not create, move or rename folders. After renaming, you create the Dune Part Two (2024) folder yourself and move the file into it (on Windows, a new folder plus drag and drop; on macOS, select files and choose *New Folder with Selection*). It also leaves files inside DVD and Blu-ray structures untouched.
If you want the quality kept in the name, as in Dune Part Two (2024) - 2160p.mkv, Pro plans support custom patterns with tokens such as {title} ({year}) - {quality}. The free plan renames 15 files a day; see pricing for the paid plans.
Turn scene names into clean movie titles
Open a folder in RenameFlow, confirm each TMDB match and rename your movies to Title (Year) in a few clicks, right on your own disk.
Try RenameFlow free