66

I want to rename all files and directories that contain the word "special" to "regular". It should maintain case sensitivity so "Special" won't become "regular".

How can i do this in bash recursively?

1

8 Answers 8

121

A solution using find:

To rename files only:

find /your/target/path/ -type f -exec rename 's/special/regular/' '{}' \;

To rename directories only:

find /your/target/path/ -type d -execdir rename 's/special/regular/' '{}' \+

To rename both files and directories:

find /your/target/path/ -execdir rename 's/special/regular/' '{}' \+
9
  • 4
    @speakr, Great solution, thanks! Could you provide more details about what it is doing, especially this part " '{}' \ "? Quick goggling did not help, so I thought that this information may be useful for others as well. Commented Feb 27, 2015 at 13:21
  • 2
    @DmitryGonchar Just take a look at -exec command ; in the find manpage.
    – speakr
    Commented Feb 27, 2015 at 14:09
  • 2
    @ThiloSchulz It does, but you have to use find … -execdir … '{}' + instead of … '{}' \;. Clarification added.
    – speakr
    Commented Jan 16, 2017 at 10:20
  • 2
    In case of many files, take advantage of regex in find, for the last example above you use: find /your/target/path/ -regex '.*special.*' -execdir rename 's/special/regular/' '{}' \+, otherwise it will be quite slow! Commented Jan 25, 2018 at 13:44
  • 1
    great, thank you. However, does not seem to do the job recursively on OSX....
    – Cmag
    Commented May 4, 2020 at 15:42
89

Try doing this (require bash --version >= 4):

shopt -s globstar
rename -n 's/special/regular/' **

Remove the -n switch when your tests are OK

warning There are other tools with the same name which may or may not be able to do this, so be careful.

If you run the following command (GNU)

$ file "$(readlink -f "$(type -p rename)")"

and you have a result like

.../rename: Perl script, ASCII text executable

and not containing:

ELF

then this seems to be the right tool =)

If not, to make it the default (usually already the case) on Debian and derivative like Ubuntu :

$ sudo update-alternatives --set rename /path/to/rename

(replace /path/to/rename to the path of your perl's rename command.


If you don't have this command, search your package manager to install it or do it manually


Last but not least, this tool was originally written by Larry Wall, the Perl's dad.

14
  • 9
    what is the shopt -s globstar for?
    – Tom
    Commented Feb 21, 2013 at 21:40
  • 4
    It enables the bash feature ** (stands for recursive) maybe already enabled. Commented Feb 21, 2013 at 21:41
  • 4
    I have about 1700 files to rename in directories in my home directory. That seems too many for this to work, that actually was the text in the error message, too many arguments.
    – Dennis
    Commented Sep 20, 2015 at 0:57
  • 1
    in order to avoid errors use for i in **; do rename 's/<toreplace>/<replacewith>/' "$i"; done after globstar
    – Ferroao
    Commented Dec 2, 2017 at 21:21
  • 1
    People trying to rename a pattern occuring multiple times in the same name should add the 'g' flag at the end of the substitution command: 's/old/new/g' Commented Feb 4, 2018 at 16:09
8

Here is another approach which is more portable and does not rely on the rename command (since it may require different parameters depending on the distros).

It renames files and directories recursively:

find . -depth -name "*special*" | \
while IFS= read -r ent; do mv $ent ${ent%special*}regular${ent##*special}; done

What it does

  • use find with -depth parameter to reorder the results by performing a depth-first traversal (i.e. all entries in a directory are displayed before the directory itself).
  • do pattern substitutions to only modifiy the last occurence of regular in the path.

That way the files are modified first and then each parent directory.

Example

Giving the following tree:

├── aa-special-aa
│   └── bb-special
│       ├── special-cc
│       ├── special-dd
│       └── Special-ee
└── special-00

It generate those mv commands in that particular order:

mv ./aa-special-aa/bb-special/special-cc ./aa-special-aa/bb-special/regular-cc
mv ./aa-special-aa/bb-special/special-dd ./aa-special-aa/bb-special/regular-dd
mv ./aa-special-aa/bb-special ./aa-special-aa/bb-regular
mv ./aa-special-aa ./aa-regular-aa
mv ./special-00 ./regular-00

To obtain the following tree:

├── aa-regular-aa
│   └── bb-regular
│       ├── regular-cc
│       ├── regular-dd
│       └── Special-ee
└── regular-00
1
  • Thanks a lot for this explanation, perfect fit my needs.
    – Dax
    Commented Nov 20, 2021 at 14:54
7

If you don't mind installing another tool, then you can use rnm:

rnm -rs '/special/regular/g' -dp -1 *

It will go through all directories/sub-directories (because of -dp -1) and replace special with regular in their names.

3
  • Is this installed from Homebrew? Commented Feb 11, 2017 at 6:07
  • @LokMac : I don't think it's available in homebrew (I only package binary for debian based OS), If you have automake, you can install it in any Unix system (Instructions are in the readme).
    – Jahid
    Commented Feb 11, 2017 at 12:39
  • Great tool! Worked for me!
    – Black
    Commented Jun 23, 2017 at 7:54
6

@speakr's answer was the clue for me.

If using -execdir to transform both files and directories, you'll also want to remove -type f from the example shown. To spell it out, use:

find /your/target/path/ -execdir rename 's/special/regular/' '{}' \+

Also, consider adding g (global) flag to the regex if you want to replace all occurrences of special with regular in a given filename and not just the first occurrence. For example:

find /your/target/path/ -execdir rename 's/special/regular/g' '{}' \+

will transform special-special.jpg to regular-regular.jpg. Without the global flag, you'll end up with regular-special.jpg.

FYI: GNU Rename is not installed by default on Mac OSX. If you are using the Homebrew package manager, brew install rename will remedy this.

2
  • 1
    will this correclty handle including folders? e.g. /special/regular/regular-specilal.jpeg Commented Mar 8, 2019 at 9:40
  • Yes, it will rename both files and folders.
    – U007D
    Commented Apr 6, 2023 at 12:36
3

As mentioned by Rui Seixas Monteiro it's best to use the -iregex pattern option with the Find command. I've found the following works and includes the global flag in the regex as mentioned by U007D:

Files:

find /path/ -type f -iregex '.*special.*' -execdir rename 's/special/regular/g' '{}' \+;

Directories:

find /path/ -type d -iregex '.*special.*' -execdir rename 's/special/regular/g' '{}' \+;

Files and Directories

find /path/ -iregex '.*special.*' -execdir rename 's/special/regular/g' '{}' \+;
1
  • But it doesn't do a depth first traversal so it's open to problems with parent directories haven't been renamed first.
    – MrR
    Commented Apr 26, 2022 at 14:57
2

For those just wanting to rename directories you can use this command:

find /your/target/path/ -type d -execdir rename 's/special/regular/' '{}' \;

Note type is now d for directory, and using -execdir.

I haven't been able to work out how to rename both files and directories in a single pass though.

Someone commented earlier that once it renamed the root folder then it couldn't traverse the file tree any more. There is a -d switch available that does a depth traversal from the bottom-up, so the root would be renamed last I believe:

find -d /your/target/path/ -type d -execdir rename 's/special/regular/' '{}' \;

From the manpage (man find):

 -d      Cause find to perform a depth-first traversal, i.e., directories are visited in post-order and all entries in a directory will be
         acted on before the directory itself.  By default, find visits directories in pre-order, i.e., before their contents.  Note, the
         default is not a breadth-first traversal.
1
  • If anyone can clarify what is done to action the command for both files and directories in a single pass that would be appreciated too, and I'll update this answer with the command. Commented Feb 11, 2017 at 4:31
1

For rename version rename from util-linux 2.23.2 the following command worked for me:

find . -type f -exec rename mariadb mariadb-proxy '{}' \;

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.