Skip to content

Latest commit

 

History

History
31 lines (23 loc) · 1.94 KB

README.md

File metadata and controls

31 lines (23 loc) · 1.94 KB

blkmv

blkmv is a command line utility for reorganizing and renaming files using a text editor. Currently blkmv only supports GNU/Linux systems, but it might accidentally work on other unix-like systems. blkmv is inspered by the bulk rename tool in ranger. I find ranger to be slow and bulkrename was the only thing I actually used from ranger, so I wrote my own version and then added some features.

installation

Clone the repository and run sudo make install.

usage

basic

Pass a directory to blkmv. For example: blkmv ~/Music/Album. blkmv will open whatever program the environment variable EDITOR is set to. From inside the editor you can change the names of the files listed. To commit these changes, save and close the file. blkmv will then rename any file that changed. If you don't want to change anything, you can close the file without saving and nothing will happen.

-R recursion

You can pass the -R option to get all of the files recursively in a directory.

blkmv automatically creates new directories and removes empty ones allowing meaning it can be used to completely reorganise a file tree very quickly. You can arbitrarily name files to where you would like them to be without thinking about what directories you need to create or remove.

deleting files

From within the editor if you prepend a filename with # it will delete that file. Don't try to rename files to something that starts with a #. blkmv will delete the file.

-D directory mode

By passing -D to blkmv, you will get a list of directories instead of files. Works the same way as normal mode, just with directories.

using a different editor

blkmv simple looks at the EDITOR environment variable.

EDITOR=nano blkmv some_directory/

other options

-f shows full file paths so you can move file outside of the directory you opened. -h shows hidden files. -q By default, blkmv reports what it's doing to stdout. This option hides that output.