Preview Maid

Preview Maid is a tool that scans your Plex library for missing preview thumbnails, voice activity analysis data, and marker data.

  • Tools & Utilities
Preview Maid is a tool that scans your Plex library for missing preview thumbnails, voice activity analysis data, and marker data. It can run as a daily scheduled job at a configurable time or as a one-off task.

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

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

Collected 49 days ago - public community threads