ImageMaid
ImageMaid is a Kometa Team utility that cleans Plex directories by removing unused overlays, custom artwork, and PhotoTranscoder files, and automates Plex…
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.
Security check: 5 serious findings
- Uses pillow 12.3.0, which has a known critical vulnerability (PyPI)
- Uses pillow 12.3.0, which has a known critical vulnerability (PyPI)
- Uses pillow 12.3.0, which has a known critical vulnerability (PyPI)
- Uses pillow 12.3.0, which has a known critical vulnerability (PyPI)
- Uses pillow 12.3.0, which has a known critical vulnerability (PyPI)
Automated checks on commit 611eb35, 1 Nov 2026. Not an audit.
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
Variants
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
- ImageMaid shrunk my Plex appdata folder by 100 GB (500k files) (reddit)
- Req for a Docker? ImageMaid (Plex Image Cleanup) - Unraid (forum)
- 500 Internal Server Error only when trying to download ... - Plex Forum (forum)
- What sort of tools and sites do peeps use with Plex setups? (reddit)
Collected 53 days ago - public community threads