Renamr

About
Installation
Updating
Usage
Example
License

About

renamr normalizes file and directory names. It rewrites them with lowercase English letters, digits, and hyphens in place of spaces and other symbols.

Installation

The tool runs on macOS, GNU/Linux, and other Unix-like operating systems, as well as Windows. It is packaged as a Ruby gem and requires Ruby 3.2 or later. If your platform lacks a suitable Ruby, see Installing Ruby.

Install the gem with:

gem install renamr

Updating

Update the gem with:

gem update renamr

Usage

renamr [options]
  -a, --act              Performs actual renaming.
  -c, --cut pos,len      Removes len characters starting at pos.
  -d, --dir dir          Directory to process.
  -l, --lim              Limits file name length.
  -m, --mod              Prepends file modification time.
  -p, --prepend str,beg  Prepends a string.
  -r, --rec              Processes directories recursively.
  -s, --src src          String to replace.
  -t, --dst dst          Replacement string.
  -v, --version          Shows the version.
  -w, --wid wid          Output table width.

Example

renamr -d <source>

This previews new names for all files in source using the default character set: the 26 English letters, 10 digits, and hyphens in place of spaces and other symbols. Adding -a performs the actual renaming.

License

renamr is copyright David Rabkin and is available under the Zero-Clause BSD license.

renamr