🌪️ Chaos Organizer

Chaos Organizer is an intelligent, set-it-and-forget-it background service for Windows that automatically keeps your Downloads folder pristine. Unlike simple script-based organizers, it uses OS-level event monitoring to sort files instantly, analyzes file content to categorize documents, and intelligently manages disk space by cleaning up old installers.

✨ Key Features

• ⚡ Real-Time Monitoring: Uses watchdog to detect and sort files the instant they are downloaded—no polling or manual running required.
• 🧠 Intelligent Content Analysis:
  • Reads PDFs and Word Docs to classify them based on content (e.g., invoices go to Finance/Invoices automatically).
  • Handles tricky text encodings (UTF-16/LE) often generated by system tools.
• 🧹 Smart Purge System: A background scheduler identifies and moves setup files (.exe, .msi) older than 7 days to a "Pre-Trash" staging area, keeping your workspace clutter-free without immediate permanent deletion.
• 🛡️ Conflict Handling: Never overwrites files. Automatically handles duplicate filenames with timestamping.
• 🕵️‍♂️ Unobtrusive Operation: Runs silently in the System Tray with a modern, minimal footprint.
• 🚀 Zero-Touch Startup: Automatically launches on system boot via the Windows Startup folder.

🛠️ Installation

1. Clone the Repository:

   git clone https://github.com/SamXavii902/Chaos-Organizer.git
   cd Chaos-Organizer

2. Install Dependencies:

   pip install -r requirements.txt

3. Run the Application: Double-click chaos_startup.bat to start the service.

⚙️ Configuration

The system is pre-configured to watch your %USERPROFILE%/Downloads folder. You can customize mappings in config/mappings.json:

{
  "extension_mappings": {
    ".jpg": "Images",
    ".pdf": "Documents",
    ".exe": "Installers"
  }
}

🖥️ Usage

Once running, Chaos Organizer sits in your System Tray.

• Right-click the icon to see options:
  • Organize Now: Manually trigger a scan of existing files.
  • Quit: Stop the background service.

🏗️ Built With

• Python - Core Logic
• Watchdog - Filesystem Event Handling
• APScheduler - Periodic Task Scheduling (Smart Purge)
• Pystray & Pillow - System Tray GUI
• PyPDF2 & python-docx - Content Analysis

---

Built with ❤️ for a cleaner digital workspace.