/PlexMatch-File-Generator

This application generates a .plexmatch file in the directory of all shows and movies added to your Plex Server. This is especially useful for migrating storage devices if you have some shows that needed a custom match.

Primary LanguageC#MIT LicenseMIT

PlexMatch File Generator

This application generates a .plexmatch file in the directory of all shows and movies added to your Plex Server. This is especially useful for migrating storage devices if you have some shows that needed a custom match.

Usage

The command is expecting 2 arguments from the command line

  • Plex Server Token (-t or --token)
  • Plex Server Url (-u or --url)

For information on how to get your Plex token, see this support link: https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/

Optional Parameters

  • Modify root path (-r or --root)
    • Use this option to set the root path used to be different than what your Plex server returns. For instance if your Plex container has the media mounted to /media and the computer running the application has it mounted to /mnt/media
    • Usage: -r /path/on/host:/path/on/plex
  • Set log path (-l or --log)
    • This will output the log to file at the path specified, log file will be named plexmatch.log in the directory specified. The path specified must exist! If this option is not specified, no log file will be output.
    • Usage: -l /home/user/logs
  • Get version (--version)
    • This will output the version of the executable being run
  • Disable Automatic Overwrite (--nooverwrite or -no)
    • This will skip writing any file if it already exists instead of overwriting it.
  • Set page size for batch processing (--pagesize or -ps)
    • This will change the default batch processing size. Default is 20 items
    • Usage: -ps 10
  • View help (--help)
    • This will output the parameter help

Examples

./PlexMatchGenerator-Linux-x64 -u http://192.168.0.3:32400 -t ABCD12345

./PlexMatchGenerator-Linux-x64 --url http://192.168.0.3:32400 --token ABCD12345

PlexMatchGenerator-Windows-x86.exe -u http://192.168.0.3:32400 -t ABCD12345

PlexMatchGenerator-Windows-x86.exe --url http://192.168.0.3:32400 --token ABCD12345

Donations

Donations are always accepted but never required. Currently I accept PayPal using the button below.

3rd Party Packages Used

Development Environment Setup

  • Clone repo
  • Open folder with VS Code
  • Ensure C# support is added (it should prompt if not)
  • Restore Nuget packages (command line: dotnet restore)
  • Application should build immediately out of box

Contributing

Contributions are welcome!

  • Fork the repo
  • Make your change
  • Submit a Pull Request, Ensure to include details of what problem is fixed, what is improved, etc. If it is in response to an issue, tag the issue on the PR
  • Submit your PR to merge into the Develop branch, merge requests to the main branch will be denied
  • Respond to and/or make changes based on PR comments