First, we look at everything
Scan lists the whole folder with sane limits, so nothing hides. Then categorize sorts by extension, magic bytes, photo dates, song tags. Twelve plus categories. Your custom rules welcome. Nothing judgy. We have all been there.
Then, we show you the plan
preview_organization lists every single move before anything happens. All 4,102 of them. Conflicts get a gentle policy: rename, skip, or overwrite with a backup kept. You approve when it feels right.
Then, one small move day
organize_files moves everything atomically. Photos land in year, month, day. Music lands as Artist, Album, Title. Duplicates are matched by SHA-256 hash, so even sneaky renamed copies are caught. You choose what stays.
Then, it stays that way
A little watch daemon tidies on schedule while the main server stays stateless and quiet. And if you ever miss the chaos, undo_last_operation brings it all back. No shame. We keep the manifest.