Automatic File Manager for Windows

Windows desktop file organizer that watches your common folders and moves files into custom subfolders based on extension. It runs in the tray, starts minimized, and lets you edit the extension mapping directly from the UI.

Features

• Watches Desktop, Pictures, Documents, Videos, Downloads, and Music under a configurable base path.
• Moves files into extension-based subfolders (auto-creates target folders).
• Renames duplicates with (1), (2), etc. instead of overwriting.
• Tray icon with quick restore and exit.
• Built-in editor for extensions.yaml.

Quick start

1. Install dependencies:

   pip install -r requirements.txt

2. Run the app:

   python main.pyw

3. Set your base path in the UI (or edit config.yaml) and click "Update main path".

Configuration

Base path:

• config.yaml contains the root user folder. Example:

  path: C:\Users\YourName

• The app scans these folders under the base path: Desktop, Pictures, Documents, Videos, Downloads, Music.

Extensions mapping:

• extensions.yaml maps file extensions to subfolders (relative to the base path).
• Example entry:

  extensions:
    jpg: "Pictures/[FM] JPG's"
    pdf: "Documents/[FM] Office Documents"

• Use the "Edit File Types & Folder Locations" button to edit this safely.

Behavior notes

• Only files with configured extensions are moved; everything else stays put.
• Sorting is triggered by changes in the watched folders, then a full scan runs.
• Closing the window minimizes to tray; exit from the tray menu or the "Exit Program" button.

Build (optional)

To bundle as a single Windows executable:

pyinstaller --onefile --windowed main.pyw

Requirements

See requirements.txt.