https://github.com/davidfstr/renameregex
Renames files in bulk using regular expressions.
https://github.com/davidfstr/renameregex
regular-expression regular-expressions rename rename-files renamer renames
Last synced: 2 months ago
JSON representation
Renames files in bulk using regular expressions.
- Host: GitHub
- URL: https://github.com/davidfstr/renameregex
- Owner: davidfstr
- License: other
- Created: 2013-03-16T17:45:30.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2016-08-31T00:39:01.000Z (over 8 years ago)
- Last Synced: 2025-02-24T03:36:39.367Z (2 months ago)
- Topics: regular-expression, regular-expressions, rename, rename-files, renamer, renames
- Language: Python
- Size: 5.86 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# renameregex
Renames all files in the current directory using regular expression patterns.
For example `renameregex '(.*)\.JPG' '\1\.jpg'` will rename all files that end with `.JPG` to end with `.jpg`.
Real-world example:
```
[davidf Letters]$ renameregex '(.*?) *\((.*)\)(.*)' '\2 - \1\3'
Letter to Arlene (2010-08-18).JPG => 2010-08-18 - Letter to Arlene.JPG
Letter to Arlene (2010-08-18).rtf => 2010-08-18 - Letter to Arlene.rtf
Letter to Arlene (2011-03-03).jpg => 2011-03-03 - Letter to Arlene.jpg
Letter to Arlene (2011-11-06).rtf => 2011-11-06 - Letter to Arlene.rtf
Letter to Arlene (2012-02-23).rtf => 2012-02-23 - Letter to Arlene.rtf
Letter to Arlene (2012-07-07).rtf => 2012-07-07 - Letter to Arlene.rtf
Letter to Arlene (2012-11-25).rtf => 2012-11-25 - Letter to Arlene.rtf
Letter-Photo (2011-03-03).graffle => 2011-03-03 - Letter-Photo.graffle
Okay? [y/N] y
```
It is also possible to specify `-r` to search subdirectories recursively for files to rename.
## Requirements
* OS X or Linux
* Python 3.4 or later
## Installation
```
$ mkdir -p ~/bin
$ cd ~/bin
$ git clone https://github.com/davidfstr/renameregex.git
# ...or download this repository to ~/bin/renameregex
$ echo 'export PATH="$PATH:$HOME/bin/renameregex"' >> ~/.profile
```
## Usage
**renameregex** *filename_regex* *replacement_pattern*
Renames all files in the current directory that match the pattern *filename_regex* to a new name based on the *replacement_pattern*.
Before the rename is applied, a preview is printed of what files will be renamed and what they well be renamed to.
### Arguments
* *filename_regex* — A Perl-compatible regular expression (PCRE), specifically a [Python regular expression], that is used to identify files to rename.
* *replacement_pattern* — A [Python regex replacement string] used to generate the new filenames. Expressions like `\1` and `\2` can be used to refer to groups matched by *filename_regex*.
[Python regular expression]: https://docs.python.org/3.4/library/re.html#regular-expression-syntax
[Python regex replacement string]: https://docs.python.org/3.4/library/re.html#re.sub
## Changelog
* 2.0
* Features:
* Add -r option to search directories recursively.
* Breaking Changes:
* Substitution patterns use the syntax `\1` rather than `$1` for backreferences.
* Internal Changes:
* Rewrite script in Python rather than Java.
* 1.0
* Initial version.
## License
This software is licensed under the [MIT License].
[MIT License]: https://github.com/davidfstr/renameregex/blob/master/LICENSE.txt