Renamr

• About
• Install
• Updating
• Using
• 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.

Install

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

Using

renamr [options]
  -a, --act              Performs actual renaming.
  -c, --cut pos,len      Removes len characters starting at pos.
  -d, --dir dir          Sets the 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          Sets the string to replace.
  -t, --dst dst          Sets the replacement string.
  -v, --version          Shows the version.
  -w, --wid wid          Sets the 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.