# Upgrading Plex music libraries

**URL:** <https://forums.plex.tv/t/upgrading-plex-music-libraries/469659>\
**Category:** Plex Pass Betas\
**Created:** [October 2, 2019, 3:44am UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659 "2019-10-02T03:44:30Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![PlexInfo](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/plexinfo/32/85165_2.png) [@PlexInfo](https://forums.plex.tv/u/PlexInfo)\
**Post date:** [October 2, 2019, 3:44am UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/1 "2019-10-02T03:44:31Z")

</div>

Starting with version `1.18.0`, Plex Media Server introduces new and improved features for music libraries. There are no longer “basic” vs “premium” music libraries; there is just a single type of music library. Plex Pass subscribers will continue having access to premium music-related features (automatic lyrics, Sweet Fades, loudness leveling, visualizers, etc.) just like before.

Upgraded music in Plex starts with the best-in-class database of music content from [MusicBrainz](https://musicbrainz.org/) and then also adds in the best-in-class musical metadata from [AllMusic](https://www.allmusic.com/). Just a few highlights of improvements:

- High quality artist bios, album reviews, and critic ratings
- Improved album release dates (original releases vs re-releases)
- Awesome artist and album art coverage
- Clean genres, rich styles, moods for artists and albums

# How to upgrade your music library/content

Please visit our [Upgrading Music Libraries to the New Metadata System](https://support.plex.tv/articles/upgrade-music-libraries-new-metadata-system/) article for information on how to upgrade your music library as well as the content within the library. If you don’t read through the article for instructions, then none of your existing music content will get upgraded.

# Investigating scanning/matching issues

If you encounter an issue either with content not being scanned in correctly, matching to the wrong thing, or not matching at all, please review our [Correcting Your Music Content Matches](https://support.plex.tv/articles/correcting-your-music-content-matches/) article, which has lots of information.

---

<div class="post-metadata">

**Author:** ![srfndave1](https://avatars.discourse-cdn.com/v4/letter/s/a587f6/32.png) [@srfndave1](https://forums.plex.tv/u/srfndave1)\
**Post date:** [October 2, 2019, 2:16pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/2 "2019-10-02T14:16:49Z")

</div>

The [Upgrading Music Libraries to the New Metadata System](https://support.plex.tv/articles/upgrade-music-libraries-new-metadata-system/) link is not found.

---

<div class="post-metadata">

**Author:** ![ericmatthys](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/ericmatthys/32/82085_2.png) [@ericmatthys](https://forums.plex.tv/u/ericmatthys)\
**Post date:** [October 2, 2019, 2:22pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/3 "2019-10-02T14:22:37Z")

</div>

Try again, it should be available now.

---

<div class="post-metadata">

**Author:** ![pgalbavy](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/pgalbavy/32/22014_2.png) [@pgalbavy](https://forums.plex.tv/u/pgalbavy)\
**Post date:** [October 2, 2019, 2:32pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/4 "2019-10-02T14:32:46Z")

</div>

Before I potentially waste time, does it now understand “Compilations” versus an album with multiple artists? i.e. the COMPILATION tag or using ALBUM ARTIST or anything like it?

The pre 1.18 scanner was absolutely appalling in handling multi-artist albums, sometimes thinking it a compilation, other times being completely random, putting under one artists that wasn’t relavent etc.

---

<div class="post-metadata">

**Author:** ![pgalbavy](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/pgalbavy/32/22014_2.png) [@pgalbavy](https://forums.plex.tv/u/pgalbavy)\
**Post date:** [October 2, 2019, 2:46pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/5 "2019-10-02T14:46:45Z")

</div>

I thought Id’ try anyway as I do not actuallyy consume music via Plex ATM (because of above) but the link to Update, as above, is not visible:

 ![image](https://global.discourse-cdn.com/plex/original/3X/d/1/d142e73f38acd435a0c2687b92fff0af1a8b27a3.jpeg)

---

<div class="post-metadata">

**Author:** ![OttoKerner](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/ottokerner/32/10079_2.png) [@OttoKerner](https://forums.plex.tv/u/OttoKerner)\
**Post date:** [October 2, 2019, 2:57pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/6 "2019-10-02T14:57:09Z")

</div>

The “upgrade” menu item only appears on regular (last.fm) libraries.  
Former “Premium Music” libraries are converted automatically.

---

<div class="post-metadata">

**Author:** ![ericmatthys](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/ericmatthys/32/82085_2.png) [@ericmatthys](https://forums.plex.tv/u/ericmatthys)\
**Post date:** [October 2, 2019, 2:58pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/7 "2019-10-02T14:58:47Z")

</div>

What are the version numbers for the web app and server version from that screenshot? If you edit the library, which agent does it currently show in the advanced settings?

You can take a look at release groups at [https://musicbrainz.org/](https://musicbrainz.org/) to get a sense of how things should match.

---

<div class="post-metadata">

**Author:** ![pgalbavy](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/pgalbavy/32/22014_2.png) [@pgalbavy](https://forums.plex.tv/u/pgalbavy)\
**Post date:** [October 2, 2019, 3:39pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/8 "2019-10-02T15:39:09Z")

</div>

Web app is hosted - and shows 4.8.3

Server is just upgraded - Version 1.18.0.1846

---

<div class="post-metadata">

**Author:** ![ericmatthys](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/ericmatthys/32/82085_2.png) [@ericmatthys](https://forums.plex.tv/u/ericmatthys)\
**Post date:** [October 2, 2019, 4:02pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/9 "2019-10-02T16:02:02Z")

</div>

Sounds like the library was a premium library before and automatically has the new agent and scanner. You need to refresh metadata to migrate existing items in your library. Check out the support article for details.

---

<div class="post-metadata">

**Author:** ![squaresmile](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/squaresmile/32/91002_2.png) [@squaresmile](https://forums.plex.tv/u/squaresmile)\
**Post date:** [October 2, 2019, 4:08pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/10 "2019-10-02T16:08:28Z")

</div>

Thanks a lot for this update. It would be great if the scanner/agent can read the MusicBrainz ID tags as well but this is still really nice.

---

<div class="post-metadata">

**Author:** ![Sanderkip](https://avatars.discourse-cdn.com/v4/letter/s/2acd7d/32.png) [@Sanderkip](https://forums.plex.tv/u/Sanderkip)\
**Post date:** [October 2, 2019, 4:52pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/11 "2019-10-02T16:52:24Z")

</div>

I made a new library to test this out. I moved in two releases and the first thing the scanner did was match the album and move all the feat. artists from the song title field to the artist field in the database, but then it emptied them all out. The scanner just removed all the features and it now just shows the album artist. Even worse: any tags that would distinct a certain release (Clean Edition) or ‘- Single’ in the album tag field are gone and everything is now an ‘album’.

 ![uhmplex](https://global.discourse-cdn.com/plex/original/3X/f/2/f28605dac45f5cab2574bb2dbef15a9d7ea13f23.jpeg)

The only solution I’ve found to help is just changing back to local tags.

I’m on the SHIELD Android TV server v1.18.0.1846, web client v4.8.3.

Edit: I’ve been experimenting with it, and it just seems to grab MusicBrainz metadata and then after a minute Plex decides to wipe it all on a song level, the new album review, rating, release date & genre data stays.

---

<div class="post-metadata">

**Author:** ![ericmatthys](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/ericmatthys/32/82085_2.png) [@ericmatthys](https://forums.plex.tv/u/ericmatthys)\
**Post date:** [October 2, 2019, 9:16pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/12 "2019-10-02T21:16:10Z")

</div>

Name credits from MusicBrainz aren’t fully wired up yet. If the track artist were different or the track title had the featured artist, it would show up, but proper track artists based on name credits will need to be a future enhancement due to how the data is currently structured.

---

<div class="post-metadata">

**Author:** ![TeknoJunky](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/teknojunky/32/165055_2.png) [@TeknoJunky](https://forums.plex.tv/u/TeknoJunky)\
**Post date:** [October 2, 2019, 10:46pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/13 "2019-10-02T22:46:39Z")

</div>

Hello, I have a rather large music library (previously a premium library), and while the majority are fairly well organized and tagged, I do have a lot of content that is either not going to be in musicbrainz, and/or is not in a traditional album or release group.

- How long is it expected for plex to continue to re-try un-matchable content ?

I have seen several of these be repeated when monitoring the ‘alerts’.

ie items repeatedly doing ‘matching “xxxxxxxx”’ then ‘finished processing “xxxxxxxx”’

---

<div class="post-metadata">

**Author:** ![nibbles](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/nibbles/32/150497_2.png) [@nibbles](https://forums.plex.tv/u/nibbles)\
**Post date:** [October 3, 2019, 7:34am UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/14 "2019-10-03T07:34:28Z")

</div>

Hello. I have some general issues/questions about Plex Music, the new agent. I’m not migrating anything, but my interface to the agent is not working 100%. If this would be better as it’s own topic, would someone move it please? Thanks

I’m trying to understand if there is a new music agent called `Plex Music`.  
I’d like to know if I’m supposed to choose the Plex Music agent to get the benefits of this topic, MusicBrainz etc.

I have created my first music library after installing PMS-1.18.0.x beta.  
I do not see any `Plex Music` agent in `Settings - Agents` using:

- Bundled web app 4.8.3
- Hosted web app 4.8.3
- Plex-1.3.1.916 stable for Mac.

![Agents1](https://global.discourse-cdn.com/plex/original/3X/b/c/bc84babad4bc602fcd2ce44f8c54e2b8cd33964d.jpeg) ![Agents2](https://global.discourse-cdn.com/plex/original/3X/8/e/8e287827c8999c9069ab43f6fd15507780025b0d.jpeg)

However, I **can** see the `Plex Music` agent when I use PMP-2.43.0.1015 on my iMac.

![Agents](https://global.discourse-cdn.com/plex/original/3X/1/1/11dbdb413bfd640ef4c931021b7cc418553e7328.jpeg)

but I can’t configure the agent with the gears in PMP. I get an empty screen.

 ![Empty](https://global.discourse-cdn.com/plex/original/3X/8/3/83b895159422327e4c4e7bcbe9c0311c9e3f3767.jpeg)

When I try to create a music library or edit one I created, PMP can’t make it use the `Plex Music` agent. Instead I get an error that says the changes can’t be saved. However, I can set my Agent to `Plex Music` if I do so in Plex for Mac, the web app, or the bundled app.

 ![Fails](https://global.discourse-cdn.com/plex/original/3X/a/0/a0a65d9a11318cc0b2ec24196134a84fcaba8165.jpeg)

It feels like I put too many things in one post, but that’s where I’m at.  
Thanks for reading!

---

<div class="post-metadata">

**Author:** ![OttoKerner](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/ottokerner/32/10079_2.png) [@OttoKerner](https://forums.plex.tv/u/OttoKerner)\
**Post date:** [October 3, 2019, 11:30am UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/15 "2019-10-03T11:30:17Z")

</div>

Don’t use PMP nor the new Plex for Windows/Mac apps. (At least for now)  
They both don’t have the cutting-edge code to handle the new music stuff, yet.  
Always use [app.plex.tv](http://app.plex.tv) to create and manage one of the new music libraries.

---

<div class="post-metadata">

**Author:** ![chrisc](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/chrisc/32/1209_2.png) [@chrisc](https://forums.plex.tv/u/chrisc)\
**Post date:** [October 3, 2019, 3:44pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/16 "2019-10-03T15:44:23Z")

</div>

> [@nibbles](#):
>
> I’m trying to understand if there is a new music agent called `Plex Music` .  
> I’d like to know if I’m supposed to choose the Plex Music agent to get the benefits of this topic, MusicBrainz etc.  
> …  
> I do not see any `Plex Music` agent in `Settings - Agents` using

To make use of the new improvements/system, you have to select `Plex Music` for _both_ the scanner and the agent for the library. They’re a “matched pair” and you cannot use them separately. As Otto mentioned, you’ll need to be using an updated version of the web interface (which currently means the [hosted web app](https://app.plex.tv/), ideally; at minimum, you can use the bundled web app that comes with the beta PMS, but it’s slightly older).

The new “Plex Music” agent does not have separate settings or appear under `Settings > Server > Agent`, since it’s kind of a special agent.

---

<div class="post-metadata">

**Author:** ![nibbles](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/nibbles/32/150497_2.png) [@nibbles](https://forums.plex.tv/u/nibbles)\
**Post date:** [October 3, 2019, 4:15pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/17 "2019-10-03T16:15:01Z")

</div>

Sounds good thanks. So using the hosted web app, I’ve made the correct choices below, avoiding the oddly named `Plex Music Scanner` is that right?

 ![Agent](https://global.discourse-cdn.com/plex/original/3X/a/1/a19127f0f399264bc60ddb739d7cd8326cc34474.jpeg)

---

<div class="post-metadata">

**Author:** ![chyron8472](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/chyron8472/32/82945_2.png) [@chyron8472](https://forums.plex.tv/u/chyron8472)\
**Post date:** [October 3, 2019, 4:28pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/18 "2019-10-03T16:28:42Z")

</div>

> [@chrisc](#):
>
> The new “Plex Music” agent does not have separate settings or appear under `Settings > Server > Agent` , since it’s kind of a special agent.

I went looking for the Plex Music agent settings there earlier and was confused at not finding it there.

You should make it clear in the app that/why it’s not there (given that people looking for it aren’t likely to first read this thread or a blog post). Ideally, I think you should try to make it consistent. At the very least, **you should put a blurb at the bottom of the Artist and Album agent panes explaining to go to a library’s settings to configure its Plex Music agent**.

If someone is looking for a certain setting (in this case, configuring an agent) they should be able to find them in the same place. It gets confusing if for-this-agent-you-go-here but for-that-agent-you-go-there when neither references the other. That isn’t to say that all agents must be created equal. But it should be intuitive/informative enough not to require one to have to work out “special circumstances” on one’s own.

---

<div class="post-metadata">

**Author:** ![blim5001](https://avatars.discourse-cdn.com/v4/letter/b/c2a13f/32.png) [@blim5001](https://forums.plex.tv/u/blim5001)\
**Post date:** [October 3, 2019, 4:46pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/19 "2019-10-03T16:46:34Z")

</div>

and it is even more confusing that if you use PMP, then the Plex Music agent does appear in

`Settings > Server > Agents > Artists` and `Settings > Server > Agents > Albums`

and the help/support page only says…

`(we recommend using the hosted web app for this)`

not that you `Must` use the hosted web app

---

<div class="post-metadata">

**Author:** ![chrisc](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/chrisc/32/1209_2.png) [@chrisc](https://forums.plex.tv/u/chrisc)\
**Post date:** [October 3, 2019, 6:39pm UTC](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659/20 "2019-10-03T18:39:38Z")

</div>

> [@nibbles](#):
>
> So using the [hosted web app](https://app.plex.tv/), I’ve made the correct choices below, avoiding the oddly named `Plex Music Scanner` is that right?

Yes, that’s correct for the new system. The library creation/edit window (when running on the required/updated web app version) will enforce the “matched set” automatically. If you change either the scanner or agent to something else, then the other one should change automatically, too.

[Next page](https://forums.plex.tv/t/upgrading-plex-music-libraries/469659.md?page=2)
