PlexBeam

← Back to Blog

Automate Media Quality Checks for Plex

October 15, 2026 · PlexBeam

A Plex library with thousands of files inevitably contains quality problems — corrupt files, truncated downloads, wrong codecs, missing audio tracks, absent subtitles, or files that do not match their reported quality. Manual checking is impossible at scale. Automated quality validation scans your entire library, identifies problems, and optionally fixes them. This guide covers the tools and scripts for automated media quality assurance.

Types of Quality Problems

Media files can fail in several ways:

Tdarr Health Checks

Tdarr is primarily a media conversion tool, but its health check plugins are equally valuable for quality validation without conversion.

How Health Checks Work

Tdarr scans your library directories and runs each file through a chain of plugins. Health check plugins examine file properties and flag issues without modifying the file. Failed files are reported in the Tdarr dashboard for review.

Useful Health Check Plugins

Setting Up Tdarr for Health Checks

  1. Install Tdarr (Docker or native) and point it at your Plex library directories.
  2. Create a library in Tdarr and add your media paths.
  3. Configure a plugin stack with health check plugins only (no conversion plugins).
  4. Run the initial scan. Tdarr catalogs every file and runs it through the health check chain.
  5. Review the results in the Tdarr dashboard. Files that fail any check appear in the error queue.

FFprobe Scripting

FFprobe (included with FFmpeg) extracts detailed information about media files in a machine-readable format. It is the foundation for custom quality validation scripts.

Basic FFprobe Commands

Get complete file information in JSON format:

ffprobe -v quiet -print_format json -show_format -show_streams input.mkv

This returns detailed data about every stream in the file: codec, resolution, bitrate, duration, language tags, and more.

Building a Validation Script

A quality validation script walks your library directory, runs FFprobe on each file, and checks the results against your requirements:

  1. Scan for all media files in the library directories.
  2. Run FFprobe on each file to extract stream information.
  3. Check video codec, resolution, and bitrate against minimum thresholds.
  4. Check audio tracks for required languages and codecs.
  5. Check subtitle tracks for required languages.
  6. Log failures with the specific problem and file path.
  7. Generate a summary report with total files scanned, passed, and failed.

Common Validation Rules

Corrupt File Detection

FFmpeg Decode Test

The most reliable corruption test is a full decode pass through FFmpeg:

ffmpeg -v error -i input.mkv -f null -

This decodes the entire file without writing output. Any decoding errors are printed to stderr. A clean file produces no output. A corrupt file produces error messages identifying the type and location of corruption.

Partial Decode

Full decode tests are slow for large files. For faster scanning, decode only the first and last few minutes of each file — corruption is most common at the beginning (bad headers) and end (truncated downloads).

Automated Corruption Scanning

Schedule a corruption scan to run weekly during off-peak hours. The script should:

  1. Scan all files in the library.
  2. Run the FFmpeg decode test on each file.
  3. Log any files with errors.
  4. Optionally send a notification with the results.

Audio Track Verification

Verify that every file has the audio tracks your users expect:

Subtitle Verification

Check subtitle availability for each file:

Reporting

Summary Reports

Generate weekly quality reports that include:

Integration With Monitoring

Send quality scan results to your monitoring stack. Tautulli can display custom scripts' output. Discord or Slack webhooks provide real-time notifications for critical failures like newly detected corruption.

Troubleshooting

False Positive Corruption

Scans Are Too Slow

Need Expert Help?

Our team is ready to assist you.

Visit Our Homepage →

Related guides

More from LuxuriousComputers: LuxuriousComputers · Computer Repair · Remote Fix · Phone Repair · HVAC · Plex Support