https://github.com/itchyny/mmv

rename multiple files with editor
https://github.com/itchyny/mmv

cli-command cli-utility golang

Last synced: about 1 month ago
JSON representation

rename multiple files with editor

• Host: GitHub
• URL: https://github.com/itchyny/mmv
• Owner: itchyny
• License: mit
• Created: 2020-01-07T16:01:27.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2023-04-26T10:00:04.000Z (about 2 years ago)
• Last Synced: 2025-04-12T14:18:46.672Z (3 months ago)
• Topics: cli-command, cli-utility, golang
• Language: Go
• Homepage:
• Size: 57.6 KB
• Stars: 776
• Watchers: 5
• Forks: 17
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# mmv

[![CI Status](https://github.com/itchyny/mmv/workflows/CI/badge.svg)](https://github.com/itchyny/mmv/actions)

[![Go Report Card](https://goreportcard.com/badge/github.com/itchyny/mmv)](https://goreportcard.com/report/github.com/itchyny/mmv)

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/itchyny/mmv/blob/main/LICENSE)

[![release](https://img.shields.io/github/release/itchyny/mmv/all.svg)](https://github.com/itchyny/mmv/releases)

[![pkg.go.dev](https://pkg.go.dev/badge/github.com/itchyny/mmv)](https://pkg.go.dev/github.com/itchyny/mmv)

Rename multiple files using your `$EDITOR`. The command name is named after _multi-mv_.

![](https://user-images.githubusercontent.com/375258/72040421-d4f8cd00-32eb-11ea-828f-d9f14f3261ac.gif)

## Usage

```bash

mmv file ...

```

This command opens the editor with the list of file names so edit and write.

The command finds the changed lines and renames all the corresponding files.

## Installation

### Homebrew

```sh

brew install itchyny/tap/mmv

```

### Build from source

```bash

go install github.com/itchyny/mmv/cmd/mmv@latest

```

## Features

- `mmv` is implemented in Go language and completely portable.

- `mmv` is designed to be simple as `mv`. It requires no configuration file.

- `mmv` supports renaming in cycle (`mv a b`, `mv b c` and `mv c a` at the same time).

- `mmv` creates destination directories automatically. You can arrange pictures like `yyyy-mm-dd xxxx.jpg` to `yyyy/mm/dd/xxxx.jpg`.

- `mmv` is capable to use as a library (just call `mmv.Rename`).

- `mmv` is easy to remember (I believe), **m**ulti-**mv**.

## Bug Tracker

Report bug at [Issues・itchyny/mmv - GitHub](https://github.com/itchyny/mmv/issues).

## Author

itchyny (https://github.com/itchyny)

## License

This software is released under the MIT License, see LICENSE.