vidir man page

vidir ā€” edit directory


vidir [--verbose] [directory|file|-] ...


vidir allows editing of the contents of a directory in a text editor. If no directory is specified, the current directory is edited.

When editing a directory, each item in the directory will appear on its own numbered line. These numbers are how vidir keeps track of what items are changed. Delete lines to remove files from the directory, or edit filenames to rename files. You can also switch pairs of numbers to swap filenames.

Note that if "-" is specified as the directory to edit, it reads a list of filenames from stdin and displays those for editing. Alternatively, a list of files can be specified on the command line.


-v, --verbose

Verbosely display the actions taken by the program.


vidir *.jpeg

Typical uses.

find | vidir -

Edit subdirectory contents too. To delete subdirectories, delete all their contents and the subdirectory itself in the editor.

find -type f | vidir -

Edit all files under the current directory and subdirectories.

Environment Variables


Editor to use.


Also supported to determine what editor to use.


Copyright 2006 by Joey Hess <>

Licensed under the GNU GPL.


2015-07-13 moreutils