The scanners and metadata agents used by Plex will work best when your major types of content are separated from each other. We strongly recommend separating movie and television content into separate main directories. For instance, you might use something like this:
/Media /Movies movie content /Music music content /TV Shows television content
Warning!: Plex will do its best to appropriately find and match content. However, a failure to separate content such as movies and TV shows may result in unexpected or incorrect behavior.
You might have your own image files for movie posters & backgrounds, subtitles, your own movie “extras”, etc. To use these, ensure they are named and organized, and that the Local Media Assets source is enabled and ordered correctly.
Enable “Local Media Assets”
“Local Media Assets” is an Agent source that loads local media files or embedded metadata for a media item. To do this, ensure the Agent source is enabled and topmost in the list:
- Launch the Plex Web App
- Choose Settings from the top right of the Home screen
- Select your Plex Media Server from the horizontal list
- Choose Agents
- Choose the Library Type and Agent you want to change
- Ensure Local Media Assets is checked
- Ensure Local Media Assets is topmost in the list
Related Page: Agents
Local Artwork Assets
Supported File Formats
There are a number of supported custom media items that need to be named correctly so they are detected. The supported image file formats are:
Posters are typically displayed for movies on Plex App dashboards, library views, and when looking at details for the movie. Poster art is typically of 1:1.5 aspect ratio. Custom Poster artwork will be detected and used if named and stored as follows:
MovieName (Release Date).extor
Movie/MovieName (Release Date)/Custom_Poster_Name.ext
ext is the file extension. (Some operating systems such as Windows may hide your file extensions by default.)
/Movies /Batman Begins (2005) Batman Begins (2005).mkv poster.jpg
Multiple Poster Images
More than one poster image can be included. The poster used can be selected in the Plex Web App. For multiple items to be scanned, they should be named as follows:
-X is a number
/Movies /Avatar (2009) Avatar (2009).mkv poster.jpg poster-2.png Batman Begins (2005).mkv Batman Begins (2005)-1.jpg Batman Begins (2005)-2.tbn
Background (Fanart) Artwork
Background art is often displayed in the background when looking at the details page for a movie. It can also be used in the background elsewhere or for a slideshow or screensaver. Background art typically uses a 16:9 aspect ratio. Local background artwork or “fanart” can be specified as follows:
MovieName (Release Date)-fanart.extor
Movies/MovieName (Release Date)/Custom_Fanart_Name.ext
Custom_Fanart_Name can be one of the following:
/Movies Avatar (2009)-fanart.jpg Avatar (2009).mkv
/Movies /Avatar (2009) Avatar (2009).mkv fanart.jpg
Multiple Background (Fanart) Images
More than one Fanart image can be included. The Fanart image used can be selected in the Plex Web App. For multiple items to be scanned, they should be named as follows:
-X is a number
/Movies /Avatar (2009) Avatar (2009).mkv fanart.jpg fanart-2.png Batman Begins (2005).mkv Batman Begins (2005)-fanart-1.jpg Batman Begins (2005)-fanart-2.tbn
External Subtitle Files
Several formats of subtitle files are supported and can be picked up by the Local Media Assets scanner:
- SSA (or ASS)
Other formats such as VOBSUB, PGS, etc. may work on some Plex Apps but not all. If you use the Universal Transcoder, both VOBSUBS and PGS subtitles will be “burned in” during the transcoding process and shown.
Related Pages: Transcoding Media
Subtitle files need to be named as follows:
MovieName (Release Date).[Language_Code].extor
Movies/MovieName (Release Date).[Language_Code].ext
Movies/MovieName (Release Date).[Language_Code].forced.ext
[Language_Code] is defined by the ISO-639-1 (2-letter) or ISO-639-2/B (3-letter) standard.
/Movies Avatar (2009).mkv Avatar (2009).en.srt
/Movies /Avatar (2009) Avatar (2009).mkv Avatar (2009).eng.ass
Note: If the language code is not added, the Plex Apps will show “Unknown” instead of the subtitle language and the automatic process which determines if the subtitle should be shown or not will not work as intended.
Tip!:”forced” is a special tag which make the subtitle enabled even if it does not necessarily follow the rules set in your server’s language settings. Normally used for subs which only contain the translation for foreign parts.
Local Trailers and Extras
If you have trailers, interviews, behind the scenes videos, or other “extras” type content for your movies, you can add those.
Related Page: Cinema Trailers & Extras
Local extras can be located alongside the main movie file in a directory named for the movie. They’re specified by using specific naming at the end of the filename. Local inline extras will be detected and used if named and stored as follows:
Movie/MovieName (Release Date)/Descriptive_Name-Extra_Type.ext
-Extra_Type is one of:
Note: The filename must end in the
-Extra_Type value exactly. The hyphen is important and you cannot have spaces after it.
Tip!: Besides the extras themselves, you can only have the main movie file in the directory. If you have multiple versions of the movie together, use the “Organized in Subdirectories” method below.
It is recommended that you provide some sort of descriptive name for the extra before specifying the type at the end of the filename.
/Movies /Avatar (2009) Avatar (2009).mkv Arrival-scene.mp4 Bar Fight-deleted.mp4 Performance Capture-behindthescenes.mkv Sigourney Weaver-interview.mp4 Stephen Lang-interview.mp4 Teaser Trailer-trailer.mp4 Theatrical Trailer #1-trailer.mp4 Theatrical Trailer #2-trailer.avi
Organized in Subdirectories
You can organize your local extras into specific subdirectories inside the main directory named for the movie. Extras will be detected and used if named and stored as follows:
Movie/MovieName (Release Date)/Extra_Directory_Type/Descriptive_name.ext
Extra_Directory_Type is one of:
Behind The Scenes
It is recommended that you provide some sort of descriptive name for the extras filenames.
/Movies /Avatar (2009) Avatar (2009).mkv /Behind The Scenes Performance Capture.mkv /Deleted Scenes Bar Fight.mp4 Lost Sister.mkv /Interviews Sigourney Weaver.mp4 Stephen Lang.mp4 /Scenes Arrival.mp4 /Trailers Teaser Trailer.mp4 Theatrical Trailer #1.mp4 Theatrical Trailer #2.mp4