plex-poster-set-helper

plex-poster-set-helper is a tool to help upload sets of posters from ThePosterDB or MediUX to your Plex server in seconds!

Installation

1. Install Python (if not installed already)

2. Extract all files into a folder

3. Open a terminal in the folder

4. Install the required dependencies using

pip install -r requirements.txt

5. Rename example_config.json to config.json, and populate with the proper information
   • "base_url"
     • the IP and port of your plex server. e.g. "http://12.345.67.890:32400/"
   • "token"
     • your Plex token
     • NOTE: this can be found here
   • "tv_library"
     • the name of your TV Shows library (e.g. "TV Shows")
     • multiple libraries are also supported, check the Multiple Libraries section of the README
   • "movie_library"
     • the name of your Movies library (e.g. "Movies")
     • multiple libraries are also supported, check the Multiple Libraries section of the README
   • "mediux_filters"
     • including any of these flags will have the script upload those media types.
       • show_cover
       • background
       • season_cover
       • title_card

Usage

Run plex_poster_set_helper.py

Supported Features

Multiple Libraries

To utilize multiple libraries, update the config.json as follows:

"tv_library": ["TV Shows", "Kids TV Shows"],
"movie_library": ["Movies", "Kids Movies"]

To clarify, use the names of your own libraries, those are just placeholders. If the media is in both libraries, the posters will be replaced in both libraries. I intend on adding more specific selection filtering in the future.

Bulk Import

1. Enter bulk in the first input prompt
2. Enter the path to a .txt file (reference example_bulk_import)

Using args

Command line arguments are supported.

1. Passing a single link e.g.plex_poster_set_helper.py https://mediux.pro/sets/9242

2. Passing a bulk import file e.g. plex_poster_set_helper.py bulk example_bulk_import.txt