New Plex

Hello there!

“Plex was born out of a passion for media and entertainment, and offering free ad-supported premium movies and TV shows is just the latest step in our mission to bring all your favorite content. New to plex Hello there, i've just discovered plex recently and manage to setup sonarr, radarr and plex to watch some movies / tv series. I'm quite happy with the results but there are times when im playing a certain episode of a tv series the video seems to buffer quite often.

We’ve been testing and tweaking our new movie scanner and matching agent for a little while now with the help of many forum users (thank you!). We’re finally ready today to release this out into the wild with the current 1.20.0 beta release.

  • Plex may, but is not obligated to, update the Plex Solution with updates, upgrades, enhancements, improvements, additions, new or incremental features or functionality of and generally made available through the Plex Solution (as determined by Plex in its sole discretion), or modifications that are provided as part of product support and any.
  • Create a new test TV library using the “Plex TV Series (BETA)” Agent. Note: While you can currently upgrade an existing library using one of the legacy agents to use the new agent it is recommended that during the preview that you create a completely separate library for testing.

Release announcement: Plex Media Server - #357 by ahiyahiya


With the new 1.20.0 beta when you create a new movie library it will default to the new Plex Movie agent. Existing movie libraries will remain unchanged but you can upgrade them in a few clicks. Ideally most of you should not notice much has changed when moving to the new agent except for the much improved matching speed.

You can continue using any of the previous existing agents by changing the Agent in the advanced section when creating new libraries or editing existing ones. The previous Plex Movie agent is now listed as Plex Movie (Legacy).

New Plex

Please note that creating and upgrading libraries to use the new agent requires a minimum Plex Web version of 4.38.2 (hosted at or 4.34.4 (bundled with Plex Media Server).

Read on if you want to find out more about what’s changed.

Upgrading an existing library

Note: before upgrading please make sure your server has an active internet connection.

Upgrading a library is super easy, just select the ellipsis menu icon for your library in the sidebar and select Manage Library and Upgrade Matching.

You’ll be presented with a dialog confirming your action. Note that your existing media will not be updated to the new agent until you manually run a metadata refresh. You can do this on individual items to test it out or by selecting Refresh All Metadata.

So what does this actually mean?

Library matching is how we take a file you’ve added to your server and figure out which movie it corresponds to so we can provide all the rich metadata that comes with it. The metadata includes most of the information you’ll see when navigating to the movie in your library; things like the title, summary, release year, posters, cast list, etc.

As not all the data we use in our new system is exactly what the old agent would use, you may notice some changes to existing metadata when upgrading. Metadata fields you have locked will not be changed however. If you are just creating a new library you don’t need to worry about this.

Locked fields will have the little icon selected in orange

During an upgrade we’ll also migrate any specific settings you may have set on the previous agent that have corresponding settings on the new agent. These are the settings like trailer preferences, collection and artwork preferences, etc. You can adjust these again later by editing the library and navigating to the Advanced page.

Some of my movies are not matching or are matching incorrectly

While we’ve tried really hard to accommodate many different file naming conventions it is always highly recommended that you follow the guidelines outlined here when naming your files.

If you’re still finding that we’re having a hard time matching something specific you should use the Fix Match option to locate a better match. If this still fails to get the result you’re looking for then please drop a post on our forum so we can take a look.

As there are a lot of under-the-hood changes here there may be some edge cases we’ve missed, if you see something that doesn’t look quite right or you have suggestions please reach out on the forum.

Still reading?

While we suspect most people won’t notice that much has changed when using the new Plex agent we have made a lot of improvements and updates to a few key places.

Regional language support

We’ve added a few new language options as we know this has been a sore point for many. With the new Plex agent in 1.20.0 you can now select the following new language options:

  • Spanish (Mexico)
  • French (Canada)
  • Portuguese (Brazil)
  • Chinese (Taiwan)
  • Chinese (Hong Kong)
  • English (Australia)
  • English (Canada)
  • English (United Kingdom)

We’ll continue to add more options here as long as there is demand for it, so if you see a language we should have that we don’t yet support please let us know.

Improved support for local assets

The previous Plex agent would require you to set the Local Media Assets agent as a primary in order to use local posters and artwork as the default options for your movies. This would however also result in it using any embedded metadata that may be present in the media file which wasn’t always a great experience.

The new Plex Movie agent gives you the option to use local image assets independently from any embedded metadata. Setting the Use local assets preference will pick up any local image assets and use those over the ones pulled from the cloud.

If you wish to use embedded metadata from your media you can set that with the Prefer local metadata option. We don’t recommend ever enabling this option unless you very specifically have your media tagged in a manner to support this.

Note: if you have upgraded an existing movie library that had Local Media Assets as the primary agent then both these settings mentioned above will be enabled for the new agent.

Collections got an overhaul

If you ever wanted us to only give you collections when you had more than one item in your library from said collection you can now rejoice. A new advanced setting, Minimum automatic collection size, will allow you to tweak the threshold at which we’ll automatically add a new collection to your library. You can tweak this setting between Disabled (no automatic collections) and 4.

Along with this we also now provide great posters and art for these collections as well as short summaries.

Note: if you’re upgrading a movie library that has existing collections we will not overwrite any of their existing metadata fields, this includes things like posters, art and summaries. The new improved metadata mentioned above will only apply to newly created collections with the new Plex agent.

Looking forward

We’re really glad we can finally get this update into your hands. We are continually making improvements to try improve the quality of the metadata, our matching accuracy and brining new features online.

World one chair humanscale for sale

I also just want to give another thank you to the folks who have been testing this and providing such amazing feedback for the Forum Preview release, it never gets old hearing “Wow, it’s so much faster!”

I’ve been unable to get the new Plex Windows Player to work on my desktop nor laptop. My laptop was a fresh install of Windows 10 as well.

In looking at the logs on my desktop, Plex seems to be stuck in some sort of loop trying to connect to my server. The old client and web clients work perfectly fine.

I see this error at the top, then the looping I note below:

New Plex App

Mar 29, 2021 19:31:05.093 [16124] INFO - [Controllers] [Player] Initialized mpv 0.32.0-UNKNOWN, ffmpeg 1.6-367b3d4c85-2
Mar 29, 2021 19:31:05.124 [16124] WARN - [Controllers] Invalid port given for the inspector server “0”. Examples of valid input: “12345” or “” (with the address of one of this host’s network interface).

It seems to be looping and trying to connect to a non-existent server at, but even when it finds the right external and internal URL and says it’s established a “long poll” connection successfully, the app window never opens and it just sits in the loop, as the log file indicates below.

New Plexus Slim

You can see the loop here: Plex Media Server Logs -