ddupe CLI Docs v1.1.0

ddupe is a fast, safe CLI for finding and cleaning duplicate files by hashing their contents (SHA-256). It scans recursively, shows a progress bar plus the current file being hashed, and can delete duplicates in bulk or interactively.

Install

git clone https://github.com/Morrolan/ddupe.git
cd ddupe
cargo build --release

Binary: target/release/ddupe (or .exe on Windows).

Quick Scan

ddupe /path/to/scan

Find duplicates, prompt once before deletion.

Dry Run

ddupe --dry-run /path/to/scan

Preview duplicates without deleting.

JSON Report

ddupe --json-output /tmp/report.json /path/to/scan

Write the analysis to JSON without deleting or prompting.

Interactive

ddupe -i /path/to/scan

See numbered files per group and choose which to keep.

Features

Recursive scanning of directories
Content-based detection via SHA-256
Progress bar with current-file display
Interactive per-group selection, numbered choices, or keep all
JSON report output for automation (never deletes)
Dry-run safety mode and clear space-savings summary

Exit Codes

0 on success
Non-zero on errors (e.g., unreadable paths, deletion failures)

Tips

Set NO_COLOR=1 to disable colour in CI logs.
Run cargo fmt && cargo clippy && cargo test before PRs to match CI.