❔ PySorta is an open-source Python tool to automatically organize your folders by file type, date modified, or size — built for desktop and iOS (Pythonista). Clean up your Downloads with one command. I know when I get on an asset bender it can get silly! Contributions welcome and encouraged, this small tool can be built even bigger and cooler - we are looking for those learning or developing past imposter syndrome, to give an introduction to collaboration on GitHub. ⭐Mentors - we'd appreciate ypur support on this journey, and would love your support with reviews, issues, feedback, PR's = and join us in helping others how to collaborate like pros on GitHub.
- Open Visual Studio Code
- Open the Command Palette (
Ctrl+Shift+PorCmd+Shift+Pon macOS) - Type and select: Git: Clone
- Paste the repo URL:
https://github.com/your-username/pysorta.git
- Choose a folder to save the project
- Open the folder when prompted
Keep your folders tidy and organized with this lightweight Python script that automatically sorts files into subfolders based on:
- ✅ File Type (e.g., Images, Documents, Code, etc.)
- 📅 Date Modified (YYYY-MM folders)
- 📏 File Size (Small / Medium / Large)
Great for Downloads, Desktop folders, or managing cluttered project directories!
- Interactive command-line interface
- Organize files by:
- File type
- Date modified
- File size
- Customizable file category mapping
- Works on macOS, Windows, Linux, and even iOS/iPadOS (via Pythonista)
- Zero dependencies — pure Python!
- Fully Open Source
- Python 3.x
- Optional: Pythonista app for iOS/iPadOS. Link to the App Store at the bottom of this ReadMe.
python pysorta.pyThen follow the interactive prompts:
• Choose a folder (or leave blank for current)
• Select how you’d like to organize: by type, date, or size
⸻
1. Download pysorta.py and place in an on-device foldere you know for Pythonista
2. Open the script in [Pythonista](http://omz-software.com/pythonista/)
3. Tap ▶️ Play
4. Enter a path like . or full iOS-accessible folder path
5. Choose your sorting method
✅ Tip: You can hardcode a path in the script if needed, e.g.
directory = Path("/private/...")).FILE_CATEGORIES = {
"Images": [".jpg", ".jpeg", ".png"],
"Documents": [".pdf", ".docx", ".txt"],
"3D Models": [".obj", ".glb", ".fbx"]
}The script will auto-create folders and move matching files into them.
/Downloads
├── Images
│ └── selfie.png
├── Documents
│ └── resume.pdf
├── Code
│ └── tool.py/Downloads
├── 2024-12
│ └── invoice.pdf
├── 2025-06
│ └── demo.movPySorta (short for “Python Sorta Everything”) is a friendly, flexible script to clean up digital messes. Whether you’re decluttering a Downloads folder or sorting design assets, PySorta helps you do it cleanly and effortlessly. But it's also an invitation to the world of folks who are new to this, and want to be a part of it - hack away my friends!
This project is open to the world — whether you’re learning Python, part of our NO IMPOSTER movement (everyone is welcome to contribute and valued) or improving tooling for creators. You’re invited to: • Add new organization modes • Improve cross-platform behavior • Refactor for performance • Build a GUI (Tkinter, web, or iOS-native) • Translate prompts into other languages
Pull requests and feedback are warmly welcomed, the goal is for all to use proper features of GitHub, and gain the coding discipline through the use of branches. 💬
There is so so much more we can do with this - ensure you check out our guide on Contributing here: CONTRIBUTING.md
This project is licensed under the MIT License.
See CONTRIBUTING.md for how to get involved.
You are free to use, modify, distribute, and build on this project — commercially or privately.
Please keep the original author attribution if redistributing. If you're new to this, please read both links!
This was built as a small but powerful utility by theProject. If it helped you, taught you something, or made your life easier — that means everything. Go build cool things. 🌍. If you feel compelled, please consider joining ouir cause and sonsoring when it becomes available, or simply giving us a star (we've never got one yet!) It's all about growing ourselves and aiming to share that confidence and fortitude with others, welcoming a vast community that might not feel good enough to be here when they truly are.
Forget the degrees. We are theProject., the relentless misfits who learned by hacking code apart memorizing new PASCAL or QBASIC functions in Barnes and Nobles while our mother's shopped. We had to learni through trial and error — the hard way, and not a reccomended way - as we just haven't built the core principles of software development team work. I have relentlessly been fueled by a burning desire for design, innovation, and access to the deep secrets of the tech frontier.
Far too many great minds lurk in the shadows, feeling like they don’t belong — like they’re missing some secret everyone else figured out. The misfits, the imposters. We at theProject. embrace you.
We aim to collaborate with any skillset, use real teamwork, and offer real-world support you can’t find in a textbook or YouTube video. No classes behind a paywall here!
We don’t just create; we defy expectations, we build those killer apps we all wanted to - but never had an artist or an engineer. Make it stop.
We embrace AI as a tool, not a substitute — and prepare the lost for the new frontier. Man-kind didn't turn down the smart phone - trust we need to learn to use tools, not depend on them. We got you.
I look forward to working with you.
If you have questions, feature requests, or just want to say hi — feel free to reach out: