Skip to main content

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:

  1. Scan the ~/Documents folder.
  2. Create subfolders like Images/, Documents/, Audio/, etc.
  3. 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

  1. Clone or download the script.
  2. Place main.py in your desired directory.
  3. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyorganize-1.0.0.tar.gz (15.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyorganize-1.0.0-py3-none-any.whl (15.9 kB view details)

Uploaded Python 3

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

Hashes for pyorganize-1.0.0.tar.gz
Algorithm Hash digest
SHA256 37327142ed3269af6afce5f54315f85389899c7b5e0a49dfa9a776d6eaab71ba
MD5 cbe633e5a0b6a6e32444ac369a7a306a
BLAKE2b-256 ed5e09426280248847802f3da8bb8b31f6e470a7a632aab2bab3036189dd4a6d

See more details on using hashes here.

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

Hashes for pyorganize-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 afcb517762eff99d8cb1e5ae80dee9648cf9d9e1ac1cb2ff5ce5af62a4f0e3d2
MD5 1ef0ea6daedf929d89c435d5c2185fe7
BLAKE2b-256 9d7e3907bbef87744cfbf844e41d6d61e3d91175a10228f79c52b9e5d260ca72

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page