nomino

nomino

Batch rename utility for developers

How to install

Pre-Compiled

You can download a pre-compiled executable for Linux, MacOS and Windows operating systems, then you should copy that executable to a location from your $PATH env:

• Linux 64bit
• MacOS 64bit
• Windows 64bit

You might need to run chmod +x nomino-linux-64bit or chmod +x nomino-macos-64bit.

Build Manually

If you prefer to build nomino manually, or a pre-compiled executable is not provided for your target, then you can build nomino from scratch:

• Install Rust: curl -sSf https://sh.rustup.rs | sh
• Run cargo install nomino

Usage

…

Placeholders

1. Placeholders have the format of {G:P} where G is the captured group and P is the padding of digits with 0. For example, {2:3} means the third captured group with a padding of 3, i.e. 1 is formatted as 001.
2. Indices start from 0, and {0} means the filename.
3. The capture group G could be dropped, i.e. {} or {:3}. In this case an auto incremental index is used which starts from 1. For example, {} {} equals {1} {2}.
4. { and } characters could be escaped using \ character, i.e. \\{ and \\} in cli.
5. Padding is only used for positive numbers, e.g. the formatted result of {:3} for 1 is 001, for -1 is -1 and for a is a.
6. If --sort option is used, the first index {0} is the filename and the second index {1} or first occurrence of {} is the enumerator index.

Capture Groups

The accepted syntax of regex pattern is Rust Regex.

Consider this example:

(?\w)(\w)\w(?\w)

This regular expression defines 4 capture groups:

• The group at index 0 corresponds to the overall match. It is always present in every match and never has a name: {0}.
• The group at index 1 with name first corresponding to the first letter: {1}, {first} or the first occurrence of {}.
• The group at index 2 with no name corresponding to the second letter: {2} or the second occurrence of {}.
• The group at index 3 with name last corresponding to the fourth and last letter: {3}, {last} or the third occurrence of {}.

? and ? are named capture groups.

Windows

On Windows, \\ must be used to separate path components in file paths because \ is a special character in regular expressions.

Map file format

{
    "": "",
    "": "",
    "": ""
}

Wiki

• Examples learn nomino by examples
• Benchmark benchmark test of similar utilities to nomino