From cd6394b971789003658a9d3867abf55bd9d516b0 Mon Sep 17 00:00:00 2001 From: UnKnown4656 <149686607+UnKnown-4656@users.noreply.github.com> Date: Sun, 29 Mar 2026 11:39:12 +0530 Subject: [PATCH 1/4] Clean up log.txt by removing duplicates Removed duplicate entries and cleaned up log. --- log.txt | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/log.txt b/log.txt index 668b508..8b13789 100644 --- a/log.txt +++ b/log.txt @@ -1,6 +1 @@ ---BREAK-- -C:\Users\user\Desktop\PC Advisor\main.py->C:\Users\user\Desktop\PC Advisor\code\main.py -C:\Users\user\Desktop\PC Advisor\NVIDIA Corporation (NVDA) Stock Historical Prices & Data - Yahoo Finance.html->C:\Users\user\Desktop\PC Advisor\code\NVIDIA Corporation (NVDA) Stock Historical Prices & Data - Yahoo Finance.html ---BREAK-- -C:\Users\user\Desktop\PC Advisor\main.py->C:\Users\user\Desktop\PC Advisor\code\main.py -C:\Users\user\Desktop\PC Advisor\NVIDIA Corporation (NVDA) Stock Historical Prices & Data - Yahoo Finance.html->C:\Users\user\Desktop\PC Advisor\code\NVIDIA Corporation (NVDA) Stock Historical Prices & Data - Yahoo Finance.html + From 799d7da35e16c30d2f9fb6429dce27af791b23fe Mon Sep 17 00:00:00 2001 From: UnKnown4656 <149686607+UnKnown-4656@users.noreply.github.com> Date: Sun, 29 Mar 2026 11:39:31 +0530 Subject: [PATCH 2/4] Clean up notes.txt by removing comments Removed commented-out code and notes from notes.txt. --- notes.txt | 44 -------------------------------------------- 1 file changed, 44 deletions(-) diff --git a/notes.txt b/notes.txt index 69a4554..8b13789 100644 --- a/notes.txt +++ b/notes.txt @@ -1,45 +1 @@ -#print(files) its Working gave me list of files i have - #mapping generated from claude ai - #if ".xyz" in ext_map: i tried it by adding a new file in desktop named test.xyz it created new folder named xyz and placed file there but when i checked dictionary there is no key name .xyz - # print("Key exists")# fully tested and debugged working fine - #loop to organize files - #check it is file or folder and skips folders - #its still complex using os splits the dictionary and fisnd the file using exstintion its like i have dictonary like {"image":".jpeg"} it take index 1 of that means ".jpeg" - #uses to unknow type of files to add them with help of ai - #returns {".xyz":"others"} like something - #separate the both as k (exstintion) v (file_name) - #add to exsisting dict - #logging important to debugging - # get new file name and send to next process i mean it will see if folder exisist or create new one - #it means folder path i mean c:\\user\\image(created itself or uses exisisting) - ###Works But Slow while using loop - #for folder_name,extension in file_types.items(): - # if file.lower().endswith(tuple(extension)): - # destination_path = os.path.join(folder_path, folder_name) - # if not os.path.exists(destination_path): - # os.mkdir(destination_path) - # final_destination_path = os.path.join(destination_path, file) - # shutil.move(source_path, final_destination_path) -# - # moved=True - # break - -#Understanding 'for' loop to dictionary -#dictonary={ -# "NAME":"Test", -# "age":20 -#} -# -## -# -#for k,v in dictonary.items(): -# print(k) -# print(v) - - - - - - - From afa58b628b5ef9c7629a09990f3be4135a5abac4 Mon Sep 17 00:00:00 2001 From: UnKnown4656 <149686607+UnKnown-4656@users.noreply.github.com> Date: Sun, 29 Mar 2026 11:43:14 +0530 Subject: [PATCH 3/4] Revise README for improved structure and content Updated README to enhance clarity and organization. --- README.md | 205 ++++++++++++++++++------------------------------------ 1 file changed, 66 insertions(+), 139 deletions(-) diff --git a/README.md b/README.md index 757210f..374f29c 100644 --- a/README.md +++ b/README.md @@ -1,208 +1,135 @@ -# 🗂ī¸ FileOrganizer +# 📁 FileOrganizer -![Python](https://img.shields.io/badge/Python-100%25-blue?logo=python&logoColor=white) -![License](https://img.shields.io/badge/License-MIT-green) -![Status](https://img.shields.io/badge/Status-Active-brightgreen) -![LLM](https://img.shields.io/badge/LLM-Groq-orange) - -> A fast and lightweight Python CLI tool that automatically organizes your messy folders by sorting files into categorized subfolders based on their extension — with **AI-powered handling for unknown file types**. +A smart Python-based file organizer that automatically sorts files into folders based on their extensions. Includes AI-powered handling for unknown file types and an undo system to revert changes. --- -## 📋 Table of Contents +## 🚀 Features -- [Features](#-features) -- [What's New](#-whats-new) -- [Installation](#-installation) -- [Usage](#-usage) -- [How It Works](#-how-it-works) -- [Supported File Types](#-supported-file-types) -- [AI Support](#-ai-support-for-unknown-extensions) -- [Logging](#-logging) -- [Project Structure](#-project-structure) -- [Contributing](#-contributing) -- [Author](#-author) +* 📂 Organizes files by extension (e.g., `.jpg → Images/`) +* 🤖 AI-powered detection for unknown file types (via Groq API) +* 📝 Logs all file movements (`log.txt`) +* 🔄 Undo last operation using log history +* ⚠ī¸ Handles duplicate file names safely +* đŸ“Ļ JSON-based extension mapping (`data.json`) --- -## ✨ Features +## 🛠ī¸ Tech Stack -- 📁 **Auto Categorization** — Sorts files into folders by type (images, code, documents, etc.) -- 🔁 **Duplicate File Handling** — Renames duplicates safely without overwriting anything -- 📂 **Auto Folder Creation** — Creates category folders automatically if they don't exist -- 🤖 **AI-Powered Unknown Extensions** — Uses Groq LLM to decide the best folder for unrecognized file types and remembers them for next time -- ↩ī¸ **Undo Support** — Reverse the last organize operation with a single flag -- 📝 **Logging** — Every file move is recorded in `log.txt` for full transparency -- ⚡ **Fast & Lightweight** — Pure Python, minimal dependencies +* Python +* OS & Shutil (file handling) +* JSON (data storage) +* Groq API (AI classification) --- -## 🆕 What's New - -### v1.2 — Undo Support *(Latest)* -- New `--undo` flag to reverse the last organize operation -- All file moves are logged in `source->destination` format for accurate reversal -- Safely skips malformed or empty log lines - -### v1.1 — AI Support for Unknown Extensions -- Unknown file extensions are now handled by **Groq LLM** — it decides the best folder name -- New extension-to-folder mappings are **saved back to `data.json`** automatically so the AI is only called once per extension -- Improved logging captures AI-assisted decisions separately +## đŸ“Ļ Project Structure -### v1.0 — Initial Release -- Core file organization by extension -- Auto folder creation -- Duplicate file safety with rename logic -- Basic logging +``` +FileOrganizer/ +│ +├── main.py # Main execution script +├── utilities.py # Helper functions +├── data.json # Extension → Folder mapping +├── log.txt # Operation logs +├── requirements.txt # Dependencies +└── README.md +``` --- -## 🚀 Installation - -### Prerequisites -- Python 3.8+ -- A [Groq API key](https://console.groq.com) (free) +## ⚙ī¸ Installation -### Clone the Repository +1. Clone the repository: ```bash -git clone https://github.com/UnKnown-4656/FileOrganizer.git +git clone https://github.com/your-username/FileOrganizer.git cd FileOrganizer ``` -### Install Dependencies +2. Install dependencies: ```bash pip install -r requirements.txt ``` -### Set Your API Key - -On Windows (PowerShell): -```powershell -$env:GROQ_API_KEY="your_key_here" -``` +3. Set your API key (for AI feature): -On Mac/Linux: ```bash -export GROQ_API_KEY="your_key_here" +set GROQ_API_KEY=your_api_key # Windows +export GROQ_API_KEY=your_api_key # Linux/Mac ``` --- -## 🛠ī¸ Usage +## â–ļī¸ Usage -```bash -python main.py -``` - -**Organize:** -```bash -python main.py C:\Users\user\Desktop\MessyFolder -``` +### Organize Files -**Undo last organize:** ```bash -python main.py C:\Users\user\Desktop\MessyFolder --undo +python main.py "C:\Your\Folder\Path" ``` ---- - -## ⚙ī¸ How It Works +### Undo Last Operation +```bash +python main.py "C:\Your\Folder\Path" --undo ``` -📁 Messy Folder -├── photo.jpg → 📁 images/ -├── report.pdf → 📁 documents/ -├── script.py → 📁 code/ -├── song.mp3 → 📁 music/ -└── unknown.xyz → 🤖 Groq decides → 📁 misc/ -``` - -1. Scans all files in the target folder (top level) -2. Looks up each file extension in `data.json` -3. If extension is unknown → asks Groq LLM for the best folder name → saves it to `data.json` -4. Creates destination folder if it doesn't exist -5. Moves the file safely, renaming if a duplicate exists -6. Logs every action to `log.txt` -7. Run with `--undo` to reverse all moves from the log --- -## 📂 Supported File Types +## 🧠 How It Works -Built-in mappings are stored in `data.json`. Default categories include: +1. Reads all files in the given directory +2. Checks extension from `data.json` +3. If unknown: -| Category | Extensions | -|------------|-------------------------------------------------------------| -| Images | `.jpg`, `.jpeg`, `.png`, `.gif`, `.bmp`, `.svg`, `.webp` | -| Videos | `.mp4`, `.mkv`, `.avi`, `.mov`, `.wmv`, `.flv` | -| Music | `.mp3`, `.wav`, `.flac`, `.aac`, `.ogg` | -| Documents | `.pdf`, `.docx`, `.doc`, `.txt`, `.xlsx`, `.pptx` | -| Archives | `.zip`, `.rar`, `.tar`, `.gz`, `.7z` | -| Code | `.py`, `.js`, `.html`, `.css`, `.java`, `.cpp`, `.cs` | -| Unknown | Anything else → **handled by Groq AI** 🤖 | + * Calls AI model to suggest folder name + * Updates `data.json` automatically +4. Moves file to corresponding folder +5. Logs every move for undo functionality --- -## 🤖 AI Support for Unknown Extensions - -When FileOrganizer encounters a file with an unrecognized extension, it sends the extension to **Groq's LLM** which returns an appropriate folder name. - -That mapping is then **saved permanently to `data.json`** — so the next time the same extension appears, no API call is needed. +## 🔁 Undo System -``` -Unknown extension: .blend -Groq response: { "extension": ".blend", "folder_name": "design_files" } -Saved to data.json ✓ -``` - -> Requires a valid `GROQ_API_KEY` environment variable. +* Uses `log.txt` to track operations +* `--undo` restores files to original location +* Automatically removes empty folders --- -## 📝 Logging - -All operations are recorded in `log.txt`: +## ⚠ī¸ Notes -``` -C:\Desktop\MessyFolder\photo.jpg->C:\Desktop\MessyFolder\images\photo.jpg -C:\Desktop\MessyFolder\report.pdf->C:\Desktop\MessyFolder\documents\report.pdf -``` - -Each line follows `source->destination` format, used by the `--undo` flag to reverse moves. +* Ensure `data.json` exists and is valid JSON +* AI feature requires internet + API key +* Works best on non-system directories --- -## 📁 Project Structure +## 💡 Future Improvements -``` -FileOrganizer/ -├── main.py # Core logic — scanning, organizing, moving files -├── utilities.py # Helper functions — AI lookup, duplicate renaming -├── data.json # Extension-to-folder mappings (auto-updated) -├── log.txt # Auto-generated operation log -├── requirements.txt # Dependencies -└── README.md # You are here -``` +* GUI version (Tkinter / Web UI) +* Batch undo support +* File preview before organizing +* Configurable rules +* Performance optimization for large folders --- ## 🤝 Contributing -1. Fork the repository -2. Create a new branch: `git checkout -b feature/your-feature` -3. Commit your changes: `git commit -m "Add your feature"` -4. Push and open a Pull Request +Feel free to fork and improve this project! --- -## 👨‍đŸ’ģ Author +## 📜 License -**UnKnown** — [@UnKnown-4656](https://github.com/UnKnown-4656) - -> Built with ❤ī¸ — because no one should manually sort their Downloads folder. +MIT License (recommended) --- -*⭐ If this helped you, drop a star on GitHub!* \ No newline at end of file +## đŸ”Ĩ Author + +Unknown-4656 From a8c4187a21127be747b0aa85bee17069e145acb3 Mon Sep 17 00:00:00 2001 From: UnKnown4656 <149686607+UnKnown-4656@users.noreply.github.com> Date: Sun, 29 Mar 2026 11:45:42 +0530 Subject: [PATCH 4/4] Fix formatting of License section in README --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 374f29c..0381907 100644 --- a/README.md +++ b/README.md @@ -126,7 +126,7 @@ Feel free to fork and improve this project! ## 📜 License -MIT License (recommended) +MIT License ---