# How Do You Actually Utilize the .plexmatch File? **URL:** \ **Category:** Plex Media Server\ **Tags:** library-management\ **Created:** [November 14, 2022, 4:18am UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511 "2022-11-14T04:18:21Z")\ **Posts on this page:** 15\ **Page:** 1
**Author:** ![smann](https://avatars.discourse-cdn.com/v4/letter/s/34f0e0/32.png) [@smann](https://forums.plex.tv/u/smann)\ **Post date:** [November 14, 2022, 4:18am UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/1 "2022-11-14T04:18:21Z")
Version#: 1.25.9+ (this was available from then on) There’s this article ([https://support.plex.tv/articles/plexmatch/](https://support.plex.tv/articles/plexmatch/)), but I still can’t get the .plexmatch file to do anything really useful. It states _ **“Match hint information provided in a ‘.plexmatch’ file overrides the directory and filenames, allowing greater control over matching without requiring you to rename your existing files”** _ So, say I’m trying to match The Witcher. And just for this example, I have a very-badly-named folder structure for season 1, episode 1 as: _Netflix’s The Witcher/S1/1\_The.Ends.Beginning.mkv_ This is obviously not how Plex wants the naming scheme (and it’s not how I have it, this is just for the example), but it states in the article that it doesn’t require renaming the files. So, I create a .plexmatch file with this in the main folder: _title: The Witcher_ _year: 2019_ _tvdbid: 362696_ Except it doesn’t change anything. It still can’t find The Witcher. I guess, what exactly needs to be done to match without renaming the files to Plex’s naming scheme? This seemed like the best thing I’ve found, but it hasn’t worked once when testing. I’ve tried throwing the episodes in there based on the article, having a .plexmatch file in both the show directory and season directory, and everything else. Still nothing. Also, what is the “guid” referenced in the article? It says _**“guid sets a Plex URI-style media identification GUID, in the format [source]://[id]”**_, but I’m not sure what that means exactly. The reason for doing all this is there are some shows that don’t do well with the [Plex dance](https://forums.plex.tv/t/the-plex-dance/197064). My Top Gear folder ends up split into multiple shows that I need to re-merge together. It would be awesome to have something that forces it all together immediately. Please don’t tell me to just rename the file the way Plex wants, the whole purpose of this is to figure out how to properly implement the .plexmatch file only. ---
**Author:** ![JaysPlex](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/jaysplex/32/281767_2.png) [@JaysPlex](https://forums.plex.tv/u/JaysPlex)\ **Post date:** [November 14, 2022, 4:39am UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/2 "2022-11-14T04:39:20Z")
What agents are you using? The new agents use a different format [https://support.plex.tv/articles/naming-and-organizing-your-movie-media-files/](https://support.plex.tv/articles/naming-and-organizing-your-movie-media-files/) ```auto /Movies /Batman Begins (2005) {imdb-tt0372784} Batman Begins (2005) {imdb-tt0372784}.mp4 ``` You can also use that format in the main show folder for TV shows [https://support.plex.tv/articles/naming-and-organizing-your-tv-show-files/](https://support.plex.tv/articles/naming-and-organizing-your-tv-show-files/) ---
**Author:** ![smann](https://avatars.discourse-cdn.com/v4/letter/s/34f0e0/32.png) [@smann](https://forums.plex.tv/u/smann)\ **Post date:** [November 14, 2022, 4:46am UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/3 "2022-11-14T04:46:38Z")
This is using the Plex TV Series Agent. PlexMatch was just recently updated in version **1.30.0.6359**. This is to further force a match, but it has never worked for me. Putting {tvdb-#######} hasn’t worked either. This is about the .plexmatch file from the article. Obviously the format I posted is incorrect, as I stated, to see how to properly use .plexmatch files to force a correct match with the incorrect naming scheme shown. ---
**Author:** ![dane22](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/dane22/32/4389_2.png) [@dane22](https://forums.plex.tv/u/dane22)\ **Post date:** [November 14, 2022, 1:07pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/4 "2022-11-14T13:07:50Z")
> [@smann](#): > > Plex TV Series Agent Make sure both Agent and Scanner is set to `Plex TV Series` ![image](https://global.discourse-cdn.com/plex/original/4X/9/a/1/9a16ab15cf91d223f1e6f0095932eba4a52e9c61.png) Also do a `Refresh All Metadata` ![image](https://global.discourse-cdn.com/plex/original/4X/5/d/7/5d7e7f6415263bc1fc210b16e82a83b288c0d638.png) Then report back ---
**Author:** ![smann](https://avatars.discourse-cdn.com/v4/letter/s/34f0e0/32.png) [@smann](https://forums.plex.tv/u/smann)\ **Post date:** [November 14, 2022, 2:43pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/5 "2022-11-14T14:43:48Z")
I did all of that. I still end up with things like this (The Firefly entry is actually Top Gear episodes)… ![Plex Top Gear](https://global.discourse-cdn.com/plex/original/4X/7/e/2/7e29c0d6bc59fe159ec6d2a3441aef857d8793eb.jpeg) I have {tvdb-74608} in the Top Gear folder name and a .plexmatch file with the following contents within that folder… tvdbid: 74608 title: Top Gear year: 2002 Putting the ID in the folder name and the .plexmatch file in the folder doesn’t seem to do anything at all. Even though, according to that article I listed in the first post, the .plexmatch should override the directory name anyway. And I still don’t understand what the guid hint does for .plexmatch. For Top Gear, it looks like it should be… guid: plex://show/2F5d9c07fd02391c001f57e02f Or would it be… guid: plex://show/top-gear Because the article doesn’t explain that hint at all really. ---
**Author:** ![anon18523487](https://avatars.discourse-cdn.com/v4/letter/a/49beb7/32.png) [@anon18523487](https://forums.plex.tv/u/anon18523487)\ **Post date:** [November 14, 2022, 4:28pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/6 "2022-11-14T16:28:44Z")
You’re on the right track, but because of your episode filenames, the episodes are not being matched. You need to add the episode hints too. i.e. > _Netflix’s The Witcher/S1/1\_The.Ends.Beginning.mkv_ Add the .plexmatch file in this S1 folder alongside the episodes. > _title: The Witcher_ > _year: 2019_ > _tvdbid: 362696_ > Season: 2 > ep: 1: 1\_The.Ends.Beginning.mkv Add the other episodes into this file. Create a similar .plexmatch file for other seasons. Edit: On further thought, it might just be you are missing the season hint. For episode, we may be able to parse out the “1” for the episode number so it’s just the season info missing. Try with just the season hint and if that doesn’t work, add the episode hints. ---
**Author:** ![smann](https://avatars.discourse-cdn.com/v4/letter/s/34f0e0/32.png) [@smann](https://forums.plex.tv/u/smann)\ **Post date:** [November 14, 2022, 5:28pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/7 "2022-11-14T17:28:25Z")
Hmmm, so I got it to work for that test file for The Witcher. I also made another test file with some really messed up naming for Top Gear (just to see how well it would work) and got it to work too! But I have a TV Show called Dead Set that won’t show up at all. The info in the Season 1 folder for that show is… _title: Dead Set_ _year: 2008_ _tvdbid: 83427_ _season: 1_ _ep: 1: S01E01 - Outbreak/Episode1name.mkv_ _ep: 2: S01E02 - Can the Housemates Keep Angel Alive\_/Episode2name.mkv_ _ep: 3: S01E03 - Live Feed/Episode3name.mkv_ _ep: 4: S01E04 - Running/Episode4name.mkv_ _ep: 5: S01E05 - A Way Out/Episode5name.mkv_ For reference, the filepath for episode 1 is “TV Shows\Dead Set (2008)\Season 01 (2008)\S01E01 - Outbreak\file”. I’ve had issues with this particular show in the past. Plex really doesn’t like it. Did the full dance and all after putting in its .plexmatch file. ---
**Author:** ![anon18523487](https://avatars.discourse-cdn.com/v4/letter/a/49beb7/32.png) [@anon18523487](https://forums.plex.tv/u/anon18523487)\ **Post date:** [November 14, 2022, 6:22pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/8 "2022-11-14T18:22:02Z")
My guess is the “/” in the filename. ---
**Author:** ![smann](https://avatars.discourse-cdn.com/v4/letter/s/34f0e0/32.png) [@smann](https://forums.plex.tv/u/smann)\ **Post date:** [November 14, 2022, 6:42pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/9 "2022-11-14T18:42:48Z")
But if I use The Witcher example from earlier and throw that episode into a folder and have the .plexmatch info as follows, it works with the “/”… _title: The Witcher_ _year: 2019_ _tvdbid: 362696_ _season: 1_ _ep: 1: S01E01 - The End’s Beginning/1\_The.Ends.Beginning.mkv_ It’s just this one TV Show that appears to never want to work like the rest. ---
**Author:** ![anon18523487](https://avatars.discourse-cdn.com/v4/letter/a/49beb7/32.png) [@anon18523487](https://forums.plex.tv/u/anon18523487)\ **Post date:** [November 14, 2022, 6:45pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/10 "2022-11-14T18:45:56Z")
Can you show me the actual filenames for the one that doesn’t work? ---
**Author:** ![smann](https://avatars.discourse-cdn.com/v4/letter/s/34f0e0/32.png) [@smann](https://forums.plex.tv/u/smann)\ **Post date:** [November 14, 2022, 7:15pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/11 "2022-11-14T19:15:42Z")
Well, I figured out what’s wrong, but it seems like a really odd thing. I rip almost all my own movies/shows so their filenames have a specific format. For Dead Set episode 1 it’s… Dead.Set.S01E01.Outbreak.2008.480p.DVDRip.x264.DD.2.0-MyCollection-NeedsUpdate.mkv I got this show so long ago on DVD when I didn’t have much hard drive space, so they are only in 480p. So at the end, instead of just “-MyCollection.mkv” I had “-MyCollection-NeedsUpdate.mkv” to designate that I need to buy a better quality bluray someday and re-rip when I have time. Apparently, it’s that second dash in the filename that kicks it out. If I remove the dash so it’s “-MyCollectionNeedsUpdate.mkv” it works! Looks like it can only handle a single dash in the filename, which is odd, but at least I finally figured out why this particular show has given me so many problems in Plex. EDIT: Sorry, that was supposed to be DVDRip not DVD-Rip in the filename. It’s updated now. I’m guessing this is due to the normal Plex naming convention of “S01E01 - Name of Episode - Optional Info.ext” where it is set up to disregard everything after the second dash and that was causing the filenames to not match. ---
**Author:** ![anon18523487](https://avatars.discourse-cdn.com/v4/letter/a/49beb7/32.png) [@anon18523487](https://forums.plex.tv/u/anon18523487)\ **Post date:** [November 14, 2022, 7:49pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/12 "2022-11-14T19:49:08Z")
I checked and the dashes shouldn’t matter. Can you provide me the full path and filenames so I can try to reproduce? Edit - I tried `Dead.set\S1\Dead.Set.S01E01.Outbreak.2008.480p.DVDRip.x264.DD.2.0-MyCollection-NeedsUpdate.mkv` and that matched perfectly for me without needing the .plexmatch file. ---
**Author:** ![smann](https://avatars.discourse-cdn.com/v4/letter/s/34f0e0/32.png) [@smann](https://forums.plex.tv/u/smann)\ **Post date:** [November 14, 2022, 8:47pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/13 "2022-11-14T20:47:49Z")
Not sure what to say, because now I can’t get the show to go away lol. I added the dash back in and it’s sticking around now. Here’s the filepath (the library points to the TV Shows folder)… ![image](https://global.discourse-cdn.com/plex/original/4X/3/8/3/38374cc07b175af69e5c1d1a706ee6ddf7d0e28a.png) Maybe something got caught up somewhere and eventually worked out with all the changes I was making and it was something else. Well, they are all there now and working fine for me. Thanks! * * * One other weird thing I noticed though while routing around in my shows and movies (since this all got me looking at things closer) is that I was missing a couple of episodes and movies here and there in Plex, and I realized they all had the same thing in common. Their filenames all ended in “-Video” before the extension. I use “-Video”, “-Audio”, “-Subtitles”, etc on the end of files sometimes to denote that I should re-rip those specific parts if I notice issues when playing back. My computer isn’t the best, so it sometimes hiccups when ripping. I changed all those to “-Vid” and they all showed up in Plex. I added “-Video” onto a random filename and it immediately was removed from Plex. Is this a specific keyword designed to denote the difference between an “Other Video” file and a video file in “Movies” or “TV Shows”? Since this issue was easily re-creatable on my end, I can give better specifics. Take something like “Filename.mkv” and change it to “Filename-Video.mkv”. Plex removes it from the library. Delete any 1 letter from that Video word, like “Filename-Vide.mkv” and it comes back. ---
**Author:** ![anon18523487](https://avatars.discourse-cdn.com/v4/letter/a/49beb7/32.png) [@anon18523487](https://forums.plex.tv/u/anon18523487)\ **Post date:** [November 14, 2022, 9:04pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/14 "2022-11-14T21:04:44Z")
Thanks. I can confirm that having “-video” at the end does make it so the file is not scanned. That is meant to be used to identify music videos for a music library. I will get this filed as a bug. ---
**Author:** ![system](https://global.discourse-cdn.com/plex/original/3X/2/a/2acb9765406f63293d357b4ec509ec39aa28f2ad.png) [@system](https://forums.plex.tv/u/system)\ **Post date:** [February 13, 2023, 6:04pm UTC](https://forums.plex.tv/t/how-do-you-actually-utilize-the-plexmatch-file/818511/17 "2023-02-13T18:04:28Z")
This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.