ddupe CLI Docs

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.

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