📂 File Organizer

---

Organize your files automatically and efficiently – from basic sorting to advanced rules, undo, and logging.

---

Table of Contents

Click to expand

1. Introduction
2. Versions & Features
   • v1 - Basic
   • v2.1 - Pro
   • v3 - Ultimate Pro
3. Architecture & Diagrams
   • System Architecture
   • Flow Diagram
   • ER Diagram
4. Use Cases
5. Pros and Cons
6. Installation
7. Contribution
8. Support
9. License

---

Introduction

File Organizer is a Python-based GUI application for automatically organizing files on your system. It evolves from a basic sorter to a professional, feature-rich mini file manager.

Features include category sorting, recursive folder organization, file preview, selective moves, undo functionality, drag-and-drop support, and advanced rules based on date, size, and more.

---

Versions & Features

v1 - Basic

Click to expand

Description:
The first version of File Organizer allows users to select a folder and automatically sort files by predefined categories: Images, Docs, Videos, Audio, and Code.

Key Features:

• Select folder via GUI
• Sort files into predefined categories
• Recursive support not included
• Status updates

Pros:

• Simple and lightweight
• Easy to use

Cons:

• No undo functionality
• Cannot customize categories or extensions
• No progress feedback

Real-Life Example:
Organize your "Downloads" folder into Images, Documents, and Videos in one click.

---

v2.1 - Pro

Click to expand

Description:
The Pro version introduces multi-level undo, file preview, selective move, recursive sorting, and customizable categories. Now users can have more control over organization.

Key Features:

• Multi-level undo
• File preview and selective move
• Drag-and-drop folder selection
• Recursive folder sorting
• Customizable categories and extensions
• Progress bar and status updates

Pros:

• More control and safety
• Flexible customization
• Suitable for large directories

Cons:

• Slightly heavier than v1
• Requires GUI familiarity

Real-Life Example:
Sort a project folder while previewing which files to move, and undo if needed.

---

v3 - Ultimate Pro

Click to expand

Description:
Ultimate Pro adds advanced rules, filtering, permanent logs, and dark/light theme support. It is ideal for professional use.

Key Features:

• Organize files by category, date, or size
• Search/filter files by extension or modification date
• Multi-level undo
• File preview & selective move
• Dark/light theme toggle
• Drag-and-drop folder selection
• Permanent logging of all file moves
• Progress bar and status updates

Pros:

• Powerful professional organizer
• Flexible rules and filters
• Persistent logs for tracking
• User-friendly GUI

Cons:

• Heavier than previous versions
• Requires Python and dependencies installed

Real-Life Example:
Organize thousands of downloaded files into date-based folders while keeping a log for reference.

---

Architecture & Diagrams

Click to expand

Architecture Overview

+--------------------+
|  File Organizer GUI|
|  (Tkinter)         |
+---------+----------+
          |
          v
+--------------------+
| File Handling      |
| - Sorting          |
| - Moving           |
| - Undo             |
+---------+----------+
          |
          v
+--------------------+
| Logging & Rules    |
| - Category rules   |
| - Date/Size rules  |
| - Persistent logs  |
+--------------------+

Components:

• GUI (Tkinter): User interaction, previews, folder selection
• File Handler: Sorting, moving, undo operations
• Rules Engine: Category, date, size rules
• Logger: Persistent log file of moves and undo actions

---

Flow Diagram

User selects folder
        |
        v
 Preview files in GUI
        |
        v
 User selects files & rule
        |
        v
 Move files to target folders
        |
        v
 Update progress bar & log
        |
        v
 Option to Undo

Flow:

1. User selects folder
2. Preview files
3. Apply rule (category/date/size)
4. Move files
5. Update progress & log
6. Optional undo

---

ER Diagram

+----------------+        +----------------+        +----------------+
|    Category    |        |      File      |        |    Move Log    |
+----------------+        +----------------+        +----------------+
| - name         |<------>| - name         |<------>| - file_path    |
| - extensions[] |        | - path         |        | - destination  |
+----------------+        | - type         |        | - timestamp    |
                          | - size         |        | - action       |
                          | - mod_date     |        +----------------+
                          +----------------+

Entities:

• File: Attributes: name, path, type, size, modification date
• Category: Attributes: name, extensions
• Move Log: Attributes: file path, destination, timestamp, action

---

Use Cases

• Organizing Downloads or Desktop folders
• Sorting project files into code, docs, and media
• Creating date-based archives
• Filtering large media libraries
• Maintaining clean and structured storage

---

Pros and Cons

Version	Pros	Cons
v1 - Basic	Simple, lightweight	No undo, no custom categories
v2.1 - Pro	Undo, preview, selective move, customizable	Slightly heavier, GUI required
v3 - Ultimate Pro	Advanced rules, logs, dark/light theme	Heavier, requires Python & libs

---

Installation

git clone https://github.com/alok-kumar8765/file-manager.git
cd file-manager
pip install -r requirements.txt  # if needed
python file_organizer_v3.py

---

Contribution

We welcome contributions!

1. Fork the repository
2. Create your branch (git checkout -b feature-name)
3. Commit your changes (git commit -am 'Add feature')
4. Push to the branch (git push origin feature-name)
5. Open a Pull Request

---

Support

For support, contact alok.kaushal42@gmail.com or open an issue on GitHub.

---

Star & Fork

⭐ If you like this project, give it a star! 🍴 Fork it to customize and extend functionality.

---

License

MIT License © 2025

This project is licensed under the **MIT License**.

---