rnr 0.1.0

rnr is a command-line tool to batch rename files for ANSI terminals
rnr-0.1.0 is not a library.

RnR Build Status

rnr is a command-line tool to batch rename files for ANSI terminals.


RnR is written in Rust. At this moment, you will need Cargo to build/install this application.

From source

git clone https://github.com/ChuckDaniels87/rnr .
cargo install

From Crates.io

cargo install rnr



    -b, --backup     Generate file backups before renaming
    -n, --dry-run    Only show what would be done (default mode)
    -f, --force      Make actual changes to files
    -h, --help       Prints help information
    -V, --version    Prints version information

    -d, --max-depth <LEVEL>    Set max depth in recursive mode
    -r, --recursive <PATH>     Recursive mode

    <EXPRESSION>     Expression to match (can be a regex)
    <REPLACEMENT>    Expression replacement
    <FILE(S)>...     Target files

Default behavior

  • Dry-run by default.
  • Only UTF-8 valid input arguments and filenames.
  • Works on files and symlinks (ignores directories).
  • Accepts multiple files as arguments.
  • Accepts a regex to generate matches. These expressions have same limitations of regex crate.
  • If max depth is not provided to recursive mode, it is assumed infite.
  • Does not generate backups.
  • Output is always colored. [TODO: no color mode / silent mode]


screenshot_1 screenshot_2