Skip to content

terror/edmv

Repository files navigation

edmv 📦

CI crates.io

edmv is a tool that lets you bulk rename files fast using your preferred text editor.

Demo

Below is a short demo showcasing the main functionality of the program:

asciicast

Installation

You can install the edmv command-line utility via the rust package manager cargo:

cargo install edmv

...or you can build it from source:

git clone https://github.com/terror/edmv
cd edmv
cargo install --path .

...or you can download one of the pre-built binaries from the releases page.

Usage

Below is the output of edmv --help:

Bulk rename files using your favorite editor

Usage: edmv [OPTIONS] [sources]...

Arguments:
  [sources]...  Paths to edit

Options:
      --editor <EDITOR>  Editor command to use
      --force            Overwrite existing files
      --resolve          Resolve conflicting renames
      --dry-run          Run without making any changes
  -h, --help             Print help
  -V, --version          Print version

An option of note is the --resolve option, this applies to sources an intermediate rename to either a temporary directory or file - automatically handling conflicts such as overlapping or circular renames.

Prior Art

edmv is a tested and extended re-implementation of the version Casey wrote in Python, do check it out!