OrganiserPro 0.1.0

A powerful file organization tool

OrganiserPro

OrganiserPro is a powerful, cross-platform command-line tool for sorting, deduplicating, and managing your files with ease. Keep your files tidy—sort, organize, and eliminate clutter in seconds.

---

✨ Features

• Smart File Sorting

  • Sort files by type (extension)
  • Organize by modification or creation date
  • Customizable date formats
  • Dry-run mode to preview changes

• Duplicate Detection

  • Find duplicate files by content
  • Remove or move duplicates automatically
  • Recursive directory scanning

• User-Friendly

  • Beautiful terminal output powered by rich
  • Progress bars for long operations
  • Clear error messages and comprehensive help system

---

🚀 Installation

Prerequisites:

• Python 3.7 or higher
• pip (Python package manager)

The recommended way to install OrganiserPro is in a virtual environment.

# Create and activate a virtual environment (recommended)
python3 -m venv organiserpro-env
source organiserpro-env/bin/activate  # On Windows use: organiserpro-env\Scripts\activate

# Install OrganiserPro from PyPI
pip install organiserpro

Note for Ubuntu/Debian/Python 3.12+ users:
If you try to install system-wide with pip, you may see an externally-managed-environment error due to recent changes in Python packaging (PEP 668).
Using a virtual environment avoids this problem and keeps your Python setup clean.

For more help, see the Python packaging user guide.

---

🏁 Quickstart

Sort your Downloads folder by file type:

organiserpro sort --directory ~/Downloads

Remove duplicate files in a folder:

organiserpro deduplicate --directory ~/Pictures

Preview actions before making changes:

organiserpro sort --directory ~/Documents --dry-run

See more in the Documentation.

---

📸 Example Output

[16:32:01] Sorting 150 files in /Users/you/Downloads
┣━━ Images (43)
┣━━ Documents (58)
┣━━ Archives (22)
┣━━ Others (27)
✔ All files sorted in 2.3 seconds.

(Add a screenshot or GIF here if possible for more visual appeal!)

---

📚 Documentation

• Full Documentation
• Troubleshooting
• Changelog
• Roadmap

---

🤝 Contributing

We love contributions! Please see our Contributing Guide, Code of Conduct, and Security Policy.

---

🛡 License

MIT License © The Solution Desk

---

💬 Need Help?

• Open an issue
• Join the discussion or reach out via Discussions

---