Skip to main content

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, .pngPictures
    • .pdf, .docxDocuments
    • .mp4, .movVideos
  • 📦 Unmapped files (e.g., .zip, .rar) go to Archives
  • 💻 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

tidybit2-0.1.2.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

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

tidybit2-0.1.2-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

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

Hashes for tidybit2-0.1.2.tar.gz
Algorithm Hash digest
SHA256 0fbbfff3731ba0af192929d4ef40daeb131689cfc6aae0a2528f5fea6f61579f
MD5 80dfaf9d9a17e465a96d554409c81f40
BLAKE2b-256 ece53c498a2fa2fb7f45c7d7fff1f6f9d47801dd0cc0a35c1e9205568be10e4b

See more details on using hashes here.

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

Hashes for tidybit2-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9ede67d2848ff0f5458e2f1eb09160c253bbdf82f3c1ef12e48d366617608b6e
MD5 bcaa0e893c3fe00103562acb99f83c5e
BLAKE2b-256 897478f70e61183d413e529481cfcbfe128cb39e2f369c19f77a82341509be4d

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