Renamer

Simple yet powerful file rename script. Rename batch of files as simple text lines.

This script doesn't provide much functionality by itself, but instead it leverages the power of your favorite text editor or IDE.

Demo worth a thousand words

Requirements

• java 8

Usage

• Download the latest release
• execute java -jar path_to_renamer.jar --help to see the usage:

  ~ $ renamer --help
  Usage: renamer [options] [glob]
  
    -o, --order <value>  File ordering (default is by name). Use one of these values (or prefix):
       * name (default)
       * extention
       * modification time
       * size
  
    --reverse            Reverse ordering
    -a, --arrow <value>  Arrow symbol. Default is '->'
    --help               print this usage text
    glob                 optional glob pattern (enclose in quotes)
  

• execute java -jar path_to_renamer.jar (without any args) to rename files in current directory
• follow the interactive instructions

Consider creating bash alias for the renamer. It's more convenient to type renamer instead of java -jar ....

Advanced usage

Script supports several parameters:

• --order allows to override sort order of the files

• --reverse reverse the selected file ordering (see --order)

• --arrow use alternative arrow symbol (make output look more fancy)

• trailing argument is a file filter in glob format. Example:

  java -jar renamer.jar "**/*.png"
  

  Two things to keep in mind when providing glob parameter:

  • glob parameter must be enclosed in quotes ("**"), as otherwise bash supplies actual file names as an argument instead of the pattern
  • search becomes recursive (from current directory) and pattern is tested against the absolute file path, so in order to match anything pattern must start from the wildcard (**/*.ext)

Development

• install sbt
• in project directory:
  • sbt compile — to compile project
  • sbt assembly — to create a fat jar

Credit

• Scala ❤️
• Scopt — simple scala command line options parsing
• Better files — Simple, safe and intuitive Scala I/O