plex-poster-extractor

An automated Python script that connects to your Plex Media Server and extracts all media posters

Prerequisites

• Python 3.8 or higher
• Network access to your Plex Media Server
• Your personal Plex Authentication Token

How to Get Your Plex Token (View XML Method)

1. Log in to your Plex Web App on a browser.

2. Select any media item (movie, episode, or show) in your library.

3. Click the three dots (...) menu on the media details page to open context options.

4. Select Get Info.

5. Click View XML in the bottom left corner of the pop-up window.

6. A new browser tab opening the XML document will appear. Look at the URL bar of this new tab.

7. Locate X-Plex-Token= at the very end of the URL string. The characters following it are your token string.

   Example: https://...&X-Plex-Token=YOUR_TOKEN_HERE

Setup & Configuration

1. Clone or download this repository. Open your terminal or command prompt and run the following command to download the project to your local machine:

   git clone https://github.com/sneseric/plex-poster-extractor.git
   

2. Enter the project directory

   cd clanker-eric
   

3. Create a .env file in the root directory next to extract_posters.py:

   PLEX_TOKEN=your_plex_token_here
   PLEX_URL=http://localhost:32400

(Note: PLEX_URL is optional. If omitted, it defaults to http://localhost:32400)

Install required packages:

pip install -r requirements.txt

Usage

Run the main application script from your terminal:

python extract_posters.py

When prompted: Extract all posters from Plex Server now? (y/n) input y to execute or exit to close. All media posters will save in ./posters_extracted/ following the naming standard:

Movies: {Library}{Movie Name}.jpg TV Shows: {Library}{Show Name}S{Season}E{Episode}{Episode Title}.jpg