Skip to main content

A simple CLI tool to organize files by extensions

Project description

File Organizer CLI ๐Ÿ“‚

A simple command-line tool to automatically organize files in a directory based on their extensions.

๐Ÿš€ Features

โœ” Automatically moves files into categorized folders based on extensions โœ” Supports all file types โœ” Avoids overwriting existing files โœ” Fast and lightweight


๐Ÿ“ฅ Installation

1๏ธโƒฃ Install via pip (Recommended)

pip install file-organizer-cli

2๏ธโƒฃ Install from Source

git clone https://github.com/yourusername/file-organizer-cli.git cd file-organizer-cli pip install --editable .


๐Ÿ”ง Usage

Basic Command

To organize files inside a folder:

arrange /path/to/folder

Example

Before running:

Downloads/ โ”œโ”€โ”€ report.pdf โ”œโ”€โ”€ music.mp3 โ”œโ”€โ”€ photo.jpg

After running:

Downloads/ โ”œโ”€โ”€ pdf/ โ”‚ โ”œโ”€โ”€ report.pdf โ”œโ”€โ”€ mp3/ โ”‚ โ”œโ”€โ”€ music.mp3 โ”œโ”€โ”€ jpg/ โ”‚ โ”œโ”€โ”€ photo.jpg


๐Ÿ›  Development

If you want to modify this tool, follow these steps:

git clone https://github.com/yourusername/file-organizer-cli.git cd file-organizer-cli pip install --editable .

Now you can test changes by running:

arrange /path/to/folder


๐Ÿ“„ License

This project is licensed under the MIT License.


๐Ÿค Contributing

Feel free to open an issue or submit a pull request! ๐Ÿš€


๐Ÿ“Œ Notes

Ensure Python 3.6+ is installed.

Run pip uninstall file-organizer-cli to remove the package.

file_organizer/ โ”‚โ”€โ”€ file_organizer/ # Package source folder โ”‚ โ”œโ”€โ”€ init.py # Marks it as a package โ”‚ โ”œโ”€โ”€ organize.py # Your script โ”‚โ”€โ”€ setup.py # Setup script โ”‚โ”€โ”€ README.md # Project description โ”‚โ”€โ”€ LICENSE # (Optional) License file โ”‚โ”€โ”€ requirements.txt # (Optional) Dependencies

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

dirorganizer-1.0.3.tar.gz (3.3 kB view details)

Uploaded Source

Built Distribution

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

dirorganizer-1.0.3-py3-none-any.whl (3.7 kB view details)

Uploaded Python 3

File details

Details for the file dirorganizer-1.0.3.tar.gz.

File metadata

  • Download URL: dirorganizer-1.0.3.tar.gz
  • Upload date:
  • Size: 3.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for dirorganizer-1.0.3.tar.gz
Algorithm Hash digest
SHA256 c9f5cb9a4807429fd76dcdd79c23470e70070405aefcdb2469c2fd0965390179
MD5 3c661a7ef453edf2b410bff160d84f8b
BLAKE2b-256 fc7b396f2699118c8a0512182f4ca1f32d66e12077b957cfe48815f1a3000889

See more details on using hashes here.

File details

Details for the file dirorganizer-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: dirorganizer-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 3.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for dirorganizer-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 7b6f1fbde81b7a5aa859334687349e9fb317a888930d98707e92b27889a422e5
MD5 37a05ec404827d8227ccadcb5e5e77e2
BLAKE2b-256 9ad1b7f00fe0f14f7fdcc4a091dfcef469576d3ed19f998a22ae77b3ec0bd98b

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