A professional, feature-rich file organization tool that automatically sorts files into categorized folders. Supports multiple organization methods, duplicate detection, undo functionality, and detailed logging.
- Multiple Organization Methods - Category, Date, Size, First Letter, or Smart combination
- Recursive Scanning - Organize files in subdirectories
- Dry Run Mode - Preview changes before executing
- Undo Functionality - Revert last organization operation
- Duplicate Detection - SHA256 hash-based duplicate finding
- Detailed Statistics - Track files moved, folders created, size processed
- Comprehensive Logging - Save detailed operation logs
- History Tracking - JSON-based operation history
- Color-coded Output - Easy-to-read console output
- Professional Error Handling - Graceful error recovery
- Python 3.7 or higher
- No external libraries required (uses only built-in modules)
-
Clone the repository: git clone https://github.com/poisonmunna/fileorganizer.git
cd FileOrganizer -
Run the application:
python file_organizer.py
| Method | Description | Example Structure |
|---|---|---|
| Category | Sorts by file type | Images, Documents, Code |
| Date | Sorts by modification date | ByDate 2024 December 25 |
| Size | Sorts by file size | BySize Tiny, BySize Large |
| Letter | Sorts by first letter | ByLetter A, ByLetterB |
| Smart | Category + Date combination | ByDate 2024 December 25 Images |
📷 Images - jpg, png, gif, bmp, svg, ico, webp, raw, tiff, heic
📄 Documents - pdf, docx, doc, txt, md, rtf, odt, tex
💻 Code - py, js, html, css, cpp, java, php, rb, go, json, xml
🗜️ Archives - zip, rar, 7z, tar, gz, bz2, xz, iso
🎬 Videos - mp4, mkv, avi, mov, wmv, flv, webm, m4v
🎵 Music - mp3, wav, flac, aac, ogg, m4a, wma, opus
⚙️ Executables - exe, msi, app, deb, rpm, dmg, pkg
📊 Spreadsheets - xls, xlsx, csv, ods, numbers
📽️ Presentations - ppt, pptx, odp, key
📚 Ebooks - epub, mobi, azw, fb2
🗄️ Databases - db, sqlite, sql, mdb
💾 Backups - bak, old, backup, tmp
🎨 Design - psd, ai, eps, sketch, fig, xd
🔤 Fonts - ttf, otf, woff, woff2, eot
📧 Email - eml, msg, pst
🌐 Web - html, htm, css, js, php
📱 Mobile - apk, ipa, xapk
🎮 Games - gam, save, dat
🖼️ Vector - ai, eps, svg, cdr
📦 Packages - whl, egg, gem, jar
📝 Logs - log, out, err
🔧 Config - cfg, conf, ini, env, properties
❓ Others - Any other file types
======================================================================
🗂️ FILE ORGANIZER PRO - Interactive Mode
======================================================================
📂 Enter folder path to organize:
C:\Users\YourName\Downloads
📌 Select Organization Method:
- By Category (Images, Documents, Code, etc.)
- By Date (Year/Month/Day structure)
- By Size (Tiny to Huge)
- By First Letter (A-Z)
- Smart (Category + Date combination)
- Recursive (organize all subfolders)
👉 Choose (1-6): 1
🔍 Perform dry run first? (y/n): n
======================================================================
📁 FILE ORGANIZER PRO - C:\Users\YourName\Downloads
======================================================================
✅ Moved: vacation.jpg → 📷 Images/vacation.jpg
✅ Moved: resume.pdf → 📄 Documents/resume.pdf
✅ Moved: script.py → 💻 Code/script.py
✅ Moved: music.mp3 → 🎵 Music/music.mp3
Progress: 50/50
======================================================================
📊 ORGANIZATION SUMMARY
======================================================================
📁 Directory: C:\Users\YourName\Downloads
⏱️ Time taken: 3.45 seconds
✅ Files moved: 48
⏭️ Files skipped: 2
📦 Total size moved: 245.67 MB
🔄 Duplicates handled: 3
❌ Errors: 0
📂 New folders created: 8
📁 Created folders:
• 📷 Images
• 📄 Documents
• 💻 Code
• 🎵 Music
• 🎬 Videos
• 🗜️ Archives
• ❓ Others
| Argument | Description |
|---|---|
| directory | Path to folder to organize |
| --method, -m | Organization method (category, date, size, letter, smart) |
| --dry-run, -d | Preview changes without moving files |
| --recursive, -r | Process subdirectories recursively |
| --undo, -u | Undo last organization operation |
| --quiet, -q | Reduce output verbosity |
| --interactive, -i | Launch interactive mode |
The tool uses SHA256 hashing to identify duplicate files and handles them by adding number suffixes.
Every organization operation is logged and can be undone: python file_organizer.py ~/Downloads --undo
All operations are saved in organization_history.json for future reference.
Detailed logs are saved as organizer_log_YYYYMMDD_HHMMSS.txt with timestamps.
- Tiny: < 100 KB
- Small: 100 KB - 1 MB
- Medium: 1 MB - 10 MB
- Large: 10 MB - 100 MB
- Very Large: 100 MB - 1 GB
- Huge: > 1 GB
- Ignores system files (desktop.ini, Thumbs.db, .DS_Store)
- Skips organization folders to prevent recursion
- Handles permission errors gracefully
- Prevents moving the script itself
- Duplicate filename handling
Downloads/
├── vacation_2024.jpg
├── resume_final.pdf
├── project_script.py
├── data_analysis.csv
├── setup.exe
└── random_file.xyz
Downloads/
├── 📷 Images/
│ └── vacation_2024.jpg
├── 📄 Documents/
│ ├── resume_final.pdf
│ └── data_analysis.csv
├── 💻 Code/
│ └── project_script.py
├── ⚙️ Executables/
│ └── setup.exe
└── ❓ Others/
└── random_file.xyz
file-organizer-pro/
│
├── file_organizer.py # Main application
├── README.md # Documentation
├── LICENSE # MIT License
└── .gitignore # Git ignore file
- Run terminal as administrator (Windows) or use sudo (Linux/Mac)
- Close any programs using the files
- Check if files are in use by another program
- Verify the directory path is correct
- Try dry run mode first: --dry-run
- Ensure you haven't moved or deleted the history file
- History file is located in the organized directory: organization_history.json
- Files per second: 50-100 files (depending on storage speed)
- Memory usage: ~50 MB for 10,000 files
- Supports: Unlimited file count
Contributions are welcome!
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Open a Pull Request
Distributed under the MIT License. See LICENSE file for more information.
Your Name - 123razz321@gmail.com
Project Link: https://github.com/poisonmunna/FileOrganizer
If this project helped you organize your files, please give it a star on GitHub!
Made with Python | Keep your files organized!