A simple file organizer that sorts files into folders by type.
Project description
PyOrganize
PyOrganize is a simple Python script that automatically organizes files in a specified directory into subfolders based on their file types. Keep your directories clean and structured with minimal effort!
🗂️ What It Does
PyOrganize scans a given directory and organizes files into categorized subfolders based on their extensions:
| Category | Example Extensions |
|---|---|
| Images | .jpg, .png, .gif, .svg |
| Documents | .pdf, .docx, .txt, .csv |
| Audio | .mp3, .wav, .flac |
| Video | .mp4, .mkv, .mov |
| Archives | .zip, .tar, .gz, .rar |
| Scripts | .py, .sh, .js, .php |
| Code | .html, .css, .json, .yaml |
| Other | Any file type not categorized |
💡 Example Usage
Run the script to organize your folder:
python3 main.py ~/Documents
This command will:
- Scan the
~/Documentsfolder. - Create subfolders like
Images/,Documents/,Audio/, etc. - Move each file to its corresponding category folder.
Output Example:
📂 Organizing folder: /home/user/Documents
➜ report.pdf → Documents/
➜ holiday.png → Images/
➜ notes.txt → Documents/
✅ Done organizing!
🧩 Requirements
- Python 3.6+
- No external libraries required — PyOrganize works out of the box!
🧠 Notes
- Supports absolute, relative, or home (~) paths.
- Compatible with Linux, macOS, and Windows.
- Optionally, make the script executable for convenience:
chmod +x main.py ./main.py ~/Downloads
🚀 Getting Started
- Clone or download the script.
- Place
main.pyin your desired directory. - Run the script with a target folder:
python3 main.py /path/to/your/folder ``
Or direct:
git clone https://github.com/ramackersjp/PyOrganize.git
cd ~/PyOrganize
chmod +x main.py
Arch install:
yay -S pyorganize
Usage on arch command: pyorganize ~/Pictures
Keep your files tidy with PyOrganize 🎉
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pyorganize-1.0.0.tar.gz.
File metadata
- Download URL: pyorganize-1.0.0.tar.gz
- Upload date:
- Size: 15.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
37327142ed3269af6afce5f54315f85389899c7b5e0a49dfa9a776d6eaab71ba
|
|
| MD5 |
cbe633e5a0b6a6e32444ac369a7a306a
|
|
| BLAKE2b-256 |
ed5e09426280248847802f3da8bb8b31f6e470a7a632aab2bab3036189dd4a6d
|
File details
Details for the file pyorganize-1.0.0-py3-none-any.whl.
File metadata
- Download URL: pyorganize-1.0.0-py3-none-any.whl
- Upload date:
- Size: 15.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
afcb517762eff99d8cb1e5ae80dee9648cf9d9e1ac1cb2ff5ce5af62a4f0e3d2
|
|
| MD5 |
1ef0ea6daedf929d89c435d5c2185fe7
|
|
| BLAKE2b-256 |
9d7e3907bbef87744cfbf844e41d6d61e3d91175a10228f79c52b9e5d260ca72
|