MediaCleaner Pro is a privacy-first image cleaning tool that runs entirely on your machine. Drop in a folder of images and a single native binary processes them through a 10-stage pipeline — finding exact duplicates, visually similar shots, tiny images, icons, screenshots, wallpapers, documents, and more — then organizes everything into a clean output directory. No cloud, no subscriptions, no data leaving your device.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/xcoder-es/media-cleaner-pro/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Download the binary, point it at your photos, and start cleaning in under two minutes.
Configuration
Tune thresholds, paths, and pipeline stages via a simple
.env file.Pipeline Stages
Understand all 10 detection stages and how each one classifies images.
API Reference
Drive MediaCleaner Pro programmatically with the full REST API.
How it works
MediaCleaner Pro reads every image file in your source directory, computes SHA-256 and perceptual dHash fingerprints, and passes each image through ten sequential detection stages. Files that match a stage’s criteria are moved to a well-structured output directory. Files that pass all stages are left in place or ranked by quality.Download the binary
Grab the latest release for your platform from the Releases page. No installer, no runtime dependencies.
Place your images
Copy or move your image library into
data/source/ (created automatically on first run), or set SOURCE_DIR in .env to an existing folder.Open the web UI
Run
./mediacleaner-pro and navigate to http://127.0.0.1:8080. The dashboard shows real-time progress across all 10 pipeline stages.Key features
10-Stage Pipeline
Exact deduplication (SHA-256), perceptual matching (dHash), size filtering, icon/thumbnail/screenshot/wallpaper/document detection, AI classification, and quality ranking.
100% Private
All processing is local. Images are never uploaded to any server.
Single Binary
Ships as one self-contained executable with the web UI embedded. Works on Windows, macOS (Intel & Apple Silicon), and Linux.
REST API & SSE
Full OpenAPI 3.1 spec at
/api/openapi.json. Start, pause, cancel jobs and stream live progress via Server-Sent Events.Smart Organization
Output is automatically sorted into
duplicates/, rejected/, categories/, and quality/ subtrees.Docker Support
Run in a containerized environment with the included
docker-compose.yml and optional Temporal workflow orchestration.