dl-cleaner

dl-cleaner is a lightweight Rust CLI tool that scans your Downloads directory and organizes files by extension.
It identifies files, shows a categorized preview, and (optionally) moves them into folders such as Images/, Videos/, Documents/, and more.

Installation

cargo install dl-cleaner

Requires a recent Rust toolchain.

Usage

# Scan the Downloads directory (no changes)
dl-cleaner --scan-only

# Scan a custom directory
dl-cleaner --dir /path/to/Downloads --scan-only

# Scan and organize (move files by extension)
dl-cleaner
dl-cleaner --dir /path/to/Downloads

Options:

--dir <PATH>
Path to the directory to scan.
Defaults to your system’s ~/Downloads (resolved via dirs::download_dir()).
--scan-only
Performs a scan and shows categorized results without moving any files.

Behavior

Scans the target directory and lists all files found.
Groups files by extension (e.g., images, videos, archives, documents).
Displays categorized results before taking any action.
When executed without --scan-only, moves files into extension-based folders under the same directory.
Automatically handles name conflicts using a safe pattern like file (1).ext.

Example Output

Scanning: ~/Downloads

Images:
  - photo.jpg
  - screenshot.png

Videos:
  - clip.mp4

Documents:
  - resume.pdf

License