https://github.com/thameera/vimv

Batch-rename files using Vim
https://github.com/thameera/vimv

bash mv rename vim

Last synced: about 2 months ago
JSON representation

Batch-rename files using Vim

• Host: GitHub
• URL: https://github.com/thameera/vimv
• Owner: thameera
• License: mit
• Created: 2017-08-13T02:54:25.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-05-28T10:59:28.000Z (4 months ago)
• Last Synced: 2024-05-29T02:39:50.202Z (4 months ago)
• Topics: bash, mv, rename, vim
• Language: Shell
• Homepage:
• Size: 152 KB
• Stars: 630
• Watchers: 17
• Forks: 46
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# vimv

vimv is a terminal-based file rename utility that lets you easily mass-rename files using Vim.

## Installing

1. For the current user:

   ```

   curl https://raw.githubusercontent.com/thameera/vimv/master/vimv > ~/.local/bin/vimv && chmod +755 ~/.local/bin/vimv

   ```

2. For the current system:

   ```

   sudo PREFIX=/usr/local make install

   ```

Or simply copy the `vimv` file to a location in your `$PATH` and make it executable.

## Usage

1. Go to a directory and enter `vimv` with optionally, a list of files to rename.

2. A Vim window will be opened with names of all files.

3. Use Vim's text editing features to edit the names of files. For example, search and replace a particular string, or use visual selection to delete a block.

4. Save and exit. Your files should be renamed now.

## Other features

* If you want to list only a group of files, you can pass them as an argument. eg: `vimv *.mp4`

* If you have an `$EDITOR` environment variable set, vimv will use its value by default.

* If you are inside a Git directory, vimv will use `git mv` (instead of `mv`) to rename the files.

* You can use `/some/path/filename` format to move the file elsewhere during renaming. If the path is non-existent, it will be automatically created before moving.

## Screencast

![alt text](screencast.gif "vimv in action")

## Gotchas

Don't delete or swap the lines while in Vim or things will get ugly.

## Running tests

Tests are written using [bats](https://github.com/bats-core/bats-core). To run the tests:

```sh

git submodule update --init

test/test_vimv.bats

```