A CLI tool to organize files into system and custom folders
Project description
📁 TidyBit 2
A sleek, interactive command-line tool that organizes your messy directories into neat system folders (Pictures, Documents, Videos) or custom folders like Archives.
✨ Features interactive folder selection, preview mode, and confirmation.
🚀 Features
- 🧭 Interactive folder selection with arrow keys (powered by
questionary) - 🔍 Preview of file moves (e.g.,
photo.jpg → Pictures) - ✅ Confirmation prompt to accept or cancel
- 🗂️ Moves files to system folders:
.jpg,.png→Pictures.pdf,.docx→Documents.mp4,.mov→Videos
- 📦 Unmapped files (e.g.,
.zip,.rar) go toArchives - 💻 Works on Windows and Linux
- 🔧 Auto-creates folders if they’re missing
🛠️ Installation
Install with a single command (no cloning needed):
🔧 For Linux/macOS:
curl -sSL https://pypi.org/project/tydybit2/0.1.1/.sh | bash
🪟 For Windows (PowerShell):
iwr -useb https://yourdomain.com/install-organizer.ps1 | iex
🐍 Or install via pip:
pip install tidybit2
All dependencies (like questionary) will be handled automatically.
💡 Usage
🔄 Interactive mode:
organize
📂 Run on a specific folder:
organize ~/Downloads
📄 License
MIT License – free to use, remix, or deploy in your startup pitch deck (just don’t pretend you wrote it all).
🤝 Contribute
Want to make it smarter? Found a bug?
PRs are open – fork it, improve it, and let’s tidy some bits together.
🧠 “Clutter is just data without direction. TidyBit gives it purpose.”
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
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 tidybit2-0.1.2.tar.gz.
File metadata
- Download URL: tidybit2-0.1.2.tar.gz
- Upload date:
- Size: 4.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0fbbfff3731ba0af192929d4ef40daeb131689cfc6aae0a2528f5fea6f61579f
|
|
| MD5 |
80dfaf9d9a17e465a96d554409c81f40
|
|
| BLAKE2b-256 |
ece53c498a2fa2fb7f45c7d7fff1f6f9d47801dd0cc0a35c1e9205568be10e4b
|
File details
Details for the file tidybit2-0.1.2-py3-none-any.whl.
File metadata
- Download URL: tidybit2-0.1.2-py3-none-any.whl
- Upload date:
- Size: 5.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9ede67d2848ff0f5458e2f1eb09160c253bbdf82f3c1ef12e48d366617608b6e
|
|
| MD5 |
bcaa0e893c3fe00103562acb99f83c5e
|
|
| BLAKE2b-256 |
897478f70e61183d413e529481cfcbfe128cb39e2f369c19f77a82341509be4d
|