Skip to content

whoismehfooz/file-organizer-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5 Commits
ย 
ย 
ย 
ย 

Repository files navigation

โš™๏ธ File Organizer CLI Tool

Turn chaos into order โ€” automatically organize your files with a single command.


๐Ÿš€ Overview

This is a Python-based CLI automation tool that scans a directory and organizes files into structured folders based on their type.

Instead of manually sorting files, this tool does it instantly and efficiently.


โœจ Features

โœ” Automatically detects file types โœ” Creates folders dynamically (Images, Documents, etc.) โœ” Moves files into appropriate directories โœ” Skips system files and folders safely โœ” Clean and scalable logic using Python


๐Ÿง  How It Works

The script:

  1. Scans all files in the current directory
  2. Identifies file extensions
  3. Matches them with predefined categories
  4. Creates folders if they donโ€™t exist
  5. Moves files into their respective folders

๐Ÿ“‚ Supported Categories

Category File Types
๐Ÿ“ธ Images .jpg, .png, .jpeg
๐Ÿ“„ Documents .pdf, .txt, .md
๐ŸŽฌ Videos .mp4
๐ŸŽง Audio .mp3
๐Ÿ“ฆ Others Everything else

๐Ÿ› ๏ธ Tech Stack

  • ๐Ÿ Python
  • ๐Ÿ“ os module (file handling & automation)

๐Ÿ–ฅ๏ธ Example

Before:

main.py
file.pdf
photo.jpg
song.mp3
notes.txt

After running the script:

Images/
  photo.jpg

Documents/
  file.pdf
  notes.txt

Audio/
  song.mp3

main.py

โšก How to Run

python main.py

Make sure your files are in the same directory as the script.


๐Ÿงช What I Learned

  • Working with the os module
  • Handling file systems in Python
  • Writing clean and scalable logic
  • Building real-world automation tools
  • Managing projects using Git & GitHub

๐Ÿ”ฎ Future Improvements

  • Accept custom directory paths (user input)
  • Add logging system for file movements
  • Build interactive CLI interface
  • Develop GUI version (Tkinter / Web UI)

๐Ÿ‘จโ€๐Ÿ’ป Author

Built by Mehfooz Aspiring backend developer focused on real-world problem solving and automation.


โญ Final Note

This project reflects a shift from learning syntax โ†’ building solutions.

If you found this useful or interesting, consider giving it a โญ

About

๐Ÿ‘‰ A Python CLI tool that automatically organizes files into folders based on their type.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages