Skip to content

qs-1/Folder-Sorter

Repository files navigation

Folder Sorter

A Windows system tray app that automatically monitors a folder and sorts new files into categorized subfolders in real-time along with support for manual sorting.

Folder-Sorter-demo

tray_options

Features

  • Automatic Realtime Sorting: Enable "Auto-Sort" to have the app run in the background to automatically sort new files the moment as they appear in your target folder
  • Undo Sorts: Reverse the most recent sort(s) (whether manual or automatic, though you need to disable auto-sorting to undo automatic sorts)
  • System Tray Integration: Runs in the system tray for convenience
  • Configuration GUI: For setting your target folder and define custom folder extension mapping rules
  • Duplicate Handling: Renames files (like file_1.txt) to prevent ever overwriting your existing files
  • Persistent Settings: Your folder path, rules, and preferences are automatically saved to %LOCALAPPDATA%\FolderSorter\config.json

Installation

  1. Go to the Releases Page
  2. Download & run FolderSorter.exe
  3. Look for the folder icon in your system tray.

For Development

Prerequisites:

  • Python 3.x
  • Git

Setup:

  1. Clone the repo and navigate into it:

    git clone https://github.com/qs-1/Folder-Sorter.git
    cd Folder-Sorter
  2. Create a virtual environment and install dependencies:

    # Create and activate the environment
    python -m venv venv
    .\venv\Scripts\activate  # On Windows
    # source venv/bin/activate  # On macOS/Linux
    
    # Install the required packages
    pip install -r requirements.txt
  3. Run the application:

    python main.py

    After running, the Folder Sorter icon will appear in your system tray.

Contributing

Contributions, issues, and feature requests are welcome, feel free create an issue.

License

This project is licensed under the MIT License.