Preview Maid
Preview Maid is a tool that scans your Plex library for missing preview thumbnails, voice activity analysis data, and marker data.
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.
52/100 Fair
- Maintained
- 100last commit 17 days ago
- Popular
- 61 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 208 GB minimum RAM, runs on ARM
Availability: platform listings confirmed today, links checked 34 days ago
- GitHub stars
- 1
- Open issues
- 2
- Last commit
- 2026-11-04
- License
- MIT
- Activity
- declining
Checked 10 days ago - source: GitHub (fletchto99/preview-maid)
Resources & Compatibility
Minimum requirements: 8 GB RAM. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Configuration Runs as a daily scheduled job at a configurable time by default, or can be set to execute once and exit after completion. source
Fetched 45 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Does PreviewMaid need a reverse proxy or web UI?
No; it runs as a Docker container that contacts Plex using PLEX_URL and PLEX_TOKEN. The docs only show container environment variables, not a host port for a web interface.
What Plex credentials does it require?
It requires PLEX_URL and PLEX_TOKEN environment variables pointing to your Plex instance and API token.
Can I exclude certain libraries from the scan?
Yes. Use SKIP_LIBRARY_TYPES for types such as movie, show, or photo, and SKIP_LIBRARY_NAMES for individual library names, both as comma-separated lists.
How do I make PreviewMaid exit after a single scan?
Set RUN_ONCE to true. It will run once and output before exiting instead of staying scheduled.
Where can I persist PreviewMaid logs?
Mount a volume at /app/logs. The log file is rotated and keeps the last 5 runs, and console output then shows statistics only.
Does PreviewMaid create missing thumbnail previews?
It finds missing previews; you force creation with the Analyze option on the library or media item in Plex. If thumbnail generation fails, set GenerateBIFKeyframesOnly to 0 in Plex advanced settings, which increases generation time and CPU load.
Answers sourced from github.com
Community
- Reddit (reddit)
- Alternative to Google Images - Open-Source image search engine (reddit)
- Maid - PRIMETIMER (forum)
Collected 49 days ago - public community threads