Renamer

CLI tool written in Python 3 used to systemically rename files in a directory while adhering to a variety of criteria.

This program attempts to emulate the simplicity of the CLI program FFmpeg but for renaming files. Basic operations are straight-forward, while complex operations only invovle adding more flags and parameters to your operation. A directory with files that contain some numerical pattern are all that's required to get started. The application is well-paired for other software that require strict naming schemes, such as Plex, Kodi, or image managers.

Installation

Install renamer-kt using pip:

bash

pip install renamer-kt

Make sure you have Python and pip installed.

Usage

Usage Examples

The following usage snippets use this directory as a template:

mydir/
  2021vacation0001.jpeg
  2021vacation0003.jpeg
  2021vacation0004.jpeg
  2021vacation0010.jpeg

Clean-up

e.g. 1.jpeg, 3.jpeg, 4.jpeg, 10.jpeg

renamer mydir

Formalize & Fix Ordering

01.jpeg, 02.jpeg, 03.jpeg, 04.jpeg

renamer mydir -z 1 -c

Format & Modify Extension

2021 Vacation - 1.png, 2021 Vacation - 3.png, 2021 Vacation - 4.png, 2021 Vacation - 10.png

renamer mydir -e png -f "2021 Vacation - $d"

Shift & Flatten

4.jpeg, 5.jpeg, 6.jpeg, 7.jpeg

renamer mydir -s 3 -c

Meta

Kevin Tyrrell – KevinTearUl@gmail.com

Distributed under the GPL3 license. See LICENSE for more information.

https://github.com/KevinTyrrell

Contributing

1. Fork it (https://github.com/KevinTyrrell/Renamer)
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request