asort
Renaming files in ascending order
A package helps renaming files in an ascending order. Each renamed file will contain its own index starting from 1.
Pre-requisite
How to use
It can be used as a dependency or as a CLI directly from your favorite terminal.
To use it as a dependency
# Install it as a dependency in your project npm install --save asort # Import the package via 'require' const
To install the CLI
You can choose to either use the CLI directly with npx or to install the CLI globally with NPM.
* Please note that as of npx is bundled with NPM as of the version of 5.2.0.
# Use CLI with npx $ npx asort <command> # Install globally via NPM $ npm install -g asort
Commands
-
Show help via
-h
or--help
.# asort --help$ asort -h -
Show version via
-v
or--version
.# asort --version$ asort -v -
Rename files
# Rename files in current directory$ asort ./# Rename files with defined directory path$ asort ~/my-videos/# Rename files with defined language for sorting files before renaming$ asort ~/my-videos/ -l "ja-JP"# Rename files with RegExp + replacer function$ asort ~/my-videos/ -r "/^(\\S+)[\\s\\S]*?(\\d*)\\.(\\w+)\$/i" -p "\$1 - \$2.\$3"
API reference
asort(dirName[, lang = 'en-US', regex, replace])
dirname
<string> Path to the directory that contains files to be renamed.lang
<string> Language of the files to be renamed. This is needed for sorting the files before renaming. Defaults toen-US
.regex
<string|Regex> Custom RegExp to filter files that need to be renamed.replacer
<string|Function> Custom replacer string or function when renaming the files.
License
MIT License © Rong Sen Ng