Skip to main content

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.

MediaCleaner Pro is designed to go from download to first run in under two minutes. There is no installer, no dependency to resolve, and no account to create. The steps below walk you through downloading the binary, pointing it at your images, and launching the web UI to kick off your first cleaning job.
1

Download the binary

Grab the binary for your platform from the GitHub Releases page.
PlatformFile
Windows x86_64mediacleaner-pro-windows-x86_64.exe
macOS Apple Siliconmediacleaner-pro-macos-aarch64
macOS Intelmediacleaner-pro-macos-x86_64
Linux x86_64mediacleaner-pro-linux-x86_64
On macOS and Linux, mark the binary as executable after downloading:
chmod +x mediacleaner-pro-macos-aarch64
2

Run the binary

Execute the binary from the directory where you want MediaCleaner Pro to store its configuration and database.
# macOS / Linux
./mediacleaner-pro

# Windows
mediacleaner-pro-windows-x86_64.exe
On the first run, MediaCleaner Pro automatically:
  • Creates a .env configuration file in the current directory
  • Creates the default input directory at data/source/
  • Creates the default output directory at data/output/
  • Initialises a SQLite database at mediacleaner.db
The terminal will show a log line confirming the server has started:
INFO mediacleaner_pro: server listening on http://127.0.0.1:8080
3

Add your images

Copy or move the images you want to process into the data/source/ directory that was created in the previous step.
cp ~/Pictures/*.jpg ./data/source/
Alternatively, if your images are already organised elsewhere on disk, open the .env file and update the SOURCE_DIR variable to point at that directory instead of copying files:
SOURCE_DIR=/Volumes/MyDrive/Photos
Restart the binary after editing .env for the change to take effect.
4

Open the web UI

With the binary running, navigate to the embedded web interface in any modern browser:
http://127.0.0.1:8080
The UI loads directly from the binary — no network connection or CDN is involved.
5

Configure and start a run

In the web UI you can review and adjust the source and destination directories and the Hamming threshold before starting. When you are ready, click Start.MediaCleaner Pro will progress through all ten pipeline stages and stream live status updates back to the browser. You can pause, resume, or cancel the run at any time using the controls at the top of the UI.

​
Output Directory Structure

After a completed run, processed files are organised under your configured DEST_DIR (default data/output/) using the following layout: 
output/
├── duplicates/
│   ├── exact/          # SHA-256 byte-for-byte duplicates
│   └── perceptual/     # Visually similar images (dHash)
├── rejected/
│   └── tiny/           # Images below the minimum size threshold
├── categories/
│   ├── icons/
│   ├── thumbnails/
│   ├── screenshots/
│   ├── wallpapers/
│   └── documents/
└── quality/
    ├── excellent/
    ├── good/
    ├── average/
    ├── below_average/
    └── poor/
Unique images that are not duplicates, not rejected, and do not match a category remain in the source directory untouched.
The default Hamming threshold of 4 is a good starting point for most libraries. If you are seeing too many false positives (dissimilar images flagged as duplicates) lower the value, or raise it to catch more near-identical shots. See the Configuration page for a full explanation of every available variable.

Build docs developers (and LLMs) love

Get started for freeTalk to us