[PLEX] FileBot Xattr Metadata Scanners & Plug-ins

How-to guides, frequently asked questions, not-so-obvious features, etc
Post Reply
User avatar
rednoah
The Source
Posts: 16773
Joined: 16 Nov 2011, 08:59
Location: Taipei
Contact:

[PLEX] FileBot Xattr Metadata Scanners & Plug-ins

Post by rednoah » 01 Aug 2019, 09:50

FileBot Xattr Metadata Scanners & Plug-ins

Enhance Plex with support for FileBot Xattr Metadata.



Installation

1. Download plex-agents.zip from GitHub.
2. Copy the Scanners and Plug-ins folders into the Plex Media Server
3. Restart Plex
4. Configure Advanced ➔ Scanner for each library and select FileBot Xattr Scanner
5. Configure Settings ➔ Agents and enable FileBot Xattr Metadata and move it to the top for each primary agent


FileBot Xattr Metadata Scanner

The FileBot Xattr Scanner will read name / year / season / episode / etc from xattr metadata instead of guessing and parsing information from the file path. This scanner will greatly enhance primary agents such as Plex Movie or TheTVDB, regardless of whether files are named according to {plex} standards or not. Files without xattr metadata will be ignored.

Image


FileBot Xattr Metadata Agent

The FileBot Xattr Metadata secondary agent can contribute title / airdate / etc from xattr metadata instantly, to improve your browsing experience while the primary agent is still busy in the background retrieving complete movie and episode information and artwork.

Image




I would imagine the following benefits / features to be most notable:
  1. The scanner will only "see" files that have been processed and tagged by FileBot, and ignore all other files.
  2. The movie scanner result will include the guid property, so it'll behave as if files are named with {imdbid} in the file name (e.g. Avatar (2009) [tt0499549]) even if the actual file name doesn't include that information. (@see FileBot Xattr Movie Scanner.py)
  3. The series scanner will include both name and year properties for each result, even if the year is not in the series folder name. (@see FileBot Xattr Series Scanner.py)
  4. The scanner is able to provide source information such as BluRay even if the file path no longer contains that piece of information after files have been renamed.
  5. The scanners will be able to provide the original name literally as listed in the database, even if that name contains characters like :, ?, /, ., -, etc that can't be used in the file path, or treated as meaningless whitespace-equivalent.
  6. If you're using the Personal Media agent, then xattr can be used as secondary agent, to fill in some of the missing information (e.g. episode titles). It's not a replacement for full-fledged TheTVDB / TheMovieDB agents, but it is 1000x faster to complete (i.e. no network requests at all) and possibly good enough depending on what you need.
:idea: Please read the FAQ and How to Request Help.

spetrillo
Posts: 55
Joined: 21 Jun 2015, 20:46

Re: [PLEX] FileBot Xattr Metadata Scanners & Plug-ins

Post by spetrillo » 04 Oct 2019, 19:53

Do the PLug-ins and Scanners folders go into the Plug-in directory on the PMS?

User avatar
rednoah
The Source
Posts: 16773
Joined: 16 Nov 2011, 08:59
Location: Taipei
Contact:

Re: [PLEX] FileBot Xattr Metadata Scanners & Plug-ins

Post by rednoah » 04 Oct 2019, 20:33

They go into this directory:
https://support.plex.tv/articles/202915 ... y-located/

Plex might pick them up from different locations though. Maybe your plug-in directory will work too.
:idea: Please read the FAQ and How to Request Help.

Post Reply