Kometa Overlay Reset

Kometa Overlay Reset is a Python tool created to remove all overlays applied to a Plex library by Kometa, using methods that are not available within Kometa…

  • Media Servers
  • Tools & Utilities
Kometa Overlay Reset is a Python tool created to remove all overlays applied to a Plex library by Kometa, using methods that are not available within Kometa itself. It's typically needed when the original backup posters used by Kometa to remove overlays have been lost.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

58/100 Fair

Maintained
76last commit 40 days ago
Popular
3238 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
79no serious findings, 1 minor, CI

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 36 days ago

GitHub stars
38
Open issues
5
Last commit
2026-10-12
Latest release
v1.0.7
License
MIT
Activity
stale

Checked 10 days ago - source: GitHub (Kometa-Team/Overlay-Reset)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set up Docker folders and port If you use the Docker Compose file, point the config and data settings to folders on your machine and make port 8080 available. If the folders are not kept outside the container, your settings and data can be lost; if port 8080 is blocked, you cannot reach the app. source
  • Install local Python dependencies For a local install, activate the Python virtual environment (a separate Python space) and install requirements.txt before running quickstart.py. Without that step, Python may be missing needed files and the script can fail to start. source
  • Add your Plex address and token When setting up Kometa, provide your Plex server URL and a Plex token, which is the secret string Plex uses to let Kometa sign in. Without a valid token, Kometa cannot connect to your library or make changes. source
  • Install Kometa Overlay Reset can be installed as a local Python script or run as a Docker container. source

Fetched 38 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What Docker storage and port settings are important?

Point the Docker config and data settings to folders on your machine and make port 8080 available. If the folders are not kept outside the container, settings and data can be lost, and a blocked port makes the app unreachable.

What Plex information is required to connect?

Provide your Plex server URL and a Plex token, which is the secret string Plex uses to let Kometa sign in. Without a valid token, Kometa cannot connect to your library or make changes.

When should I use Overlay Reset?

Use it as a last resort to repair a damaged Kometa installation. It removes all overlays placed on a Plex library.

Why does Kometa report that a poster already has an overlay?

Kometa adds an EXIF tag to the uploaded image when it applies an overlay. That tag lets it identify the image as already having an overlay applied.

Where should overlay reset attributes be placed in the configuration?

remove_overlays, reset_overlays, reapply_overlays, and schedule_overlays are library attributes. They are called at the library level rather than within overlay_path.

Answers sourced from kometa.wiki, kometa.wiki, kometa.wiki, www.kometa.wiki, www.reddit.com

Community

Collected 49 days ago - public community threads