Metadata-Version: 2.3
Name: flm-file-organizer
Version: 0.1.0
Summary: A file organizer for your folder
Author: Francisco Mota
Author-email: franciscolmota@outlook.com
Requires-Python: >=3.13
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: questionary (>=2.1.0,<3.0.0)
Description-Content-Type: text/markdown

# 📂 File Organizer

A simple Python utility that organizes files in a selected folder into categorized subfolders based on their file extensions.  
It can also **reverse the organization** by moving files from subfolders back to the root folder — useful for testing or restoring the original state.

---

## ✨ Features
- Automatically categorizes files into folders like **Images**, **Documents**, **Videos**, **Audio**, **Applications**, and more.
- Lets you choose:
  - The **current script directory**.
  - Or any folder via a **folder selection dialog**.
- Detects if a folder has **no files** and offers to **rollback** (un-organize) the folder.
- Prevents overwriting by automatically renaming duplicate files during rollback.
- Supports multiple file types through a configurable mapping.

---

## 📂 Example Folder Structure

**Before**  

```
project/
├── cat.jpg
├── resume.pdf
├── music.mp3
```

**After**  
```
├── Images/
│ └── cat.jpg
├── Documents/
│ └── resume.pdf
├── Audio/
│ └── music.mp3
```


