fren-cli

A fast, powerful command-line batch file renaming tool inspired by the "Multi-Rename Tool" in Total Commander.

📋 Changelog - See what's new in each version

Features

• Safe by Default: Always shows a preview of changes before performing them.
• Powerful Patterns: Support for filename, extension, counters, and metadata placeholders.
• Modifiers: Built-in support for lowercasing, uppercasing, title casing, and regex replacement.
• Undo Facility: Easily reverse your last batch of changes if you make a mistake.
• Collision Protection: Skips existing target files by default.

Installation

Via Cargo (Recommended)

cargo install fren-cli

From Source

git clone https://github.com/byezy/fren.git
cd fren
cargo build --release
cp ./target/release/fren ~/.local/bin/

Usage

fren <SEARCH_PATTERN> [OPTIONS]

Example

Old Name                                 -> New Name                                
--------------------------------------------    --------------------------------------------
IMG_0842.jpg                             -> Vacation_001.jpg                        
IMG_0843.jpg                             -> Vacation_002.jpg                        

Patterns

Refer to the root README.md for:

• Complete table of placeholders and modifiers
• Detailed explanation of how tokens and modifiers are applied
• Examples showing how order affects the result

License

This project is licensed under the MIT License.