File Organizer

A Python CLI tool that automatically organizes messy folders by sorting files into categorized subfolders based on their extension.

Before & After

Before:

Downloads/
├── photo.jpg
├── resume.pdf
├── song.mp3
├── movie.mp4
├── data.json
├── app.dmg

After:

Downloads/
├── Img/        (jpg, jpeg, png, webp)
├── Doc/        (pdf, docx, xlsx, txt, mermaid)
├── Vid/        (mov, mp4)
├── Zip/        (zip, dmg)
├── JSON/       (json)

How to Use

1. Clone the repo:

git clone https://github.com/Pinkisingh13/file-organizer.git
cd file-organizer

2. Install dependencies (requires uv):

uv sync

3. Edit the path in main.py to your target folder:

organizeme("/path/to/your/messy/folder")

4. Run:

uv run main.py

Features

• Sorts files into categorized folders by extension
• Skips directories (only moves files)
• Skips files that already exist in the destination
• Prints a summary of moved and skipped files

Supported File Types

Folder	Extensions
Img	.jpg, .jpeg, .png, .webp
Doc	.pdf, .docx, .xlsx, .txt, .mermaid
Vid	.mov, .mp4
Zip	.zip, .dmg
JSON	.json

Tech

• Python 3.12
• pathlib for path handling
• shutil for moving files

License

MIT