QuickSort – File Size Organizer v1.0.0

QuickSort v1.0.0 is a professional-grade desktop file management tool designed to organize files automatically based on their size.
It is built for power users, developers, IT professionals, and everyday users who need a fast and reliable way to categorize large collections of files.

QuickSort emphasizes automation, drag & drop workflow, pause/stop control, and safe batch operations with real-time progress monitoring.

This edition focuses on intelligent file size grouping, batch processing, and a clean modern desktop interface.

---

WINDOWS DOWNLOAD (EXE)

Download the latest Windows executable from GitHub Releases:

https://github.com/rogers-cyber/QuickSort/releases

• No Python installation required
• Portable standalone executable
• Ready-to-run on Windows

---

DISTRIBUTION

QuickSort is a paid / commercial desktop utility.

This repository/documentation may include:

• Production-ready Python source code
• Compiled desktop executables (Windows)
• Commercial licensing terms (see LICENSE / sales page)

Python is not required when using the compiled executable version.

---

FEATURES

CORE CAPABILITIES

• Drag & Drop files or folders directly into the application
• Batch file organization by size category
• Move or Copy file operations
• Automatic folder creation based on size ranges
• Pause and Resume file processing
• Stop operations instantly
• Real-time file processing log panel

SIZE ORGANIZATION

• Files automatically sorted into size groups:

  0-1MB
  1-10MB
  10-100MB
  100MB-1GB
  1GB+

• Fully automatic size detection

• Efficient handling of large file collections

PERFORMANCE & UX

• Background processing threads (non-blocking UI)
• Real-time progress tracking
• Professional dark UI (ttkbootstrap)
• High-DPI friendly interface
• Fast batch processing

STABILITY & SAFETY

• Crash-safe logging to error.log
• Failed files do not interrupt batch jobs
• Thread-safe UI updates
• Graceful pause and stop operations
• Safe file handling with exception protection

---

APPLICATION UI OVERVIEW

• File Selection Panel Add files or entire folders using Browse or Drag & Drop

• Output Controls Select destination folder for organized files

• Operation Mode Choose between Move or Copy operations

• Control Buttons Start organizing, Pause/Resume, Stop processing

• Progress Panel Displays overall sorting progress and status

• Log Panel Real-time log of processed files and errors

---

INSTALLATION (SOURCE CODE)

1. Clone the repository:

git clone https://github.com/rogers-cyber/QuickSort.git cd QuickSort

2. Install required dependencies:

pip install ttkbootstrap tkinterdnd2

(Tkinter is included with standard Python installations.)

3. Run the application:

python QuickSort.py

4. Optional: Build a standalone Windows executable using PyInstaller:

pyinstaller --onefile --windowed --name "QuickSort" --icon=logo.ico QuickSort.py

---

USAGE GUIDE

1. Add Files or Folders

   • Click "Add Files"
   • Click "Add Folder"
   • Or Drag & Drop items into the file list

2. Select Output Folder

   • Click "Browse"
   • Leave empty to organize next to original file location

3. Choose Operation Mode

   • Move files (default)
   • Copy files to destination

4. Start Organization

   • Click "📂 Organize Files"

5. Monitor Progress

   • Progress bar displays batch progress
   • Log panel shows real-time operations

6. Control Execution

   • Pause to temporarily halt processing
   • Resume to continue
   • Stop to cancel immediately

---

LOGGING & SAFETY

• Automatic crash-safe logs written to error.log
• Errors are logged without crashing the application
• Failed operations are skipped safely
• Full stack traces preserved for debugging

---

REPOSITORY STRUCTURE

QuickSort/ ├── QuickSort.py ├── logo.ico ├── requirements.txt ├── README.md ├── LICENSE

---

DEPENDENCIES

• Python 3.10+
• ttkbootstrap
• Tkinter
• tkinterdnd2
• shutil
• threading
• queue
• traceback
• os
• sys

---

INTENDED USE

QuickSort is ideal for:

• Managing large file collections
• Organizing downloaded files
• Cleaning up storage drives
• Preparing file archives
• IT and system administration tasks
• Automated file organization workflows

It is built for speed, reliability, and ease of use in real-world file management scenarios.

---

ABOUT

QuickSort is developed by Mate Technologies, delivering professional offline productivity tools for Windows users.

Website: https://matetools.gumroad.com

© 2026 Mate Technologies
All rights reserved.

---

LICENSE

QuickSort is commercial software.

• Distributed as commercial source code
• Personal and commercial use allowed
• Redistribution, resale, or rebranding as a competing product is not permitted
• Use of the compiled executable is allowed under the commercial license