(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

FROM

<filename> ...

Renames the files specified on the command line, rather than those selected in the source file display. This argument can accept filenames or wildcard patterns. Remember to enclose each filename in quotes if it contains spaces.

Example: Rename FROM C:\Spool\*.tmp TO *.temp

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

MATCHCASE

/S

(no value)

Makes the rename operation case-sensitive. Patterns and search strings must match the exact case of the filename.

Example: Rename PATTERN *.jpG TO *.JPG MATCHCASE

NOIGNOREEXT

/S

(no value)

Turns off the Ignore Extension option in the Rename dialog when it first opens. You only need to use this argument when opening the Rename dialog for interactive use.

Example: Rename PATTERN *.JPEG TO *.JPG ADVANCED NOIGNOREEXT

For non-interactive use of the Rename command, the Ignore Extension option is off by default (to avoid breaking old buttons) and can be turned on via the separate IGNOREEXT argument, documented above.

NUMBER

/O

(no value)

Automatically number files. Selected files will be numbered in the order they are presented in the file display, so you should make sure the list is sorted as desired before using this command. The number 1 will be assigned to the first selected file, and the number for each subsequent file will be incremented by the value given for the BY argument (or by 1 if BY is not provided).

By default the number is added to the end of the filename, in front of the extension. You can specify a different location for the number by providing the [#] marker in the new filename.

Example: Rename PATTERN * TO [#]* NUMBER

<start>

Number files starting with the specified number. Providing a value for NUMBER also lets you zero-pad the assigned number. For example, the value 0010 means to start numbering at 10, and zero-pad to four digits. The [#] marker can also be used to specify zero-padding - [#5] would zero-pad to five digits.

Example: Rename NUMBER 00001 BY 2

If you add a ! before the number, you can use this argument to specify the default value for the corresponding field in the Rename dialog without actually turning on the sequential numbering option. For example, you may want a default of "01" so you get padding to two digits without having to type the extra "0" every time you turn on the option in the UI. If you make use of that, you should also include the ADVANCED argument so the Rename dialog appears, instead of it silently performing a rename operation.

Example: Rename ADVANCED NUMBER=!01

PRESET

/K

findrep

Opens the Rename dialog in Find and Replace mode.

Example: Rename PRESET=findrep

regexp

Opens the Rename dialog in Regular Expression mode.

Example: Rename PRESET=regexp

regexpfindrep

Opens the Rename dialog in Regular Expression + Find and Replace mode.

Example: Rename PRESET=regexpfindrep

last
!last

Specifying PRESET=last opens the Rename dialog showing the settings from the last time the dialog was used. Similar to opening the dialog and clicking the Last Rename button.

Example: Rename PRESET=last

You can also use !last to apply the last rename automatically, without showing the Rename dialog first.

Example: Rename PRESET=!last

!list

Displays a generated list of saved rename presets (acts as a dynamic button). Selecting a preset from the list will apply that rename operation to the currently selected files and folders.

The generated list can be controlled with the addition of the following keywords:

• favesonly: Only displays presets marked as favorites.
• nofaves: Only displays presets not marked as favorites.
• nogroup: Don't not group favorite and non-favorite presets separately.

Example: Rename PRESET=!list,favesonly

<preset>

Applies the named saved rename preset to all currently selected files and folders. Rename presets are created through the Advanced Rename dialog.

Example: Rename PRESET="Number Files"

You can add the ADVANCED argument to make the dialog open and allow you to make changes, or cancel the operation entirely, before the rename is applied.

Example: Rename ADVANCED PRESET="Number Files"

REGEXP

/S

(no value)

Enables regular expression mode. The search pattern must be provided with the PATTERN argument, and the replace pattern with the TO argument. You can optionally combine this with the FINDREP argument.

Example: Rename PATTERN "(.*) - (.*)\.(.*)" TO "\2 - \1.\3" REGEXP

SCRIPTARG

/K/M

<option:value>,
[<option:value>,..]

Used to pass custom field values to a rename script.
 

Example: Rename PRESET MyRename SCRIPTARG my_option:True

TO

/O

<new name>

Specifies the new name of the file to rename. This argument is also used to specify the 'to' pattern when renaming using wildcards or regular expression, and the 'replace' string when renaming in find-and-replace mode. This argument can also be provided without a value when doing a find-and-replace rename - in that case, the search string would be replaced with nothing.

Example: Rename PATTERN " (Copy)" TO FINDREP

WHENEXISTS

/K

ask

Controls what happens if the new filename already exists. The default action is to ask the user for each existing file.
 

Example: Rename PATTERN * TO *.bak WHENEXISTS=ask

delete

Performs the rename as requested, deleting the file that already existed.
 

Example: Rename PATTERN * TO *.bak WHENEXISTS=delete

keep

Performs the rename as requested, renaming the old file that already existed.
 

Example: Rename PATTERN * TO *.bak WHENEXISTS=keep

rename

Modifies the new name by adding a suffix to make it unique.
 

Example: Rename PATTERN * TO *.bak WHENEXISTS=rename

skip

Skips any files that already exist, without performing the rename.
 

Example: Rename PATTERN * TO *.bak WHENEXISTS=skip