Have you ever faced the need to rename a file and do a search and replace to adjust all places where it is referenced? For example if you are a C++ developer you may want to rename foo.h and foo.cpp to bar.h and bar.cpp, but you must also replace all lines which says #include “foo.h” with #include “bar.h” in other source files… and don’t forget updating the build system files as well!

This is not really difficult, but it’s tedious and error-prone.

Enter msrp, Meta Search and Replace Program, a handy command-line utility designed to do search and replaces in both file contents and file names. In my example, renaming foo.h and foo.cpp to bar.h and bar.cpp can be done with this single command:

msrp foo\. bar. src/dir/

Note that I escaped the ‘.’ in “foo.”, because msrp supports Perl 5 regular expressions.

What makes msrp even more useful is that it is VCS aware: If I replace the previous command with:

msrp --svn foo\. bar. src/dir/

Then msrp will rename my files using “svn move” instead of doing a plain rename!

Unfortunately, it is unmaintained right now: his developer does not have time anymore to work on it. You can however install it via apt-get on Debian and Ubuntu, or download the source tarball on the page of the Debian package (the developer was also a Debian packager (Hint: if you are a Debian packager, there is an orphaned package waiting for you!))

Msrp comes with support for Mercurial and Subversion by default, but I wrote patches to add support for Git and Bazaar. Note that these patches are not in the 0.9.4 version which is shipped by Debian and Ubuntu.

Give it a try!


I am a g33k, Linux blogger, developer, student and Tech Writer for My passion for all things tech drives my hunt for all the coolz. I often need a vacation after I get back from vacation....

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.