📁 File Organizer

A safe, interactive Python CLI that organizes any folder on your PC.

What it does

• By type — Images, Videos, Music, Documents, Code, Archives, etc.
• Screenshots → by day — Screenshots/2026-05-26/... (reads date from filename, falls back to file mtime)
• Patterns inside Documents — auto-detects: Bills, Salary, Bank, Tax, Notes, Books, Resumes, Reports, Meetings, Contracts, Tickets, Certificates, IDs
• Code → Scripts — automation_script.py, deploy_script.sh, etc. go under Code/Scripts/
• Duplicate detection — pick at runtime: file hash (accurate), name + size (fast), or both
• Summary markdown — ORGANIZATION_SUMMARY.md is written into the organized folder with a tree view and a per-folder file list
• Undo — every run saves a .undo.json so you can revert later

Safety model

1. Files are copied into a new folder <source>_Organized sitting next to your source folder — your originals are never touched during organization.
2. After it finishes, you're asked what to do:
   • Keep organized copy and delete originals (asks one more confirmation)
   • Keep both
   • Revert — delete the organized folder, originals untouched
3. Even after deleting originals, Undo can restore everything from the organized copy.

Requirements

• Python 3.8+ (no third-party packages — uses only the standard library)
• Works on Windows, macOS, Linux

Usage

python organize.py

Then follow the prompts. Pick option 1 to organize, 2 to undo a previous run.

Adding your own patterns

Open organize.py, scroll to PATTERN_RULES, and add a tuple:

("MyLabel", re.compile(_S + r"(?:keyword1|keyword2)" + _E)),

The _S and _E helpers handle word boundaries correctly across _, -, spaces, and dots.