https://github.com/quantumcoderrr/autosortify
๐ Smart File Organizer with GUI and CLI. Categorizes, logs, and sorts your digital mess in style. Features dry-run, real-time progress, theme toggle, logging, summary reports, and more. Built with Python, Tkinter & TQDM.
https://github.com/quantumcoderrr/autosortify
automation desktop-app file-organizer filesystem gui-application open-source python python-script
Last synced: 10 months ago
JSON representation
๐ Smart File Organizer with GUI and CLI. Categorizes, logs, and sorts your digital mess in style. Features dry-run, real-time progress, theme toggle, logging, summary reports, and more. Built with Python, Tkinter & TQDM.
- Host: GitHub
- URL: https://github.com/quantumcoderrr/autosortify
- Owner: QuantumCoderrr
- License: mit
- Created: 2025-04-15T14:02:46.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-04-15T15:18:52.000Z (10 months ago)
- Last Synced: 2025-04-15T15:32:48.731Z (10 months ago)
- Topics: automation, desktop-app, file-organizer, filesystem, gui-application, open-source, python, python-script
- Language: Python
- Homepage:
- Size: 9.77 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AutoSortify ๐
**AutoSortify** is a smart file organizer with both CLI and GUI support. It organizes your digital mess into categorized folders with detailed logs, real-time progress bars, dry-run preview, and dark mode GUI โ all wrapped in one sleek Python project.
## ๐ฅ Features
- ๐ Categorizes files by extension into folders like Documents, Images, Videos, etc.
- ๐๏ธ GUI built with Tkinter (with Dark/Light mode toggle)
- ๐ป CLI mode with flags for dry-run and copy
- ๐ Real-time progress bar with `tqdm`
- ๐ชต Full logging support
- ๐งพ Generates a detailed summary report
- ๐ Handles filename conflicts safely
- โฒ๏ธ Cron & Task Scheduler compatible
- ๐งช Dry run mode to preview changes
- ๐พ Log and summary saved in `~/AutoSortify/`
---
## ๐ฆ File Categories
| Category | Extensions |
|--------------|---------------------------------------------------|
| Documents | `.pdf`, `.docx`, `.txt`, `.xlsx`, `.pptx` |
| Images | `.jpg`, `.jpeg`, `.png`, `.svg`, `.gif` |
| Videos | `.mp4`, `.mkv`, `.avi`, `.mov` |
| Music | `.mp3`, `.wav`, `.aac` |
| Code | `.py`, `.cpp`, `.java`, `.js`, `.html`, `.css` |
| Archives | `.zip`, `.rar`, `.7z`, `.tar` |
| Executables | `.exe`, `.msi`, `.apk` |
| Others | Everything else |
---
## ๐ง How It Works
AutoSortify scans the specified folder, detects file types based on extension, and moves them into clean, categorized subfolders like:
---
## ๐ผ๏ธ GUI Preview
---
## ๐ Usage
### 1. Clone the repo
```bash
git clone https://github.com/your-username/AutoSortify.git
cd AutoSortify
```
### 2. Run the script
```bash
python main.py /path/to/your/folder
```
---
## ๐
Setup Scheduled Run (Optional)
### Windows Task Scheduler:
- Open Task Scheduler โ Create Basic Task
- Trigger: Daily/Weekly
- Action: Start a Program โ python path_to_main.py "C:/Your/Folder"
---
## ๐ Logs
- Logs are saved in: ~/AutoSortify/autosortify.log
- Summary is saved as: ~/AutoSortify/summary.txt