How do I use regex to rename files with nomino?

Use the -r option with a Rust regex pattern, e.g., `nomino -r "(\d+)_" "file_{1}.txt"` to capture digits. The Capture Groups section in the README explains named groups and placeholders for output formatting.

Nomino vs traditional rename command: which is better for developers?

Nomino excels with advanced features like Rust regex and JSON mapping, making it superior for complex, scriptable renames. Simple rename commands might suffice for basic string replacements without patterns.

How to pad numbers in filenames, like turning 1 into 001?

Use placeholders with padding, e.g., {1:3} for the first capture group padded to three digits. The Placeholders section details how {G:P} syntax works, including handling of non-numeric values.

Does nomino rename files in subdirectories or only the current folder?

It can handle subdirectories using options like --depth and --max-depth, but by default, it operates on files in the specified directory set with -d or the current path.

Is nomino safe to use without losing files?

Always run with --dry-run first to preview changes. Since there's no undo, backup your files before executing renames to prevent accidental data loss from regex errors or typos.

How to create and use a JSON map file for batch renaming?

Generate a map with -g after renaming, or create a JSON file manually with old-new name pairs. Use -m or --from-file to apply it, enabling reproducible renaming workflows.

Open-Awesome

nomino

Apache-2.0Rustv1.6.4

A command-line batch file renaming utility with regex support, sorting, and mapping capabilities for developers.

GitHub

711 stars24 forks0 contributors

What is nomino?

Nomino is a batch file renaming utility built for developers who need to rename multiple files programmatically. It solves the problem of tedious manual renaming by offering regex pattern matching, custom sorting, and JSON-based mapping from the command line. It provides a flexible and scriptable way to automate file organization tasks.

Target Audience

Developers, system administrators, and power users who frequently work with large sets of files and need precise, automated renaming capabilities from the terminal.

Value Proposition

Developers choose Nomino for its robust regex support, cross-platform availability, and dry-run testing feature, which allows safe experimentation. Its performance and flexibility make it a reliable alternative to manual renaming or less feature-rich tools.

Overview

Batch rename utility for developers

Use Cases

Best For

Renaming batches of photos or media files with consistent naming patterns
Organizing downloaded files using regex to extract metadata
Automating file renaming in CI/CD pipelines or scripts
Batch processing log files with timestamp-based naming
Renaming code files during project refactoring or migration
Sorting and numbering files in a specific order for presentations

Not Ideal For

Users who prefer graphical, drag-and-drop renaming tools with real-time visual feedback
Non-technical teams needing simple, intuitive renaming without regex or command-line expertise
Projects requiring renaming based on file metadata (e.g., EXIF data from images) rather than filenames alone

Pros & Cons

Pros

Robust Regex Support

Uses Rust's regex engine with named and indexed capture groups, enabling complex pattern matching for precise filename transformations, as shown in the Capture Groups section.

Safe Dry-Run Mode

Includes --test or --dry-run options to preview renaming results without modifying files, reducing the risk of accidental changes during experimentation.

Cross-Platform Availability

Offers pre-compiled executables for Linux, macOS, and Windows, ensuring easy deployment across diverse development environments.

Programmable JSON Mapping

Supports generating or using JSON map files for custom renaming logic, facilitating automation in scripts and CI/CD pipelines.

Cons

Steep Learning Curve

Mastering the regex patterns and {G:P} placeholder syntax requires familiarity with advanced concepts, which can be intimidating for casual or non-developer users.

No Built-In Undo

Lacks an undo feature; once files are renamed without dry-run, reverting changes must be done manually or via backups, increasing potential data loss.

Sparse Documentation

The README is concise and points to a wiki, but users might find it lacking detailed examples or troubleshooting guides for edge cases.

Frequently Asked Questions

Related Projects

RustDesk

An open-source remote desktop application designed for self-hosting, as an alternative to TeamViewer.

ripgrep recursively searches directories for a regex pattern while respecting your gitignore

Stars63,303

Forks2,537

Last commit2 months ago

vaultwarden

Unofficial Bitwarden compatible server written in Rust, formerly known as bitwarden_rs

Stars59,751

Forks2,760

Last commit2 days ago

Warp

Warp is an agentic development environment, born out of the terminal.

Stars54,375

Forks3,854

Last commit20 hours ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub