(no argument)

-

-

Displays the Rename dialog. The rename operation will be performed on all selected files and folders. The dialog will open in the last mode it was used in (either simple or advanced).

Example: Rename

AUTORENAME

/S

(no value)

Automatically adds an incrementing number to the end of new filenames if they clash with existing files.

Example: Rename PATTERN "The *" TO * AUTORENAME

CASE

/K

upper

Converts filenames to all-upper case.

Example: Rename CASE=upper

lower

Converts filenames to all-lower case.

Example: Rename CASE=lower NUMBER

firstword

Capitalizes the first letter of the filename.

Example: Rename CASE=firstword

allwords

Capitalizes the first letter of each word of the filename.

Example: Rename CASE=allwords

extupper

Converts the filename extension to upper case.

Example: Rename CASE=extupper

extlower

Converts the filename extension to lower case.

Example: Rename CASE=extlower

FINDREP

/O

(no value)

Enable find-and-replace mode. The PATTERN argument must be used to provide the string to find, and the TO argument provides the string to replace it with.

Example: Rename FINDREP PATTERN="jones" TO="smith"

ext

Makes find-and-replace operate in the filename extension as well as in the stem of the filename.

Example: Rename FINDREP=ext PATTERN="jpg" TO="jpeg"

INLINE

/O

(no value)

Activates inline renaming on the item in the source file display that currently has focus.

Example: Rename INLINE

all

Automatically selects the entire filename for editing.

Example: Rename INLINE=all

name

Automatically selects the filename's stem (but not the extension). Selects the whole name for a folder.

Example: Rename INLINE=name

endstem

Positions the cursor at the end of the filename's stem (before the extension), but does not automatically select any part of the name.

Example: Rename INLINE=endstem

ext

Automatically selects the filename's extension. Selects the whole name for a folder.

Example: Rename INLINE=ext

home

Positions the cursor at the beginning of the filename.

Example: Rename INLINE=home

end

Positions the cursor at the end of the filename.

Example: Rename INLINE=end

single

If more than one item is selected, the Rename dialog will be displayed. Without this, inline rename will begin on the focused item only.

Example: Rename INLINE=name,single

NOMATCHNOFAIL

/S

(no value)

Files which do not match the rename pattern are not 'failed'. This can be useful with multi-line functions which need to do some optional renaming before passing all of the files to additional commands.

By default, when NOMATCHNOFAIL is not used, if a file does not match the rename pattern then it will be flagged as a failure and skipped by the rest of the function (unless the very next command is another Rename, in which case the file gets a second chance).

If NOMATCHNOFAIL is used then files which do not match the rename pattern are still passed to subequent commands.

Example: Rename PATTERN "* Backup.*" TO *.* NOMATCHNOFAIL

PATTERN

/K

<pattern>

Specifies a wildcard pattern that represents the old (original) filename. This argument is used when performing a wildcard rename. The Rename command supports a simple wildcard syntax where one or more asterisks supplied for the PATTERN argument can be used to copy parts of the original name to the new name. The PATTERN argument is also used in conjunction with REGEXP to provide the search pattern for a regular expression rename, and in conjunction with FINDREP to provide the search string for a find-and-replace rename.

See the section on Renaming Files for a full discussion of the various renaming modes.

Example: Rename PATTERN IMGP(.*).jpg TO "Image \1.jpg" REGEXP

Specifying the FROM argument as well will mean the command ignores the current file selection and applies the specified rename on all matching files. Only files matching both the TO and PATTERN arguments would be renamed.

Example: Rename FROM *.jpg PATTERN IMGP(.*).jpg TO "Image \1.jpg" REGEXP

If the PATTERN and TO arguments are both given, the command will normally apply the rename immediately, without prompting for any further interaction; you can add the ADVANCED argument to instead display the Rename dialog, with the specified pattern, so that you can preview the operation and make adjustments, or cancel it entirely, as needed.

Example: Rename ADVANCED PATTERN * TO *.bak

RECURSE

/S

(no value)

The rename operation will operate recursively on all files inside selected sub-folders.

Example: Rename PATTERN *.jpg TO *.jpeg RECURSE

RENAMEMATCHING

/S

(no value)

Keeps files with the same stem and different exensions together when renumbering. For example, IMGP1032.JPG and IMGP1032.WAV when renamed would be given the same number.

Example: Rename NUMBER 0001 RENAMEMATCHING

SIMPLE

/S

(no value)

Displays the Rename dialog in simple mode.

Example: Rename SIMPLE

TYPE

/K

files

Force the rename to only operate on files - any selected folders will be ignored.

Example: Rename PATTERN * TO *.bak TYPE=files

dirs

Force the rename to only operate on folders.

Example: Rename PATTERN * TO Copy_* TYPE=dirs