A powerful and configurable command-line tool to organize your files effortlessly.
Project description
File Organizer CLI
A powerful and configurable command-line tool to organize your files effortlessly.
Overview
This tool helps you keep your directories tidy by moving files into dedicated folders based on their extension, creation date, or custom rules you define.
Features
- Organize files by their extension (e.g.,
.pdf,.jpg,.docx). - Sort files into folders by creation date (e.g.,
YYYY-MM-DD). - Highly configurable using a
config.yamlfile. - Cross-platform and easy to use.
Installation
You can install the File Organizer CLI directly from PyPI:
pip install kps-file-organizer
Usage
Here are a couple of examples of how to use the tool.
Organize by File Extension
This command will scan the specified directory and group files into subdirectories based on their extension (e.g., pdf, jpg, txt).
file-organizer /path/to/your/directory --by-extension
Organize by Date
This command will scan the specified directory and group files into subdirectories based on their modification date.
file-organizer /path/to/your/directory --by-date
Previewing Changes (Dry Run)
To see which files will be moved without actually performing the operation, use the --dry-run flag. This is highly recommended to run first.
file-organizer /path/to/your/directory --by-extension --dry-run
Author
- Krishna Pratap Singh
- GitHub: kps369
License
This project is licensed under the MIT License. See the LICENSE file for details.
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 kps_file_organizer-0.3.0.tar.gz.
File metadata
- Download URL: kps_file_organizer-0.3.0.tar.gz
- Upload date:
- Size: 3.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b5b387705c1ba3aa0c25cbb2a154341597d6ede587e94fab7ca268fba3ae4b1d
|
|
| MD5 |
dd7fc1765192ff2ce2a861032ecf7671
|
|
| BLAKE2b-256 |
b1d7b50fe5a23b7e98faf794822d14097bb114d3c1f32ba3337bf3e4a245fe4d
|
File details
Details for the file kps_file_organizer-0.3.0-py3-none-any.whl.
File metadata
- Download URL: kps_file_organizer-0.3.0-py3-none-any.whl
- Upload date:
- Size: 4.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b94a9b4ef5a9a70a0207b56211229150afd8c0f9f0c3b0ac64f61a8ff43ad89
|
|
| MD5 |
c42fa54e3bee3483b33588094ef5f67a
|
|
| BLAKE2b-256 |
ce5f5781388a5a6640696ba41d80b3062cafde77d3d27911e5ca6c2e2a4f7b60
|