← Downloads

cleanupx

Deduplicate, categorize, and clean directories. Absorbs fileherder.

v2.0.4 PyPI CLI

Install

PyPI pip install cleanupx 
cleanupx --help
cleanupx deduplicate --dir ~/Downloads
cleanupx scramble --dir ~/tmp/sandbox

Features

Deduplication

Find duplicate files and reclaim space without guessing which copy to keep.

Organization

Categorize and batch-process directories when Downloads becomes a landfill again.

Image helpers

Optional image processing paths for accessibility descriptions when you bring your own API keys.

Privacy scramble

Randomize filenames for testing or redaction, with logs so you can reverse the change.

Rich CLI

Progress output and structured commands instead of a pile of one-off shell scripts.

Tested core

Large pytest suite around the processing paths — run pytest in the repo when hacking on it.