@DevXen Ok. That is elaborate. 
1 Like
@contrary_cat Adding the Bracket, didn’t work. darn it. I don’t know if it matters, but The test series i’m trying. I added the extras into separate folders: Behind The scenes, Interviews, Other.
it does pull up under TheTVDB Agent as well. and I Refreshed metadata on the series and then scanned the library as well.
Adding the [ bracket in settings worked for me in a minimal test:
TV Show/[2018] Season 1/TV Show - S01E01.mkv
TV Show/Behind the Scenes/Name of Extra.mkv
This also works:
TV Show/[2018] Season 1/TV Show - S01E01.mkv
TV Show/[Behind the Scenes]/Name of Extra.mkv
because the extra folder matching uses a regex that strips out all non-letter characters.
So as far as I can tell, it should be possible to get the agent to work with your naming system. If you’re still not getting anything after a metadata refresh, can you add an issue on github including the log file, and the preferences file in Plex Media Server Data Directory/Plug-in Support/Preferences/com.plexapp.agents.localtvextras.xml? I can make more recommendations from there.
Okay. I’ll post it over there. but it’s strange. I just looked at the log file and it did add a single extra for a different show. - which is in a [Extras] Folder inside that series folder. and that file doesn’t have any of the inline identifiers. - I checked it on the plex webapp and sure enough it showed that extra. Strange.
I’m having some trouble getting this to work, it may be on my part, but here’s the issue.
I have a show that released mini webisodes for the first handful of episodes that help explain some of the plot. The files are labeled the same as the full episodes, but the episode number is XX.5. I’ve got the agent installed but it sets the files as a second version of the full episodes, it doesn’t place them in a separate directory within the season.
This is how I have the folder currently set up:
Kamen Rider Zi-O - Season 1 - Season 1 Extras
Another thing to add is that when I had the extras folder labeled as “Extras” the files did not show up on my server, but when I added “Season 1” to the folder name they appeared.
Is there something I can do to get these to show up in an Extras directory?
To cover the current state of things first: if they are being added as a duplicate of your episodes, then they are being added by the Plex Media Scanner rather than the metadata agent; extras added by this agent will be shown completely separately from the episodes.
When you had the folder named extras there are two different possibilities (that I can think of) for the files not showing up:
- If you only looked for the extras using the web client, then you will not see them at all. Plex Web only shows files that are linked to the TV Show, so no season extras will be displayed.
There are limited clients that will display extras at the season level, as far as I know: Android clients, Roku, and Kodi with the Plex for Kodi plugin.
If you don’t have any of these clients, and still want to try the agent, then you should move the Extras folder so it is directly within the Kamen Rider Zi-O folder instead of within Season 1. - If you have one of the clients mentioned, and the extras weren’t displayed in that client either, then it is possible that they weren’t detected by the metadata agent. So you need to be certain that you have refreshed metadata on your show (not scanned media files).
If you still have trouble getting it to work, you can create an issue on the github page, including the com.plexapp.agents.localtvextras.log file – I’ll do my best to help you troubleshoot.
Thanks for the reply!
I was using the web client so I’ll try everything out again and check it on my Roku. I’ll move any future questions to github.
Im running Plex on Open Media Vault. How exactly do I install this? I put it in my Plug-ins folder but when I go to plugins in plex ui it shows no plugins.
That’s because it’s not really a plug-in, it’s an agent. You have to go to Settings -> Agents -> TV shows and tick Local TV Extras Agent. Then it should work.
I have it checked but it still doesnt show. I have my file in the westworld folder named Welcome to Westworld - behindthescenes. I refreshed metadata and nothing appears.
Here is my file structure. Is this correct?
Here’s the recommended file structure for adding a featurette (just choose one of the Welcome to Westworld positions depending on your requirements)
-
Westworld
-
Season 01
- Westworld - S01E0x - episode name.mkv, etc. All episodes
- Welcome to Westworld-featurette.mkv Example of inline extra that will be added to season 1 - will be added to the server, but won’t show up in Plex Web
-
Featurettes
- Welcome to Westworld.mkv Example of subfolder extra that will be added to season 1 - will be added to the server, but won’t show up in Plex Web
- Welcome to Westworld-featurette.mkv Example of inline extra that will be added at the show level
-
Featurettes
- Welcome to Westworld.mkv Example of subfolder extra that will be added at the show level
-
Season 01
If you search this thread, you should get a good idea of which clients support season extras and whether it is worth adding them.
Other extra type names are listed on the GitHub page, “Specials” is not among them because that is already in use by the Plex Media Scanner, and you could end up with real specials episodes also being added as extras.
2 Likes
Thank you. Its now working both on omv from my server and on my Nividia tv. Is there any way to have it organized so it shows in season 1? I have faturettes from season 1 and season 2. Right now it has all the featurettes under specials. Im trying to think of a way to organize them better.
I am trying to get this Agent working but I am having some issues. I installed the agent and it appears to be installed correctly. It is listed in the available agents under TV shows and I have enabled it. I put the TV show extras under the correct directory structure under the season for a show, but the extras never show up. I am using the Windows client (non-store). I downloaded the logs from the server and I do not see any com.plexapps.agents.localtvextras.log files which tells me the agent is not running. I made sure I have restarted Plex but still the same issue. My Plex server is running in a Docker Container in UnRaid. What else can I do to try to get this working?
One other thing I noticed. Even though the Local TV Extras agent is showing up in the Agent Settings, it is not showing up in the Library settings under Advanced --> Agent.
Advanced --> Agent only shows your top-level agents (TVDB, MovieDB); this agent is an additional agent which supplements the metadata from your top-level agent, so that is nothing to worry about.
As far as downloading the logs goes, I’m not sure if 3rd party agents are always included. Try looking in %LOCALAPPDATA%\Plex Media Server\Logs\PMS Plugin Logs
The Plex Media Player client (for any platform) will support extras at the show level only. So when you’re testing, make sure that the setting Assign Extras to Episodes, Seasons or Shows based on folder structure is set to false.
If you have that setting set to true – and you are adding extras to the season rather than the show – then they may already have been added correctly to the server, but you can’t see them because you’re using PMP. If they have, then Plex for Kodi, the Android Client and, I think, Roku support extras linked to the season.
Thank you very much. I did have that option checked. After unchecking it, it is now showing up but at the show level (I guess as expected). To make sure I understand correctly, if I have that option checked, extras will not show up on the season level for PMP on Windows? If so are there any plans to make it work with PMP on Windows or is there some limitation that keeps it from working there? I also have Amazon Fire Cube and Xbox One X so I will test over there with that option checked. I may also buy an Nvidia Shield as a client so hopefully it works on the Shield.
PMP unfortunately has no support for season or episode linked extras, and neither does Plex Web. There are some clients that are able to display those extras, so that’s why the setting exists, but most people are best served by leaving it to show only.
The agent only interacts with the server, which supports everything, but that means that I’m not able to change anything in the code to enable it to work with Plex Media Player. It’s something that the Plex team will need to implement on a client by client basis.
It doesn’t seem to be a particular focus for them at the moment, but make sure you’ve voted for the feature request here
Thanks again for the info. I confirmed that with the option checked the extras show up under the season on the Amazon Fire Cube, but it does not under for Xbox One. In other words it looks like the Amazon Fire Cube client supports the season level but the Xbox One client does not. Would it be possible to have an option to enable the extras at both the show and season level? That way for clients that do not support the season level it will show at the show level but for clients that do support it it will properly shows at the season level (albeit for supported clients it will show at both the season and show level).
@Rojma, you can give the work in progress attached here a try – I’m not really happy with the order they’re displayed in at the show level, so I won’t update the GitHub version just yet.
Maybe we could create an userscript (for tampermonkey for example) that adds the “extras” section on the season and show level… but it may be more difficult than I think.
It’s a no-brainer that something like ‘Local TV Extras Agent’ should be baked-in to Plex as core functionality but seems that’s a lost cause 
. So, huge thanks to @contrary_cat for this contribution and supporting those of us who want to add it to their system.
I installed just a couple days back and still finding my way around the setup. I mainly want for DVD extras, especially those focused on some aspect of a particular season, to be associated with that season in Plex; with a client that support per-season extras (I use a Shield for most of my viewing) it works like a charm 
I don’t mind so much that the per-season featurettes I’ve added don’t show up in the Web client, since I typically don’t watch on the PC, except it seems there’s now no way to edit their details, like custom art, adding a summary, tweaking the displayed title, changing the search title, and so on, since they’re just not visible in the Plex management interface. Or am I missing something?
