Skip to content

thameera/vimv

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Gotchas

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