An open API service indexing awesome lists of open source software.

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.

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


AutoSortify GUI Screenshot

---

## ๐Ÿ“Œ 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