JavaScript Node.js file command-line-tool javascript-library filesystem batch regular-expression cross-platform
Need help with renamer?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.


Rename files in bulk.

226 Stars 26 Forks MIT License 278 Commits 1 Opened issues

Services available

Need anything else?

view on npm npm module downloads Gihub repo dependents Gihub package dependents Build Status Coverage Status js-standard-style

Upgraders, please read the release notes


Renamer is a command-line utility to help rename files and folders. It is flexible and extensible via plugins.


Always run this tool with the

option until you are confident the results look correct.


The examples below use double quotes to suit Windows users. MacOS & Linux users should use single quotes.

As input, renamer takes a list of filenames or glob patterns plus some options describing how you would like the files to be renamed.

$ renamer [options] [file...]

This trivial example will replace the text

in all file and directory names in the current directory.
$ renamer --find jpeg --replace jpg *

As above but operates on all files and folders recursively.

$ renamer --find jpeg --replace jpg "**"

If no filenames or patterns are specified, renamer will look for a newline-separated list of filenames on standard input. This approach is useful for crafting a specific input list using tools like

. This example operates on files modified less than 20 minutes ago.
$ find . -mtime -20m | renamer --find jpeg --replace jpg

Same again but with a hand-rolled input of filenames and glob patterns. Create an input text file, e.g.


Then pipe it into renamer.

$ cat files.txt | renamer --find jpeg --replace jpg

Simple example using a regular expression literal. The case-insensitive pattern

matches the input file
, renaming it to
$ renamer --find "/one/i" --replace "two" ONE.jpg


If the built-in behaviour doesn't fit your needs, take a look through the list of available plugins.

If you can't find an appropriate plugin you can write your own. For example, this trivial plugin appends the extension

to every input file. Save it as
module.exports = PluginBase => class Jpg extends PluginBase {
  replace (filePath) {
    return filePath + '.jpg'

Use your custom replace plugin by supplying its filename to the

$ renamer --plugin my-plugin.js images/*

Further reading

Please see the wiki for

For more information on Regular Expressions, see this useful guide.


$ npm install -g renamer

© 2012-20 Lloyd Brookes <[email protected]>.

Tested by test-runner. Documented by jsdoc-to-markdown.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.