Metadata-Version: 2.3
Name: chname
Version: 2.1.3
Summary: Renames files in powerful ways
License: MIT
Author: Steve Scholnick
Author-email: scholnicks@gmail.com
Requires-Python: >=3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: docopt-ng (>=0.9.0,<0.10.0)
Project-URL: Repository, https://github.com/scholnicks/chname
Description-Content-Type: text/markdown

# chname

chname renames files in powerful ways.

```
Usage:
    chname [options] [<files>...]

Options:
    -a, --append=<suffix>                      Suffix to be appended
    -d, --delimiter=<delimiter>                Specifies the delimiter for fixing numerical filenames
    --directory=<directory>                    Destination directory [default: .]
    -f, --fix=<maximum number of digits>       Fixes numerical file names
    -h, --help                                 Show this help screen
    -l, --lower                                Translates the filenames to lowercase
    --merge                                    Merges the files in order specfied on command line
    -o, --order                                Take any input files and renames them in numerical order
    -p, --prepend=<prefix>                     Prefix to be prepended
    --random                                   Randomizes the files
    -r, --remove=<pattern>                     Pattern to be removed, can be a regex
    -q, --quiet                                Quiet mode
    -s, --substitute=<substitution pattern>    Substitutes a pattern (old/new, old can be a regex)
    -t, --test                                 Test mode (Just prints the rename operations)
    --titles=<input file with titles>          Rename the files by names in the specified input file
    --usage                                    Detailed usage information
    -v, --verbose                              Verbose mode
    --version                                  Prints the version
```

## Installation

```bash
pip install chname
```

## License

chname is freeware released under the [MIT License](https://github.com/scholnicks/chname/blob/main/LICENSE).

