Sortify 🗂️

AI-Ready Smart File Organizer for Desktop

Sortify is a production-ready, thread-safe desktop application built with Python 3.12+ and PySide6 (Qt6). It automatically organizes files into dynamic, categorized directory trees based on file type, extension, metadata, and optional AI classification.

Sortify is designed to be fast, private, offline-first, and extensible, with features such as duplicate detection, instant search, real-time folder monitoring, operation history, and an extensible AI plugin architecture.

📚 Documentation Index

For in-depth documentation on architecture, design tokens, operational mechanics, and contributing guidelines:

📖 HOW_IT_WORKS.md — Detailed User Guide covering File Scanning, Categorization Rules, SHA-256 Duplicate Hashing, Instant Search, 1-Click Undo, Real-time Watchdog, and Settings.
🏗 DESIGN.md — System Architecture, Layered N-Tier Design, Multi-Threading Concurrency, SQLite Schema, and Path Traversal Security.
🎨 LAYOUT.md — UI Layout Hierarchy, Windows 11 Fluent HSL Design Tokens, QSS Stylesheets, Dark & Light Theme Engine, and Visual Design Principles.
🤝 CONTRIBUTING.md — Developer Guide for extending file categories, building AI plugins, and running automated tests.

🌟 Key Features

Multi-File & Folder Organization — Automatically sort files into category subdirectories such as Programming/Python, Images/PNG, and Documents/PDF.
Move or Copy Mode — Choose whether files should be moved or copied.
Modern Windows 11 Fluent UI — Dark & Light themes with responsive layouts and smooth interactions.
Instant Search Engine — Search files by name, category, extension, and fuzzy matching using RapidFuzz.
SHA-256 Duplicate Finder — Efficient two-pass duplicate detection using file size filtering followed by chunked SHA-256 hashing.
Safe Duplicate Cleanup — Delete duplicate files using the system recycle bin through send2trash.
Operation History & 1-Click Undo — Restore previously organized files through the built-in history system.
Real-Time Folder Monitoring — Automatically organize newly created files using Watchdog.
Extensible AI Plugin Architecture — Architecture ready for OCR, image classification, automatic tagging, and LLM-powered naming.
100% Offline & Private — No cloud dependency. Files and metadata remain on the user's device.

🚀 Quick Start

Prerequisites

Make sure you have:

Python 3.12 or newer
Git
Windows / Linux / macOS

Check your Python version:

python --version

1. Clone the Repository

Clone Sortify directly from GitHub:

git clone https://github.com/Prajapatidax/sortify.git

Move into the project directory:

cd sortify

2. Create a Virtual Environment

It is recommended to use a virtual environment.

Windows

python -m venv venv
venv\Scripts\activate

Linux / macOS

python3 -m venv venv
source venv/bin/activate

3. Install Dependencies

pip install -r requirements.txt

4. Run Sortify

python app.py

Sortify should now launch on your desktop.

🗂️ How Sortify Works

Suppose you have:

Downloads/

index.html
style.css
script.py
app.php
photo.jpg
logo.png
resume.pdf
song.mp3
video.mp4

Sortify automatically organizes them into:

Downloads/

├── Programming/
│   ├── HTML/
│   │   └── index.html
│   │
│   ├── CSS/
│   │   └── style.css
│   │
│   ├── Python/
│   │   └── script.py
│   │
│   └── PHP/
│       └── app.php
│
├── Images/
│   ├── JPG/
│   │   └── photo.jpg
│   │
│   └── PNG/
│       └── logo.png
│
├── Documents/
│   └── PDF/
│       └── resume.pdf
│
├── Audio/
│   └── MP3/
│       └── song.mp3
│
└── Videos/
    └── MP4/
        └── video.mp4

The folder structure is created automatically when required.

🔍 Supported File Categories

Programming

Python
Java
C
C++
C#
HTML
CSS
JavaScript
TypeScript
PHP
React
Vue
Go
Rust
Swift
Kotlin
Dart

Images

PNG
JPG
JPEG
GIF
WEBP
SVG
BMP
ICO
TIFF
RAW

Videos

MP4
AVI
MOV
MKV
WMV
FLV

Audio

MP3
AAC
WAV
FLAC
OGG

Documents

PDF
DOC
DOCX
TXT
RTF
ODT

Spreadsheets

XLSX
CSV
ODS

Presentations

PPT
PPTX

Other

EXE
MSI
APK
ISO
TTF
OTF
JSON
XML
YAML
SQL
ENV
LOG
MD

🏗️ Project Architecture

sortify/
│
├── .gitignore
├── README.md
├── HOW_IT_WORKS.md
├── DESIGN.md
├── LAYOUT.md
├── CONTRIBUTING.md
│
├── app.py
├── config.py
├── requirements.txt
│
├── database.db
├── settings.json
│
├── logs/
│   └── application.log
│
├── history/
│
├── assets/
│
├── core/
│   ├── models.py
│   ├── database.py
│   ├── settings.py
│   ├── utils.py
│   ├── organizer.py
│   ├── duplicates.py
│   ├── search.py
│   ├── watchdog_engine.py
│   └── plugins.py
│
└── ui/
    ├── main_window.py
    ├── sidebar.py
    ├── toolbar.py
    ├── theme.py
    ├── dashboard.py
    └── pages.py

🔐 Privacy

Sortify is designed with a local-first architecture.

Your files are not uploaded to a remote server.

The application performs:

File scanning locally
Searching locally
Duplicate detection locally
File organization locally
SQLite operations locally
Watchdog monitoring locally

No cloud account is required.

🤖 AI-Ready Architecture

The current core system does not require AI.

However, Sortify includes an extensible plugin architecture for future AI functionality.

Planned possibilities include:

🖼️ AI Image Classification
🔎 Semantic File Search
📄 OCR
🏷️ Automatic File Tagging
📝 AI File Naming
👤 Face-based Image Organization
📑 Document Classification
🧠 LLM-powered Organization Suggestions

These capabilities can be added as independent plugins without rewriting the core organizer.

🛠️ Development

Clone the repository:

git clone https://github.com/Prajapatidax/sortify.git
cd sortify

Create the virtual environment:

python -m venv venv

Activate it:

venv\Scripts\activate

Install dependencies:

pip install -r requirements.txt

Run:

python app.py

🧪 Testing

Run the test suite:

pytest

For verbose output:

pytest -v

🤝 Contributing

Contributions are welcome!

If you want to improve Sortify:

Fork the repository.
Create a new branch.
Make your changes.
Add or update tests.
Commit your changes.
Push your branch.
Create a Pull Request.

For detailed contribution guidelines, see:

CONTRIBUTING.md

📄 License

This project is open source. See the repository license for details.

👨‍💻 Developer

Dax Prajapati

Computer Engineering Student & Developer

🌐 Website: https://prajapatidax.co.in

💼 LinkedIn: https://www.linkedin.com/in/dax-prajapati1707

🐙 GitHub: https://github.com/Prajapatidax

📦 Sortify Repository: https://github.com/Prajapatidax/sortify

⭐ Support the Project

If you find Sortify useful, consider giving the repository a ⭐ on GitHub.

Your support helps the project grow and motivates further development.

Sortify

Organize everything. Automatically. 🗂️

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
core		core
ui		ui
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
DESIGN.md		DESIGN.md
HOW_IT_WORKS.md		HOW_IT_WORKS.md
LAYOUT.md		LAYOUT.md
README.md		README.md
app.py		app.py
config.py		config.py
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation