Skip to main content

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.yaml file.
  • 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

kps_file_organizer-0.3.0.tar.gz (3.8 kB view details)

Uploaded Source

Built Distribution

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

kps_file_organizer-0.3.0-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

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

Hashes for kps_file_organizer-0.3.0.tar.gz
Algorithm Hash digest
SHA256 b5b387705c1ba3aa0c25cbb2a154341597d6ede587e94fab7ca268fba3ae4b1d
MD5 dd7fc1765192ff2ce2a861032ecf7671
BLAKE2b-256 b1d7b50fe5a23b7e98faf794822d14097bb114d3c1f32ba3337bf3e4a245fe4d

See more details on using hashes here.

File details

Details for the file kps_file_organizer-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for kps_file_organizer-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9b94a9b4ef5a9a70a0207b56211229150afd8c0f9f0c3b0ac64f61a8ff43ad89
MD5 c42fa54e3bee3483b33588094ef5f67a
BLAKE2b-256 ce5f5781388a5a6640696ba41d80b3062cafde77d3d27911e5ca6c2e2a4f7b60

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