-
Notifications
You must be signed in to change notification settings - Fork 6
PySorta ‐ The Pythonic Collaboration for EVERYONE
PySorta isn’t just a tool — it’s a movement.
We created this as a safe, welcoming project for those who’ve ever felt like they don’t belong in tech. Whether you're a beginner or just starting to learn collaboration tools like GitHub, you’re invited. This project is your chance to contribute confidently and gain real-world open-source experience.
💬 “I’ve never collaborated on a public project before — I’m learning by doing. Let’s learn together.”
PySorta is a lightweight Python utility that helps you clean up and organize folders based on:
- ✅ File Type (e.g., Images, Documents, Code)
- 📅 Date Modified
- 📏 File Size
It's perfect for decluttering your Downloads folder or managing a messy desktop. And yes — it even works on iOS using [Pythonista](http://omz-software.com/pythonista/).
- Build a simple command-line utility
- Add basic modes (type, date, size)
- Create project logo and branding
- Enable GitHub Discussions and Actions
- Build
index.htmlanddeepdive.htmlfor GitHub Pages
- Add drag-and-drop GUI (Tkinter or web)
- Add more intelligent file classification
- Translations for prompts
- Automate weekly folder cleanup
- Optional "undo" for organization
We welcome all contributions, big or small!
- 🔧 Fix a typo or spacing? Make a pull request.
- 🧠 Have a feature idea? [Open a feature request](https://github.com/theProject/pysorta/issues/new?template=feature_request.md)
- 🧵 Want to chat about ideas? [Join the Discussions](https://github.com/theProject/pysorta/discussions)
- 💬 Have feedback or questions? File an issue or reply in General Chat
📢 No PR is too small. Even changing one line teaches you something valuable.
📄 Be sure to read our [CONTRIBUTING.md](https://github.com/theProject/pysorta/blob/main/CONTRIBUTING.md) guide to get started.
We created a full walkthrough of how PySorta works — broken down and explained clearly with code and diagrams.
➡️ [Check out the Deep Dive](https://theproject.github.io/pysorta/deepdive.html)
If you believe in the mission and this tool helped you:
Please consider starring the repo. It means the world to us.
👉 [Star PySorta on GitHub](https://github.com/theProject/pysorta)
❤️ Built by [theProject.](https://bytheproject.com)
We’re building tools that teach everyone willing to jump in, mentors who can actively help others — and create communities that thrive.