ImageMaid

ImageMaid is a Kometa Team utility that cleans Plex directories by removing unused overlays, custom artwork, and PhotoTranscoder files, and automates Plex…

  • Tools & Utilities
ImageMaid is a Kometa Team utility that cleans Plex directories by removing unused overlays, custom artwork, and PhotoTranscoder files, and automates Plex trash, bundle, and database maintenance.

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.

47/100 Fair

Maintained
74last commit 40 days ago
Popular
53439 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
05 serious findings, 23 minor, CI, tests

Based on 4 of 5 factors.

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

GitHub stars
439
Open issues
24
Last commit
2026-10-12
Latest release
v1.2.2
License
MIT
Activity
rising

Checked 20 days ago - source: GitHub (Kometa-Team/ImageMaid)

Resources & Compatibility

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

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

First-install notes

  • Create your .env settings file Copy config/example.env to config/.env and fill in PLEX_PATH (your Plex media folder), PLEX_URL, PLEX_TOKEN, and SCHEDULE, because ImageMaid only reads .env in config/, not example.env. Without valid Plex details and a schedule, it won't connect or know when to clean. source
  • Set SCHEDULE with one job per block Use comma-separated blocks like 08:00|weekly(sunday)|mode=clear, and separate multiple options inside one block with semicolons. If the time, frequency, or mode is misspelled, that cleanup job may not run as expected. source
  • Install Python packages and test run If you installed from source, run pip install -r requirements.txt inside a virtual environment (a separate Python setup), then run python imagemaid.py to verify setup. This prevents missing Python packages from breaking the app before its first scheduled run. source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can ImageMaid reduce Plex appdata backup time and size?

One user reported that running ImageMaid shrank the Plex appdata folder by 100 GB and 500,000+ files. That reduced backup time and the overall backup file size.

Can ImageMaid fail to run because of Plex errors?

Yes, it can fail if Plex returns a 500 Internal Server Error while downloading the database or logs.

Does ImageMaid remove unused posters and custom art?

Yes, it can clean bloated Plex image caches by removing unused posters and custom art automatically.

Is ImageMaid available as managed hosting?

Yes, ElfHosted offers managed ImageMaid hosting for cleaning up Plex image caches.

Answers sourced from docs.elfhosted.com, forums.plex.tv, www.reddit.com

Community

Collected 53 days ago - public community threads