#clean #tool #file #filename #filesystem #command-line-tool

bin+lib filerefine

๐Ÿงน FileRefine is a Rust-based CLI tool that renames files in a directory to remove unwanted or problematic characters from filenames

4 releases

new 0.1.4 Oct 31, 2024
0.1.3 Oct 31, 2024
0.1.2 Oct 21, 2024
0.1.1 Oct 21, 2024

#1452 in Command line utilities

Download history 239/week @ 2024-10-18 174/week @ 2024-10-25

419 downloads per month

MIT license

30KB
528 lines

FileRefine

 _____  _  _        ____          __  _              
|  ___|(_)| |  ___ |  _ \   ___  / _|(_) _ __    ___ 
| |_   | || | / _ \| |_) | / _ \| |_ | || '_ \  / _ \
|  _|  | || ||  __/|  _ < |  __/|  _|| || | | ||  __/
|_|    |_||_| \___||_| \_\ \___||_|  |_||_| |_| \___|

๐Ÿงน FileRefine is a Rust-based CLI tool that renames files in a directory to remove unwanted or problematic characters from filenames.

๐Ÿš€ Installation

To install filerefine, simply clone the repository and follow the instructions below:

git clone https://github.com/trinhminhtriet/filerefine.git
cd filerefine

cargo install --path .

filerefine --do my_path

Running the below command will globally install the filerefine binary.

cargo install filerefine

By default, filerefine will only print the names that would be renamed. Use the --do or -d option to actually rename the files.

๐Ÿ’ก Options

Option Description
-v, --version Prints version information
-d, --do Do the actions
-q, --quiet No output
-j, --json Output as JSON
-p, --json-pretty Output as JSON (prettified)
-e, --json-error Output as JSON (only errors)

๐Ÿค How to contribute

We welcome contributions!

  • Fork this repository;
  • Create a branch with your feature: git checkout -b my-feature;
  • Commit your changes: git commit -m "feat: my new feature";
  • Push to your branch: git push origin my-feature.

Once your pull request has been merged, you can delete your branch.

๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

Information

Dependencies

~0.3โ€“1MB
~24K SLoC