Plex Meta Manager Overlay Reset

GitHub release (latest by date) Docker Image Version (latest semver) Docker Pulls Develop GitHub commits since latest stable release (by SemVer)

Discord Reddit Wiki GitHub Sponsors Sponsor or Donate

Plex Meta Manager Overlay Reset is an open source Python 3 project that has been created to Remove all Overlays placed on a Plex Library.

Installing PMM Overlay Reset

Generally, PMM Overlay Reset can be installed in one of two ways:

  1. Running on a system as a Python script [we will refer to this as a “local” install]

  2. Running as a Docker container

GENERALLY SPEAKING, running as a Docker container is simpler, as you won’t have to be concerned about installing Python, or support libraries, or any possible system conflicts generated by those actions.

For this reason, it’s generally recommended that you install via Docker rather than directly on the host.

If you have some specific reason to avoid Docker, or you prefer running it as a Python script for some particular reason, then this general recommendation is not aimed at you. It’s aimed at someone who doesn’t have an existing compelling reason to choose one over the other.

Install Walkthroughs

There are no detailed walkthroughs specifically for PMM Overlay Reset but the process is extremely similar to how you would do it with Plex Meta Manager.

Local Install Overview

PMM Overlay Reset is compatible with Python 3.11. Later versions may function but are untested.

These are high-level steps which assume the user has knowledge of python and pip, and the general ability to troubleshoot issues.

  1. Clone or download and unzip the repo.

git clone
  1. Install dependencies:

pip install -r requirements.txt
  1. If the above command fails, run the following command:

pip install -r requirements.txt --ignore-installed

At this point PMM-Overlay-Reset has been installed, and you can verify installation by running:


Docker Install Overview

Docker Run:

docker run -v <PATH_TO_CONFIG>:/config:rw meisnate12/pmm-overlay-reset
  • The -v <PATH_TO_CONFIG>:/config:rw flag mounts the location you choose as a persistent volume to store your files.

    • Change <PATH_TO_CONFIG> to a folder where your .env and other files are.

    • If your directory has spaces (such as “My Documents”), place quotation marks around your directory pathing as shown here: -v "<PATH_TO_CONFIG>:/config:rw"

Example Docker Run command:

These docs are assuming you have a basic understanding of Docker concepts. One place to get familiar with Docker would be the official tutorial.

docker run -v "X:\Media\PMM Overlay Reset\config:/config:rw" meisnate12/pmm-overlay-reset

Docker Compose:

Example Docker Compose file:

version: "2.1"
    image: meisnate12/pmm-overlay-reset
    container_name: pmm-overlay-reset
      - TZ=TIMEZONE #optional
      - /path/to/config:/config
    restart: unless-stopped


A Dockerfile is included within the GitHub repository for those who require it, although this is only suggested for those with knowledge of dockerfiles. The official PMM Overlay Reset build is available on the Dockerhub Website.


Each option can be applied in three ways:

  1. Use the Shell Command when launching.

  2. Setting the Environment Variable.

  3. Adding the Environment Variables to config/.env




Plex URl

Plex URL of the Server you want to connect to.
Shell Command: -u or --url ""
Environment Variable: PLEX_URL=

Plex Token

Plex Token of the Server you want to connect to.
Shell Command: -t or --token 123456789
Environment Variable: PLEX_TOKEN=123456789

Plex Library

Plex Library Name you want to reset.
Shell Command: -l or --library Movies
Environment Variable: PLEX_LIBRARY=Movies

PMM Asset Folder

Plex Meta Manager Asset Folder to Scan for restoring posters.
Shell Command: -a or --asset "C:\Plex Meta Manager\config\assets"
Environment Variable: PMM_ASSET=C:\Plex Meta Manager\config\assets

PMM Original Folder

Plex Meta Manager Original Folder to Scan for restoring posters.
Shell Command: -o or --original "C:\Plex Meta Manager\config\overlays\Movies Original Posters"
Environment Variable: PMM_ORIGINAL=C:\Plex Meta Manager\config\overlays\Movies Original Posters


TMDb V3 API Key for restoring posters from TMDb.
Shell Command: -ta or --tmdbapi 123456789123456789
Environment Variable: TMDBAPI=123456789123456789

Start From

Plex Item Title to Start restoring posters from.
Shell Command: -st or --start "Mad Max"
Environment Variable: START=Mad Max


Restore specific Plex Items by Title. Can use a bar-separated (|) list.
Shell Command: -it or –items “Mad Max|Mad Max 2”
Environment Variable: ITEMS=Mad Max|Mad Max 2


Timeout can be any number greater then 0. Default: 600
Shell Command: -ti or --timeout 1000
Environment Variable: TIMEOUT=1000

Dry Run

Run as a Dry Run without making changes in Plex.
Shell Command: -d or --dry
Environment Variable: DRY_RUN=True

Flat Assets

PMM Asset Folder uses Flat Assets Image Paths.
Shell Command: -f or --flat
Environment Variable: PMM_FLAT=True

Reset Season Posters

Restore Season posters during run.
Shell Command: -s or --season
Environment Variable: SEASON=True

Reset Episode Posters

Restore Episode posters during run.
Shell Command: -e or --episode
Environment Variable: EPISODE=True

Ignore Automatic Resume

Ignores the automatic resume.
Shell Command: -ir or --ignore-resume
Environment Variable: IGNORE_RESUME=True

Trace Logs

Run with extra trace logs.
Shell Command: -tr or --trace
Environment Variable: TRACE=True

Log Requests

Run with every request logged.
Shell Command: -lr or --log-requests
Environment Variable: LOG_REQUESTS=True

Example .env File

PMM_ASSET=C:\Plex Meta Manager\config\assets
PMM_ORIGINAL=C:\Plex Meta Manager\config\overlays\Movies Original Posters