You need to make NFO edits outside of Plex. The NFO agent strictly reads, it doesn’t write.
I just installed 1.43.1.10576 from the Beata channel. I have been using TinyMediaManager for a long time, so I went ahead and set up a library pointing to one of my Movie Folders.
It looks nice but I have 2 qestions:
- I set Ratings Source to Rotten Tomatoes. On the Plex agent this provides the critic and user ratings in the movie pate. I dont see that with the NFO agent. Is this not deployed yet?
- One of the things about the plex agent is it pulls links to shorts and trailers….. Will any of this be a part of the NFO agent?
Hey all - trying to give this a whirl for my Music Video library, but can’t seem to figure out what I might be doing wrong…
I do have NFO files created, with things like artist, title, plot, etc.
I have a single video I’m trying with but can’t seem to get it to pull anything in.
Any suggestions on where to start?
The <musicvideo> type tag is not supported.
You can make it kinda work by substituting <movie> but it’s not ideal for various reasons. If you go back up the thread you’ll notice a discussion about this.
Start here: Plex NFO Agent Forum Preview - #154 by TommyVD
What do the ratings look like in your NFO files?
You can use local trailers (https://support.plex.tv/articles/local-files-for-trailers-and-extras/) but local extras via the NFO is not currently supported but is on the roadmap. We won’t be pulling in remote URLs for extras through NFO files though.
As TommyVD says, only movies and tv shows are supported currently.
Thank you for the new public release with NFO support!
After reading the documentation (https://support.plex.tv/articles/using-nfo-metadata-files-with-plex/), I have a few clarification questions:
- Is
<sortname>currently not supported for movies? - Is
<uniqueid>not supported for episodes? - Is
<mpaa>not supported for episodes? - Is
<ratings>not supported for episodes?
Is it correct that only the tags listed under “Supported Metadata Tags Reference” (https://support.plex.tv/articles/using-nfo-metadata-files-with-plex/#toc-8) are officially supported?
And that tags from the Kodi NFO specification (https://kodi.wiki/view/NFO_files/Templates) which are not listed in die Plex documentation are ignored by Plex?
Thanks in advance for any clarification!
Now that NFO support is in the latest public release, here’s my little wishlist of future refinements I hope to see in future versions.
- Local Cast images. Currently Plex still requires Cast images to come from a URL. It does not support local file paths. This poses a problem in certain of my libraries where they just appear as grey circles.
- Make sure the New Experience apps are able to show the Cast & Crew from the NFO agent. This one is pretty self explanatory and pretty critical at this point with the FireTV being the next platform to be updated to the New Experience.
- The ability to generate collections from tags. This was a very handy feature of the legacy NFO importer plug-ins.
- Some form of displaying a generic rating. Again, the old NFO importer plugins were able to just display a generic percentage if the rating didn’t come from any supported online source like imdb or tmdb. It would be nice to have this functionality back.
- Support for the
<musicvideo>type tag - Support for the NFO agent in the ‘Other Videos’ type libraries.
If these get implemented, for my use case at least, Plex will have achieved feature parity with Jellyfin when it comes to using NFO files and I can point both Plex and Jellyfin to the same files without hesitation.
Of course, I’m always happy to test any Preview or Beta versions of the server as before.![]()
It also probably makes sense to close down this preview thread in preference for topic specific threads. Less likely something could be missed as this topic already over 250 replies.
At least in Version 1.43.1.10576 I’m not seeing the NFO options for the metadata agents.
Not sure why.
Restarted the server again. I’ve found it needs a second restart after an upgrade to a server which has nfo support added.
If that doesn’t work or you have done it already empty the browsers cache and try again.
I was able to get it to work on a small test library with the movie type nfo file. You just have to sub band artist info for title stuff and band members as actors.Adding the band members as actors was pretty cool though and I can see it useful if you have a large library with people playing on multiple bands. or if you have a music video library not integrated with the global music folder.
it was okkkkmayy though not sure if it’s worth the effort. Was trying to find something that would talk to Imvdb. There’s a jellyfin plugin for that but I doubt plex supports the xml structure. My next experiment is to use the tv show type as that may be a better fit. Like have the show be the band, setup a season 1 with the videos in it and each video has a nfo….though own that I think about it having a season subfolder would for sure break inclusion on the artist pages. I’ll play around with it some.
unless I can script something it’s a lot of work when they already show on the artist page in plex music. Especially if music video is something on the roadmap (plex folks?). This could be awesome for music videos and audio books.
<sorttitle> is the field we use, this is supported on both movies and TV shows.
<uniqueid> is supported for episodes, yes. It is encouraged to use this as you’ll get more stable guids (for watch history, rating, etc.)
<mpaa> is currently only supported at the show level. I can file an issue to add this for episodes too.
<ratings> is supported for episodes.
Some things may have been left out in the docs for brevity, I’ll ask somebody to add these missing things.
Thank you for your reply!
I’m currently testing the new NFO support and noticed some inconsistencies with certain tags.
In my setup, the following tags are not being applied:
<ratings><uniqueid>
Other tags like <title> and <plot> are working as expected.
Setup:
-
Custom agent stack: Plex NFO Series → Plex Local Media → Plex Series
-
Local NFO files for episodes are correctly named (e.g. S01E01.nfo)
-
Metadata refresh performed after changes
Example snippet from my NFO:
<uniqueid default="true" type="tmdb">63808</uniqueid>
<ratings>
<rating default="true" max="10" name="themoviedb">
<value>8.1</value>
</rating>
<rating max="10" name="imdb">
<value>8.4</value>
</rating>
</ratings>
Observed behavior:
- Ratings from the NFO are ignored and Plex continues to display online ratings
- Changing or adding
<uniqueid>does not affect matching or metadata in any way
No matter what value I enter for rating in the NFO file, the TMDB rating in the Plex client does not change and stays at 83%:

There is a known issue with ratings when using a custom metadata agent and mixing it with the Plex provider. The ratings will get confused.
I still need to address that.
As for uniqueid I’m not sure exactly what you’re expecting to see? All that this does is provide a stable guid for the database item.
I’m not entirely sure what I was trying to achieve with <uniqueid> ![]()
It seems that watch status and watch history is preserved even without it, so I only included it for testing purposes.
I’ve been waiting for this to add Youtube videos downloaded with Pinchflat. It creates the NFOs as well.
I’ve set the library up as TV Shows and have the NFO agent working, however when the episode numbers start with 0, the 0 is getting dropped (as per usual) and then the agent is looking for the episode inside the NFO without the 0.
Eg. I have a video file with a title of “TV Show S2026E0219.mp4” and a NFO “TV Show S2026E021999.nfo” Plex imports the .mp4 and calls it episode 219 and then looks for the episode 219 inside the S2026E021999.nfo and doesn’t find it.
The first four digits represent the month and day the youtube video was released. Plex is picking up the info from the NFO perfectly when there isn’t a leading 0, eg S2025E121599.
Is there a solution to this other than editing all the NFOs?
Thanks!
This looks to be caused by the code that was added to support multi-episodes per file.
I can address this in an update but at this moment in time you’d have to edit the NFO file to get it to work like you want.
Any chance of either NFO support being added to “Other Videos”? Libraries that don’t have poster covers and don’t neatly fit into the Movie / TV categories could really benefit from the new NFO agent. I have a few libraries where all the thumbnails are 16x9. So either I have it in Other Videos with pretty thumbnails that look right (and no metadata), or I make a Movies library and the metadata is good but the thumbnails look funky because they’re cropped to poster dimensions.
Just hoping to hear whether this is planned or not officially.
Libraries that don’t have poster covers and don’t neatly fit into the Movie / TV categories could really benefit from the new NFO agent. I have a few libraries where all the thumbnails are 16x9
I made the same suggestion a while back. It would be perfect for those cases.
If anything, the ‘Other Videos’ libraries would be perfect for this NFO agent since it’s almost certain people will use it with content not reprised in databases like TMDB and the like.
Content like music videos (if it supported the <musicvideo> type tag) or downloaded Youtube channel videos. This would be ideal for that and it’s an area where currently Jellyfin offers more capability than Plex.