#cli #tool #rename

app pipe-rename

Rename your files using your favorite text editor

15 stable releases

1.6.1 Nov 6, 2022
1.6.0 Oct 24, 2022
1.5.0 Jul 10, 2022
1.4.2 Jan 3, 2022
1.1.4 Sep 14, 2020

#252 in Command line utilities

Download history 3/week @ 2022-10-08 4/week @ 2022-10-15 62/week @ 2022-10-22 24/week @ 2022-10-29 103/week @ 2022-11-05 44/week @ 2022-11-12 50/week @ 2022-11-19 15/week @ 2022-11-26 11/week @ 2022-12-03 12/week @ 2022-12-10 29/week @ 2022-12-17 18/week @ 2022-12-24 7/week @ 2022-12-31 7/week @ 2023-01-07 19/week @ 2023-01-14 24/week @ 2023-01-21

58 downloads per month

MIT license

382 lines



pipe-rename takes a list of files as input, opens your $EDITOR of choice, then renames those files accordingly.


cargo install pipe-rename

This will install the renamer binary.


Usage is simple, just pipe a list of files into renamer. This will open your $EDITOR (or vim, if not set), and once your editor exits it will detect which files were renamed:

ls | renamer

You can also supply filenames as positional arguments. To rename txt files in the current directory:

renamer *.txt

The default behavior is to rename files, but you can override this. If you want to run git mv old new on each rename, you can do something like this:

ls | renamer --rename-command "git mv"


Takes a list of files and renames/moves them by piping them through an external editor

    renamer [OPTIONS] [FILES]...


    -c, --rename-command <COMMAND>
            Optionally set a custom rename command, like 'git mv'

    -e, --editor <EDITOR>
            Optionally set an editor, overriding EDITOR environment variable and default

    -f, --force
            Overwrite existing files

    -h, --help
            Print help information

    -p, --pretty-diff
            Prettify diffs

    -V, --version
            Print version information

    -y, --yes
            Answer all prompts with yes

Contributors ✨

Marcus Buffett

🤔 💻

Robin Krahl

🤔 💻 🐛

Max Timkovich


Benoit de Chezelles


This project follows the all-contributors specification. Contributions of any kind welcome!


~63K SLoC