Movie Naming
This file naming guide applies to movies, home videos and music videos. For tv episode naming, see TV naming.
Library Setup
When setting up the library, make sure to select Movies, Home videos, or Music videos as the content type.
Emby supports several different formats and naming conventions such as ISO copies of discs to DVD/Blu-Ray file formatted layouts which are both different types of disc copies. These formats work but are not an ideal way to build your library. Since neither of these are streaming formats they require more work by the server to transcode and stream to client apps. These formats and naming conventions are covered below.
A much better way of building a large Emby library of content is to prepare you media ahead of time using a streaming friendly format such as MP4 or MKV containers featuring H.264 (or H.265) video with at least one 2 Channel AAC default audio track along side any other audio tracks such as Dolby Digital or DTS. Media prepared in this fashion will have the greatest compatibility with all Emby clients. The idea behind preparing your media ahead of time in this fashion is to reduce the need for the Server to have to transcode (convert) media on the fly. This is not a requirement but is strongly encouraged.
Naming your media
Once you've prepared your media files, it's time to name your media in a way that allows Emby the best chance of determining what it is. The best way to do this is to use the format: "MovieName (year).extension" such as "Top Gun (1986).mp4" or "Avatar (2009).mkv". Because Emby allows many other advanced functions that can be used with your media we want to create a folder structure that aids in this use. The simplest method of doing this is to put all media related to a Movie in the same folder using a name "MovieName (year). Emby will then use the folder name to determine the movie. The use of folders for each movie helps with identification and ensuring related files are linked to the movie.
It will look like this:
\Movies\Avatar (2009)\Avatar (2009).mkv
\Movies\Pulp Fiction (1994)\Pulp Fiction (1994).mp4
\Movies\Reservoir Dogs (1992)\Reservoir Dogs (1992).mp4
\Movies\The Usual Suspects (1995)\The Usual Suspects (1995).mkv
\Movies\Top Gun (1986)\Top Gun (1986).mp4
Note
Movie folders are used internally to improve detection and would only be reflected in the library "Folders" view.
Other Folder Structures
The default library views are not by folder structure. Instead they offer metadata-based views of your library that are created automatically. If, instead, you wish to use a custom set of category folders, you could do that by adding a set of folders below the library root folder and the movies split between these category folders. Emby will work just fine with or without this additional level of folders! These category folders will be visible in the library Folders view.
In the following examples, movies are stored in year bands, each being a 30-year span category, as an example:
\Movies\Movies 1925-1954\The 39 Steps (1935)\The 39 Steps (1935).mkv
\Movies\Movies 1925-1954\Sunset Boulevard (1950)\Sunset Boulevard (1950).mkv
\Movies\Movies 1955-1984\Vertigo (1958)\Vertigo (1958).mkv
\Movies\Movies 1955-1984\Moonraker (1979)\Moonraker (1979).mp4
\Movies\Movies 1985-2014\The Italian Job (2003)\The Italian Job (2003).mkv
\Movies\Movies 1985-2014\Alex Cross (2012)\Alex Cross (2012).mp4
\Movies\Movies 2015-2044\The Girl on the Train (2016)\The Girl on the Train (2016).mkv
\Movies\Movies 2015-2044\The Ice Road (2021)\The Ice Road (2021).mp4
Note
Higher level folders below the library root folder and above the movie folders would only appear in the library "Folders" view.
ID Tags in Folder & File Names
Emby can also read a Meta-Data ID from the name.
Supported Formats:
- Name (Year) [tmdbid=xxxx]
- Name (Year) [tmdbid-xxxx]
- Name (Year) [tmdb=xxxx]
- Name (Year) [tmdb-xxxx]
- Name (Year) {tmdbid=xxxx}
- Name (Year) {tmdbid-xxxx}
- Name (Year) {tmdb=xxxx}
- Name (Year) {tmdb-xxxx}
Supported ID's:
- tvdb
- tmdb (Moviedb)
- imdb
Example: Casino Royale (2006) [tmdbid=36557]
Emby supports the following tags with the host website for lookup.
tmdbid (https://www.themoviedb.org/)
imdbid (https://www.imdb.com/)
tvdbid (https://thetvdb.com/)
Multi-version movies
Multiple versions of the same content must be stored in a single movie folder.
/Movies
/300 (2006)
/300 (2006)/300 (2006) - 1080p.mkv
/300 (2006)/300 (2006) - 4K.mkv
/300 (2006)/300 (2006) - 720p.mp4
/300 (2006)/300 (2006) - extended edition.mp4
/300 (2006)/300 (2006) - directors cut.mp4
/300 (2006)/300 (2006) - 3D.hsbs.mp4
Each version must begin with the folder name, followed by " - ".
If using the dash method anything following the dash will be what you see in the Emby client app.
Note
The above example includes a 3D version, which is discussed in the 3D Video naming guide. Also, this feature is primarily designed for multiple qualities of the same item. It can be used for different "cuts" but there may be some limitations in doing that.
Note
There is a limit on the number of different versions for a media item. Up to 8 different versions will appear in a list of a movie versions.
Movie extras
Special features for movies can be stored as video files in an extras folder under movie folders. Nested folders are not supported.
In addition to extras, several other sub-folder names are supported:
- extras
- specials
- shorts
- scenes
- featurettes
- behind the scenes
- deleted scenes
- interviews
- trailers
/Movies
/Home Alone (1990)
Home Alone (1990).mkv
/extras
deleted-scenes.mkv
/behind the scenes
video1.mkv
/interviews
video1.mkv
Note
Be sure the movie file is present before adding these additional "extras" to avoid mis-identification.
Note
All the different types of extras shown above will appear together in the "Extras" row in the item detail view.
Video images
Images are supported in video folders. Below is a table of the supported image file names. Supported image extensions are jpg, jpeg, png, gif and tbn.
Several image types support multiple file names. They are listed in the order that they're checked for.
| Image Type | Supported file names |
|---|---|
| Primary | {name}.ext |
| {name}-poster.ext | |
| {name}-cover.ext | |
| {name}-default.ext | |
| {name}-movie.ext | |
| folder.ext | |
| poster.ext | |
| cover.ext | |
| default.ext | |
| movie.ext | |
| Art | {name}-clearart.ext |
| clearart.ext | |
| Backdrop | backdrop.ext, backdropX.ext |
| fanart.ext, fanart-X.ext | |
| background.ext, background-X.ext | |
| art.ext, art-X.ext | |
| extrafanart (subfolder)/fanartX.ext | |
| Banner | {name}-banner.ext |
| banner.ext | |
| Disc | {name}-disc.ext |
| {name}-cdart.ext | |
| disc.ext | |
| cdart.ext | |
| Logo | {name}-clearlogo.ext |
| clearlogo.ext | |
| {name}-logo.ext | |
| logo.ext | |
| Thumb | {name}-thumb.ext |
| {name}-landscape.ext | |
| thumb.ext | |
| landscape.ext |
{name} represents the video file name, without extension. For videos that are not contained within their own folder, only the conventions using {name} are supported.
For backdrops, X represents a number, and you can have any amount of numbered backdrops. For example:
\Movies
\300 (2006)
backdrop.ext
backdrop1.ext
backdrop2.ext
backdrop3.ext
DVD and Blu-ray file formats
Dvd and Blu-ray folder structures are also supported. To be recognized as a dvd structure, the folder must contain either a VIDEO_TS subfolder, or a VIDEO_TS.ifo file. To be recognized as a blu-ray structure, the folder must contain a BDMV subfolder.
\Movies\Alien (1979)\VIDEO_TS.IFO
\Movies\Léon (1994)\VIDEO_TS.IFO
\Movies\Scarface (1983)\VIDEO_TS.IFO
Or:
\Movies\Alien (1979)\VIDEO_TS\VIDEO_TS.IFO
\Movies\Léon (1994)\VIDEO_TS\VIDEO_TS.IFO
\Movies\Scarface (1983)\VIDEO_TS\VIDEO_TS.IFO
ISO format
Emby Server has basic support for videos stored in ISO format. This includes the ability to catalog the ISO's within Emby Server, and play them in HTPC-based apps such as Emby for Kodi, Emby Windows, or Emby for Xbox. Other apps will generally only be able to play them with the use of an external player.
ISOs should be named just like any other video file, with one minor difference. Including ".dvd" or ".bluray" within the file name will allow Emby Server to automatically determine what type of ISO it is. If this is not included, it will be assumed to be DVD.
\Movies\Alien (1979)\Alien (1979).dvd.iso
\Movies\Léon (1994)\Léon (1994).bluray.iso
\Movies\Scarface (1983)\Scarface (1983).iso
Split video files (file stacking)
The following are default stacking extensions that can be added to file names. # can be 1 through 9 or A through D. Stacking is supported for video files (but only when each video is in its own folder as in the example below) as well as dvd and blu-ray folder structures. Split videos require all parts be in the same movie folder with no other videos present in that folder.
- part#
- cd#
- dvd#
- pt#
- disk#
- disc#
You can also use:
- moviename#.ext
Where # can be A through D.
Examples:
\Movies\Avatar (2009)\Avatar (2009)-cd1.mkv
\Movies\Avatar (2009)\Avatar (2009)-cd2.mkv
3D videos
3D video files are supported. See 3D videos.
Media stubs
Media stubs are supported. See media stubs.
Strm files
Strm files are supported. See strm files.
Subtitles
Subtitles are supported. See subtitles.
Theme songs & videos
Theme songs & videos are supported. See theme songs & videos.
Trailers
Trailers are supported. See trailers.