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

Install Python (if not installed already)
Extract all files into a folder
Open a terminal in the folder
Install the required dependencies using

pip install -r requirements.txt

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

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

Using args

Command line arguments are supported.

Passing a single link e.g.plex_poster_set_helper.py https://mediux.pro/sets/9242
Passing a bulk import file e.g. plex_poster_set_helper.py bulk example_bulk_import.txt