Skip to content

An application that sorts newly downloaded files into categories to fix your messy folders.

Notifications You must be signed in to change notification settings

4ngel2769/messy-file-organizer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

34 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Messy File Organizer

Smart file organization for your downloads folder

Latest Release License

Table of contents

Click to expand

About

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.

Features

✨ 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

Installation

Windows

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.

Linux

Download the AppImage from the latest release page.

Using the GUI

Messy File Organizer features a modern, user-friendly interface that makes configuration simple and intuitive.

General Settings

  • Set your downloads folder location
  • Enable/disable notifications
  • Configure auto-start options
  • Choose between light and dark themes or use system settings

Categories

  • Manage category folders where files will be organized
  • Add new categories for custom organization
  • Customize the destination path for each category

File Extensions

  • Configure which file extensions belong to which categories
  • Add custom mappings for specific file extensions
  • Set default category for unknown file types

Statistics

  • View file distribution across categories
  • See total file count and size for each category
  • Track recent file organization activity

Tools

  • 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

Advanced Settings

  • Configure retry attempts and delays for file operations
  • Backup and restore your configuration
  • Fine-tune application behavior

Running from Source

If you prefer to run the application directly from source code, follow these steps:

Requirements

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

Command Line Usage

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

Building from Source

You can build standalone executables from the source code.

Windows Building

# 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.

Linux Building

# 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

macOS Building

Building on macOS requires similar steps to Linux, but has not been extensively tested.

Contributing

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.


If you find this project useful, consider supporting its development!

Made with ❀️ by Angel

About

An application that sorts newly downloaded files into categories to fix your messy folders.

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

  •  

Languages