# Custom Metadata Agent

**URL:** <https://forums.plex.tv/t/custom-metadata-agent/43636>\
**Category:** Dev/API Corner\
**Tags:** scanner-agent-dev\
**Created:** [September 29, 2013, 3:22am UTC](https://forums.plex.tv/t/custom-metadata-agent/43636 "2013-09-29T03:22:34Z")\
**Posts on this page:** 14\
**Page:** 1

<div class="post-metadata">

**Author:** ![Keelan](https://avatars.discourse-cdn.com/v4/letter/k/5f8ce5/32.png) [@Keelan](https://forums.plex.tv/u/Keelan)\
**Post date:** [September 29, 2013, 3:22am UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/1 "2013-09-29T03:22:34Z")

</div>

I am hoping somebody can point me in the right direction.

&nbsp;

I know that a sports agent is hard to come by, but i really don't need something that advanced. I really would just like to find a agent that reads the name and then based on keywords assigns pre defined fan art and changes the name to something friendly.

&nbsp;

For example:

&nbsp;

Under my sports section i have:

- Soccer
- Football
- Australian Football
- Ultimate Fighter
- Rugby
- Hockey

Each of the content will contain the type of sport with a relevant tag:

- EPL
- AFL
- NFL
- NHL
- UFC
- Rugby

along with who the match is between.

&nbsp;

I'd really just like to scan the content name e.g.&nbsp;EPL.2013.09.28.Swansea.City.Vs.Arsenal for the tag **EPL** then set predenfined information.

&nbsp;

Just give it a Soccer category/poster/background and change the name from&nbsp;EPL.2013.09.28.Swansea.City.Vs.Arsenal to Swansea City Vs Arsenal

&nbsp;

Is this possible? Is their something that is out there now that i could modify to meet my needs? Can somebody point me in the right direction to start such a thing?

Thank you.

---

<div class="post-metadata">

**Author:** ![Keelan](https://avatars.discourse-cdn.com/v4/letter/k/5f8ce5/32.png) [@Keelan](https://forums.plex.tv/u/Keelan)\
**Post date:** [September 30, 2013, 12:04am UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/2 "2013-09-30T00:04:22Z")

</div>

Hmm a very futile effort from me, i can't seem to wrap my head around this. I have tried looking at other meta agents but they are way to advanced and complex for my needs.

---

<div class="post-metadata">

**Author:** ![akkifokkusu](https://avatars.discourse-cdn.com/v4/letter/a/71c47a/32.png) [@akkifokkusu](https://forums.plex.tv/u/akkifokkusu)\
**Post date:** [October 10, 2013, 9:03am UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/3 "2013-10-10T09:03:19Z")

</div>

Here's a rudimentary Scanner and Metadata Agent that I came up with to do what you're asking for. It relies on the structure being  
&nbsp;something like

```
Sports/
     Soccer/
          EPL.2013.09.28.Swansea.City.Vs.Arsenal.mp4
          EPL.2013.07.28.Sunderland.Vs.Machester.United.mp4
     Football/
          NFL.2013.10.03.Bills.Vs.Browns.mp4
          NFL.2013.10.07.Jets.Vs.Falcons.mp4
```

etc...

It's really rudimentary, it doesn't do the images, and it relies on that structure, but you should be able to edit it for your needs without too much trouble. If you have any questions or other requests, let me know.

---

<div class="post-metadata">

**Author:** ![Keelan](https://avatars.discourse-cdn.com/v4/letter/k/5f8ce5/32.png) [@Keelan](https://forums.plex.tv/u/Keelan)\
**Post date:** [October 10, 2013, 12:19pm UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/4 "2013-10-10T12:19:41Z")

</div>

> Here's a rudimentary Scanner and Metadata Agent that I came up with to do what you're asking for. It relies on the structure being  
> &nbsp;something like
> 
> ```
> Sports/
> Soccer/
> EPL.2013.09.28.Swansea.City.Vs.Arsenal.mp4
> EPL.2013.07.28.Sunderland.Vs.Machester.United.mp4
> Football/
> NFL.2013.10.03.Bills.Vs.Browns.mp4
> NFL.2013.10.07.Jets.Vs.Falcons.mp4
> ```
> 
> etc...
> 
> It's really rudimentary, it doesn't do the images, and it relies on that structure, but you should be able to edit it for your needs without too much trouble. If you have any questions or other requests, let me know.

This works pretty well! The only issue i seem to have is the names of the "episodes" are the dates rather than the teams playing and the date.

Even works well with names like:&nbsp;West Bromwich Albion Vs Arsenal - 2013-10-06.mkv just again episode names are dates.

---

<div class="post-metadata">

**Author:** ![akkifokkusu](https://avatars.discourse-cdn.com/v4/letter/a/71c47a/32.png) [@akkifokkusu](https://forums.plex.tv/u/akkifokkusu)\
**Post date:** [October 10, 2013, 6:57pm UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/5 "2013-10-10T18:57:25Z")

</div>

> This works pretty well! The only issue i seem to have is the names of the "episodes" are the dates rather than the teams playing and the date.
> 
> Even works well with names like:&nbsp;West Bromwich Albion Vs Arsenal - 2013-10-06.mkv just again episode names are dates.

Interesting. Can't seem to reproduce this. Can you attach a few screenshots of your folder/file structure and what it looks like in Plex?

---

<div class="post-metadata">

**Author:** ![Keelan](https://avatars.discourse-cdn.com/v4/letter/k/5f8ce5/32.png) [@Keelan](https://forums.plex.tv/u/Keelan)\
**Post date:** [October 10, 2013, 9:32pm UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/6 "2013-10-10T21:32:40Z")

</div>

> Interesting. Can't seem to reproduce this. Can you attach a few screenshots of your folder/file structure and what it looks like in Plex?

```
Sports/
       AFL/
           AFL.2013.09.28.hawthorn.vs.fremantle.mp4

```
   EPL/
       Everton vs Newcastle United - 2013-09-30.mkv
       Liverpool Vs Crystal Palace - 2013-10-05.mkv
       
   NFL/
       Jets vs Falcons - 2013-10-07.mkv

```
```

[http://i.imgur.com/D4xRAS7.jpg](http://i.imgur.com/D4xRAS7.jpg)

[http://i.imgur.com/qvYYYM8.png](http://i.imgur.com/qvYYYM8.png)

---

<div class="post-metadata">

**Author:** ![akkifokkusu](https://avatars.discourse-cdn.com/v4/letter/a/71c47a/32.png) [@akkifokkusu](https://forums.plex.tv/u/akkifokkusu)\
**Post date:** [October 11, 2013, 12:47am UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/7 "2013-10-11T00:47:35Z")

</div>

OK, I think I fixed it. Try this:

[CustomSports.zip](https://global.discourse-cdn.com/plex/original/3X/c/f/cf52df48f112e816c378d76bed732391f7de6811.zip) (90.3 KB)

---

<div class="post-metadata">

**Author:** ![Keelan](https://avatars.discourse-cdn.com/v4/letter/k/5f8ce5/32.png) [@Keelan](https://forums.plex.tv/u/Keelan)\
**Post date:** [October 11, 2013, 2:17am UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/8 "2013-10-11T02:17:41Z")

</div>

> OK, I think I fixed it. Try this:
> 
> ![attachicon.gif](http://forums.plexapp.com/public/style_images/plex/attachicon.gif)[CustomSports.zip](http://forums.plexapp.com/index.php?app=core&module=attach&section=attach&attach_rel_module=post&attach_id=20337)

Hmm.. i tried this and it didn't seem to work either. Still just shows dates for the episode names.

---

<div class="post-metadata">

**Author:** ![akkifokkusu](https://avatars.discourse-cdn.com/v4/letter/a/71c47a/32.png) [@akkifokkusu](https://forums.plex.tv/u/akkifokkusu)\
**Post date:** [October 11, 2013, 8:21am UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/9 "2013-10-11T08:21:56Z")

</div>

> Hmm.. i tried this and it didn't seem to work either. Still just shows dates for the episode names.

OK, I made some changes that I think should fix most of the issues. If it's still not working, make sure that your Sports section is using both the Custom Sports agent as well as the CustomSports scanner (not the default Plex Series Scanner) . If it still doesn't work after that, I'm not sure what else could be causing the problem.

[CustomSports.zip](https://forums.plex.tv/uploads/default/original/3X/c/f/cf52df48f112e816c378d76bed732391f7de6811.zip) (90.3 KB)

---

<div class="post-metadata">

**Author:** ![Keelan](https://avatars.discourse-cdn.com/v4/letter/k/5f8ce5/32.png) [@Keelan](https://forums.plex.tv/u/Keelan)\
**Post date:** [October 11, 2013, 3:26pm UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/10 "2013-10-11T15:26:44Z")

</div>

> OK, I made some changes that I think should fix most of the issues. If it's still not working, make sure that your Sports section is using both the Custom Sports agent as well as the CustomSports scanner (not the default Plex Series Scanner) . If it still doesn't work after that, I'm not sure what else could be causing the problem.
> 
> ![attachicon.gif](http://forums.plexapp.com/public/style_images/plex/attachicon.gif)[CustomSports.zip](http://forums.plexapp.com/index.php?app=core&module=attach&section=attach&attach_rel_module=post&attach_id=20349)

Perfect, thank you very much!

---

<div class="post-metadata">

**Author:** ![ksplawn](https://avatars.discourse-cdn.com/v4/letter/k/c77e96/32.png) [@ksplawn](https://forums.plex.tv/u/ksplawn)\
**Post date:** [November 21, 2013, 7:22pm UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/11 "2013-11-21T19:22:13Z")

</div>

I've got a ton of Football games as well, what do you do with these files?

---

<div class="post-metadata">

**Author:** ![linwelin](https://avatars.discourse-cdn.com/v4/letter/l/5e9695/32.png) [@linwelin](https://forums.plex.tv/u/linwelin)\
**Post date:** [October 7, 2015, 12:41pm UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/12 "2015-10-07T12:41:26Z")

</div>

Would like to know this myself, i download a lot of football (soccer) games and would love to have plex setup for it.

---

<div class="post-metadata">

**Author:** ![Keelan](https://avatars.discourse-cdn.com/v4/letter/k/5f8ce5/32.png) [@Keelan](https://forums.plex.tv/u/Keelan)\
**Post date:** [October 15, 2015, 6:23pm UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/13 "2015-10-15T18:23:56Z")

</div>

> @ksplawn said:  
> I’ve got a ton of Football games as well, what do you do with these files?

> @linwelin said:  
> Would like to know this myself, i download a lot of football (soccer) games and would love to have plex setup for it.

[https://support.plex.tv/hc/en-us/articles/201106098-How-do-I-find-the-Plug-Ins-folder-](https://support.plex.tv/hc/en-us/articles/201106098-How-do-I-find-the-Plug-Ins-folder-)

Unpack the latest zip in that folder. Restart Plex.

---

<div class="post-metadata">

**Author:** ![system](https://global.discourse-cdn.com/plex/original/3X/2/a/2acb9765406f63293d357b4ec509ec39aa28f2ad.png) [@system](https://forums.plex.tv/u/system)\
**Post date:** [December 21, 2019, 12:10am UTC](https://forums.plex.tv/t/custom-metadata-agent/43636/14 "2019-12-21T00:10:43Z")

</div>

Closed on December 21, 2019, 12:10am UTC

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.
