A Python tool with CLI + GUI modes to automatically organize messy folders into neat categories. Perfect for Downloads or Desktop cleanup.
A robust, professional, and modern file organization tool with a beautiful GUI and advanced settings.
File Organizer Pro is designed to help you keep your files and folders organized with minimal effort. Whether you have a cluttered Downloads folder, a massive collection of images, or just want to automate your file management, this tool provides a user-friendly, powerful, and customizable solution.
Click to expand: Screenshots & Workflow
- Select a folder to organize (default is Desktop)
- Scan to preview how files will be categorized
- Organize to move files into folders by type or custom rules
- Review logs and statistics for transparency and control
- 🗂️ Smart file categorization: Automatically sorts files by type (images, videos, documents, etc.)
- 🎯 Custom category creation: Define your own rules for file organization
- 👀 Preview mode (dry run): See what will happen before making changes
- ⌨️ Keyboard shortcuts: For power users and efficiency
- 🖱️ Drag & drop support: Quickly add folders to organize
- 📊 Real-time statistics: See counts and categories instantly
- 📝 Activity logging: Track every action for peace of mind
- 🎨 Modern dark & light themes: Choose your preferred look
- ⚙️ Settings: Control default folder, file type filters, theme, and log file location
Open the Settings dialog (⚙️) to customize your experience:
- Default Folder: The folder shown by default when the app starts. Set to your Desktop or any frequently used directory.
- File Type Filters: Only organize files matching these patterns (e.g.
*.jpg;*.png;*.mp4). Separate multiple types with semicolons. - Theme: Switch between dark and light modes for comfort.
- Log File Location: Choose where activity logs are saved for review or troubleshooting.
Example settings.json:
{
"default_folder": "C:/Users/YourName/Desktop",
"file_type_filters": "*.jpg;*.png;*.mp4",
"theme": "dark",
"log_file_location": "file_organizer.log"
}python build_executable.py
# Then navigate to FileOrganizerPro_Distribution/
python install_gui.py
# Or run Install.bat for command-line installationpip install -r requirements.txt
python organizer_gui.py- Run the application
- Select a folder to organize (default is Desktop, can be changed in Settings)
- Click 'Scan' to preview categories and see what will be organized
- Enable 'Dry Run' to test changes without moving files
- Click 'Organize Files' to start organizing
- Review the log and statistics for details on what was moved and where
- Customize via ⚙️ Settings for a tailored experience
| Shortcut | Action |
|---|---|
| Ctrl+O | Browse for folder |
| Ctrl+S | Scan folder |
| Ctrl+R | Start organization |
| Escape | Stop organization |
| F1 | Show help |
- Always use Dry Run first to preview changes, especially on important folders.
- Backup important data before organizing large or critical directories.
- Use custom categories to fine-tune how your files are sorted.
- Check the log file for a record of all actions and for troubleshooting.
- Update your file type filters to focus on specific file types as needed.
Q: The app doesn't start or crashes.
A: Make sure you have Python 3.7+ installed and all dependencies from requirements.txt.
Q: Files aren't being moved. A: Ensure 'Dry Run' is disabled. Check your file type filters and permissions.
Q: How do I reset my settings?
A: Delete or edit settings.json in the app directory.
Q: Can I undo an organization? A: Use the log file to see what was moved and manually restore if needed. Undo functionality is planned for future releases.
Q: How do I add new file types or categories? A: Use the custom categories feature in the app or edit your settings.
- Windows 7 or later (for executable)
- Python 3.7+ (for Python version)
- No additional software required for executable
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
For issues or questions, please check the documentation or open an issue.
© 2025 File Organizer Pro. All rights reserved.