WarpClean

The Problem

Your Downloads folder is a disaster. Your Desktop is cluttered. Your photo library is a mess of IMG_0001.jpg duplicates scattered across five folders.

You need to organize, but:

You don't want to lose files You don't want to spend hours doing it manually You don't trust tools that move things without showing you first You need a way to undo if something goes wrong

The Solution

WARPCLEAN gives you complete control: Feature What It Does Dry Run See exactly what will happen before any file is touched Undo System Every operation is logged and fully reversible Copy Mode Organize into a new folder without moving originals Warp Drive Mode Skip deep content analysis for maximum speed Duplicate Detection Identify and skip duplicate files automatically Date Organization Sort photos and videos by year, month, and day Related File Grouping Keep sequences and versions together Progress Tracking Visual progress bars for large operations Depth Control Limit recursion with --depth N Exclude Patterns Skip files/dirs via --exclude, --exclude-file, or .warpcleanignore Confirmation Prompt Real runs summarize the plan and ask before touching anything Config File Per-user and per-directory .toml defaults and custom categories Run Statistics --stats prints counts, bytes, per-category breakdown, elapsed time Idempotent A second run on an organized directory does nothing at all

Just run pip install warpclean !