Click to expand
Messy File Organizer is a powerful tool designed to solve the problem of cluttered download folders. It automatically categorizes and organizes files based on their types, keeping your digital workspace clean and efficient.
The application monitors your downloads folder in real-time, detecting new files and sorting them into appropriate category folders based on file extensions. This eliminates the need for manual organization and helps you find files quickly when needed.
Messy File Organizer works on Windows 10 & 11 and Linux systems. Mac support is experimental as it hasn't been extensively tested.
β¨ Automatic File Organization - Files are sorted into categories as soon as they're downloaded
π File Statistics - View distribution of files by category and size
π Duplicate File Detection - Find and manage duplicate files across categories
β±οΈ Scheduled Organization - Set up automatic organization on a daily, weekly, or monthly basis
π¨ Dark/Light Theme - Choose your preferred visual style or use system settings
π§ Customizable Categories - Add, remove, or modify file categories and extensions
πΎ Configuration Backup - Easily backup and restore your organization settings
You can use winget
to install it on Windows 11 and 10:
winget install 4ngel2769.MessyOrganizer
Or download the installer from the latest release page.
Download the AppImage from the latest release page.
Messy File Organizer features a modern, user-friendly interface that makes configuration simple and intuitive.
- Set your downloads folder location
- Enable/disable notifications
- Configure auto-start options
- Choose between light and dark themes or use system settings
- Manage category folders where files will be organized
- Add new categories for custom organization
- Customize the destination path for each category
- Configure which file extensions belong to which categories
- Add custom mappings for specific file extensions
- Set default category for unknown file types
- View file distribution across categories
- See total file count and size for each category
- Track recent file organization activity
- Duplicate File Detection: Find and manage duplicate files across categories
- Scheduled Organization: Configure automatic organization on a schedule
- Choose actions for duplicates: notify only, move to a separate folder, or delete
- Configure retry attempts and delays for file operations
- Backup and restore your configuration
- Fine-tune application behavior
If you prefer to run the application directly from source code, follow these steps:
Make sure you have the necessary libraries installed in your environment:
pip install PyQt5 pillow watchdog plyer
Clone and enter the repository:
# Clone the repository
git clone https://github.com/4ngel2769/messy-file-organizer.git
cd messy-file-organizer
# Install all dependencies
pip install -r requirements.txt
View available command line options:
python gui.py --help
Start the application with the graphical interface:
python gui.py
Once running, the application will appear in your system tray. You can access settings and controls by clicking the tray icon.
Tray Icon Options:
- Open Settings: Configure the application
- View Logs: Check the application logs
- Pause/Resume Monitoring: Temporarily stop file organization
- Enable/Disable Autostart: Control startup behavior
- Exit: Close the application
You can build standalone executables from the source code.
# Install PyInstaller if you don't have it
pip install pyinstaller
# Navigate to the project directory
cd messy-file-organizer
# Create the executable
pyinstaller --onefile --windowed --icon=mfo.ico --name="MessyFileOrganizer" gui.py
The executable will be created in the dist
folder.
# Install PyInstaller if you don't have it
pip install pyinstaller
# Navigate to the project directory
cd messy-file-organizer
# Create the executable
pyinstaller --onefile --windowed --icon=mfo.ico --name="MessyFileOrganizer" gui.py
Building on macOS requires similar steps to Linux, but has not been extensively tested.
Contributions are welcome! Here's how you can help:
- Report bugs by opening an issue
- Suggest features that would make the app more useful
- Submit pull requests with improvements or bug fixes
- Test on different platforms, especially macOS
Please ensure your code follows the project's style and includes appropriate documentation.