Local Media Assets - Movies

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: Server > Scanners & Agents > 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:

  • jpg
  • jpeg
  • png
  • tbn

Poster Artwork

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).ext or
  • Movie/MovieName (Release Date)/Custom_Poster_Name.ext

Where Custom_Poster_Name is:

  • cover
  • default
  • folder
  • movie
  • poster

...and 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:

  • Custom_Poster_Name-X.ext

Where -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.ext or
  • Movies/MovieName (Release Date)/Custom_Fanart_Name.ext
Where Custom_Fanart_Name can be one of the following:
  • art
  • backdrop
  • background
  • fanart
/Movies
   Avatar (2009)-fanart.jpg
   Avatar (2009).mkv

OR

/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:

  • Custom_Fanart_Name-X.ext

Where -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:

  • SRT
  • SMI
  • 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: Server > Transcoding Media

Subtitle files need to be named as follows:

  • MovieName (Release Date).[Language_Code].ext or
  • Movies/MovieName (Release Date).[Language_Code].ext
  • Movies/MovieName (Release Date).[Language_Code].forced.ext

Where [Language_Code] is defined by the ISO-639-1 (2-letter) or ISO-639-2/B (3-letter) standard.

Related Page: ISO-639-1 codes (2-letter)
Related Page: ISO-639-2/B codes (3-letter)

/Movies
   Avatar (2009).mkv
   Avatar (2009).en.srt

OR

/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: Plex Apps > Miscellaneous > Cinema Trailers & Extras

Inline

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

Where -Extra_Type is one of:

  • -behindthescenes
  • -deleted
  • -featurette
  • -interview
  • -scene
  • -short
  • -trailer

Note: The filename must end in -Extra_Type 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

Where Extra_Directory_Type is one of:

  • Behind The Scenes
  • Deleted Scenes
  • Featurettes
  • Interviews
  • Scenes
  • Shorts
  • Trailers

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