# Preview Maid

Preview Maid is a tool that scans your Plex library for missing preview thumbnails, voice activity analysis data, and marker data. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1938/preview-maid

## Description

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 6 install platforms: Unraid.

## Health score

54/100 (Fair), based on 3 of 4 factors.
- Maintained: 100 (last commit 14 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/fletchto99/preview-maid
- Unraid: https://ca.unraid.net/apps/previewmaid-1fwgmmr1g9kso7?q=PreviewMaid

## 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.

## Alternatives

- OSS Gallery: Discover the best open-source projects.
- PRISM Break: Opt out of PRISM, the NSA’s global data surveillance program.
- Privacium: An open-source app built to guide you through the world of digital privacy.
- Privacy Guides: Privacy Guides is a socially motivated website that provides information for protecting your data security and privacy.
- PrivacyTools.io: You are being watched.
- Product Hunt: Product Hunt is a curation of the best new products, every day.
- SimilarSites: Easily find more sites like those you like.
- Slant: Slant is a product recommendation community with the goal of making it effortless to find the best product, app or game for you.
- alternative.me: Welcome to alternative.me, the source of better software alternatives.
- freemediaheckyeah: The largest collection of free stuff on the internet!.

---
Source: Our Local Host (https://ourlocalhost.com/app/1938/preview-maid), the self-hosted and open-source app directory.