📁 Desktop-AI-Organizer — A powerful Windows desktop app that analyzes, organizes, and manages your desktop files with AI-powered categorization, duplicate detection, and smart cleanup
A powerful Windows desktop app that analyzes, organizes, and manages your desktop files with AI-powered categorization, duplicate detection, and smart cleanup.
- Features
- How It Works
- Tech Stack
- Installation
- Configuration
- Usage Guide
- Screenshots
- Roadmap
- FAQ
- Troubleshooting
- Contributing
- License
- ✔ AI Categorization — Automatically sorts files by type, content, and context
- ✔ Duplicate Detection — Finds exact and near-duplicate files using content hashing
- ✔ Smart Cleanup — Identifies temp files, caches, and unused items older than N days
- ✔ Rules Engine — User-defined rules: move, copy, delete, archive based on patterns
- ✔ Visual Dashboard — Pie charts, storage trends, and category breakdowns
- ✔ Undo System — Full undo/redo for all organize operations
- ✔ Scheduling — Auto-run on schedule (daily/weekly/monthly)
Input ──► Processing Pipeline ──► Output
┌────────┐ ┌────────┐ ┌────────┐
│ Data │──►│ Engine │──►│ Result │
│ Source │ │ Logic │ │ │
└────────┘ └────────┘ └────────┘
- Input — Load data from file, API, or user input
- Process — Core engine applies logic/analysis/transformation
- Output — Results displayed in UI, saved to file, or sent via API
| Component | Technology |
|---|---|
| Language | Python 3.10+ |
| UI | CustomTkinter |
| AI | OpenAI / local classifier |
| Database | SQLite |
| Platform | Windows |
git clone https://github.com/zougar99/Desktop-AI-Organizer.git
cd Desktop-AI-Organizer
pip install -r requirements.txtCreate a config.yaml or .env file in the project root:
# Application settings
debug: false
port: 8080
theme: dark
language: en- Launch:
python main.py - Select the folder(s) to organize
- Choose AI mode or manual rules
- Preview changes before applying
- Click Apply or schedule for later
(Screenshots coming soon. PRs welcome!)
- 🟢 Web dashboard
- 🟡 Mobile companion app
- ⚫ API access
- ⚫ Plugin system
- ⚫ Multi-language support
No — all changes require your confirmation. Preview first.
Yes — any accessible drive or folder is supported.
| Problem | Solution |
|---|---|
| App won't start | Check Python version (3.10+); run pip install -r requirements.txt |
| No output | Check logs in logs/ folder; enable debug mode in config |
| Performance issues | Close other applications; reduce batch size in config |
| Dependency errors | Create fresh venv: python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt |
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push (
git push origin feature/amazing-feature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Made with ❤️ by zougar99