Plex NFO Agent Forum Preview

drzoidberg33
Fri, 06 Feb 2026 09:40:29 +0000
Metadata & Adding Files

Hi everyone!

Official support for NFO files has been a highly requested feature for a long time and we promised it would be coming towards the end of last year. Some other priorities got in the way of that but today I wanted to share the first preview build to get some feedback and test it out in the wild before we release it publicly.

This preview has support for movie and TV show (including season/episode) NFO files. Music NFO support is not currently on the roadmap but we will reevaluate that depending how much demand there is for it.

We support the widely used Kodi/XBMC NFO format. Most NFO generation tools will output to this format, if you use a tool like TinyMediaManager you can also configure the output to use the Plex preset.

How to Use

Once you have downloaded and installed the preview build below, create a new library and point it to your Movie or TV Shows path. Before saving the library, go to the Advanced pane in the library creation and choose “Plex NFO Movie” or “Plex NFO Series” from the “Agent” dropdown (if you don’t see this option please try to refresh the page in your browser).

Recommended file structures

Local image asset naming below is just one example, see supported options here:

https://support.plex.tv/articles/200220677-local-media-assets-movies/

https://support.plex.tv/articles/200220717-local-media-assets-tv-shows/

Movies

movie.nfo is the generally accepted naming if you have separate folders for each movie file. Using the exact name of the movie file is also supported, e.g. A Movie (2026).nfo

/Movies
  /A Movie (2026)
    A Movie (2026).mkv
    movie.nfo
    poster.jpg
    background.jpg
    logo.png
    square.jpg

TV Shows

season.nfo is mostly ignored, and is not required.

Episode NFO files are the minimum requirement but having a tvshow.nfo is highly recommended.

/TV Shows
  /A TV Show (2026)
    tvshow.nfo
    poster.jpg
    background.jpg
    logo.png
    square.jpg
    /Season 01
      season.nfo
      A TV Show (2026) - S01E01.mkv
      A TV Show (2026) - S01E01.nfo
      A TV Show (2026) - S01E01.jpg

Notes about the current implementation

Ratings (TMDB/IMDB/TVDB) are not yet supported. Support added in build 10505

Multi-part files are not currently supported.

FIles spanning multiple episodes are not currently supported. Support added in build 10505

While this agent does not require anything to be pulled from online sources, if you do not provide local image assets alongside your files, and the NFO points to an online asset it will try to pull the online version.

We may consider some advanced configuration options to allow more flexibility in the supported NFO formats, this will depend on user feedback.

Using embedded metadata inside MP4s will not be preferred over the NFO metadata using the default Plex NFO agent. You can still achieve this if you wish by creating a custom Metadata Agent (Settings → Metadata Agents) using the appropriate NFO provider as the primary provider and adding the Plex Local Media provider in the first position (see example below).

Accepted risk using preview builds

As preview builds have not undergone strict QA testing, issues may arise which could range from minor annoyances to permanent loss of data to your Plex database.

We always recommend running preview builds separately from your main PMS installation if possible. If you choose to use your existing database please ensure that you have recent backups.

340 posts - 59 participants