Directory Opus Manual

AUTOSIZE

/K

on

Turns on the Auto-size all columns in Details and Power modes Folder Format option in the current file display. This overrides all column widths so they behave as "auto" until the option is turned off again. Note that any configured maximum column widths still apply.

Example: Set AUTOSIZE=on

off

Turns the Auto-size all columns in Details and Power modes option off.

Example: Set AUTOSIZE=off

toggle

Toggles the Auto-size all columns in Details and Power modes option on or off in the current file display.

Example: Set AUTOSIZE=toggle

BLURFILENAMES

/K

on

Turns on blurring of filenames in the source Lister. You might want to do this in order to use an external screenshot tool to take a screenshot while hiding potentially sensitive information.

Example: Set BLURFILENAMES=on

off

Turns filename blurring off in the source Lister.

Example: Set BLURFILENAMES=off

toggle

Toggles filename blurring on or off.

Example: Set BLURFILENAMES=toggle

CHECKBOXMODE

/K

on

Turns Checkbox mode on in the source file display.

Example: Set CHECKBOXMODE=on

off

Turns Checkbox mode off in the source file display.

Example: Set CHECKBOXMODE=off

toggle

Toggles Checkbox mode on or off.

Example: Set CHECKBOXMODE=toggle

CLEARSYNC

/S

(no value)

Once you've used the Find SYNC and Copy SYNC commands to automate the synchronize operation, you can use Set CLEARSYNC to exit synchronize mode and return the Lister to normal.

Example: See the Find SYNC command for an example.

COLUMNSADD

/K

<column>, …

Adds the specified columns to the current source file display. Can also be used to move or resize existing columns. You can specify one or more comma-separated column keywords.

Each column name can optionally be followed by the position to insert the column, and the width to make the new column. The format of this is as follows:

The <pos> argument can also be specified relative to another column's current position. For example:

• 0+Name places the new column where the Name column was, pushing Name and everything after it one place to the right.
• 1+Name places it directly on the right of Name.
• 2+Name places it two to the right of Name.
• 1-Name places it two to the left of Name (i.e. in the position of the column that was one to the left of Name). You can also set <pos> to ! to leave it unchanged, or prefix it with ! to say it should be unchanged if the column is already present, but use the position specified after the ! if it is being added.

To specify any arguments other than <pos>, those that precede it must be included. If you don't want to provide a value for one of the prior arguments, use * instead. For example, if you want to specify size 80 but without specifying a position, you could use (*, 80).

The <size>, <max> and <min> values of existing columns can also be changed by specifying a ! for <pos>.

Within the Lister Column Header Context Menu, you can use several special values for the position:

Example: Set COLUMNSADD picwidth
Example: Set COLUMNSADD desc(2),author(*,*)
Example: Set COLUMNSADD picwidth(*,a)
Example: Set COLUMNSADD=Status(!1+Name)

COLUMNSREMOVE

/O

<column>, …

Removes the specified columns from the current source display. You can specify one or more comma-separated column keywords.

Example: Set COLUMNSREMOVE=mp3bitrate,mp3samplerate

Within the Lister Column Header Context Menu, you can use %header% to refer to the column which was right-clicked.

Example: Set COLUMNSREMOVE=%header%

CONFIRM

/S

(no value)

Used to show a confirmation message specific to the command being run, often with a link to the Preferences setting for making the change permanent. This is only supported by certain commands, and not something you'd generally use when creating your own buttons. It is used on the default toolbars to help people understand when something only affects the current window or tab, and how make the same change globally instead.

Example: Set EXPANDABLEFOLDERS=Toggle CONFIRM

COPYFILTER

/K

on

Turns on the recursive copy filter for the active Lister.

Example: Set COPYFILTER=on

off

Turns off the copy filter in the active Lister.

Example: Set COPYFILTER=off

toggle

Toggles the copy filter on or off in the active Lister.

Example: Set COPYFILTER=toggle

DELFILTER

/K

on

Turns on the recursive delete filter for the active Lister.

Example: Set DELFILTER=on

off

Turns off the delete filter in the active Lister.

Example: Set DELFILTER=off

toggle

Toggles the delete filter on or off in the active Lister.

Example: Set DELFILTER=toggle

DELRECYCLECONFIRM

/K

on

Turns on the Skip confirmation when deleting to Recycle Bin option on the Deleting Files page in Preferences.

Example: Set DELRECYCLECONFIRM=on

off

Turns off the Skip confirmation when deleting to Recycle Bin option.

Example: Set DELRECYCLECONFIRM=off

toggle

Toggles the Skip confirmation when deleting to Recycle Bin option on and off.

Example: Set DELRECYCLECONFIRM=toggle

DISABLEGLOBALHOTKEYS

/K

on

Temporarily disables all global hotkeys. Hotkeys local to a Lister will continue to function.

Example: Set DISABLEGLOBALHOTKEYS=on

off

Re-enables all global hotkeys.

Example: Set DISABLEGLOBALHOTKEYS=off

toggle

Toggles all global hotkeys on and off.

Example: Set DISABLEGLOBALHOTKEYS=toggle

DUALSIZE

/K

<size>[,<size>]

Adjusts the splitter between the dual file displays in the active Lister. If the displays are arranged vertically, the command will affect their widths; if they are arranged horizontally it will affect their heights.

The size is given as a percentage, specifying how much of the available space the first file display should use, with the second file display getting whatever is left.

For example, specify 50 to make both file displays the same size (the same as double-clicking the splitter between them):

Example: Set DUALSIZE 50

As another example, specify 75 to make the first file display use 75% of the space to leave 25% of the space for the second:

Example: Set DUALSIZE 75

It is also possible to specify two sizes to make the command toggle between them. This lets you create a button or hotkey to quickly toggle between giving most of the space to one display and making them equal again.

Example: Set DUALSIZE 75,50

You can also resize the splitter by a relative amount by specifying a positive or negative delta.

Example: Set DUALSIZE +10

EVALUATORDISABLE

/O

on

Disables the evaluator. You might want to do this if you've been experimenting with it and you find it's causing problems that need to be resolved before it can be turned back on again. The evaluator will stay disabled until you re-enable it (or until Opus is restarted).

Example: Set EVALUATORDISABLE=on

off

Re-enables the evaluator.

toggle

Toggles the evaluator on and off.

FDBTOOLBAR

/O

<name>

This command lets you change which toolbar is used for the File Display. If you don't specify a name the default File Display Toolbar is selected.

Multiple toolbars can be specified, separated by a comma.

Example: Set FDBTOOLBAR "My FDB Toolbar"
Example: Set FDBTOOLBAR "File Display,Images"

!static

Turns off the FDB toolbar altogether (reverting to a static header).

Example: Set FDBTOOLBAR !static

FLATVIEW

/K

on

Turns Flat View mode on in the source file display.

Example: Set FLATVIEW=on

off

Turns Flat View mode off in the source file display.

Example: Set FLATVIEW=off

toggle

Toggles Flat View on or off in the current source file display. If combined with one of the mode keywords (group, mixed, mixednofolders), Flat View will only be turned off if it is currently in the specified mode - otherwise, it will be set to that mode (and turned on if needed).

Example: Set FLATVIEW=toggle,grouped

toggleoff

Toggles Flat View on or off. Unlike toggle, Flat View will be turned off if it is currently enabled in any mode, even if the mode does not match the specified keyword.

Example: Set FLATVIEW=mixednofolders,toggleoff

grouped

Sets Flat View to Grouped mode.

Example: Set FLATVIEW=grouped

mixed

Sets Flat View to Mixed mode.

Example: Set FLATVIEW=toggle,mixed

mixednofolders

Sets Flat View to Mixed (No Folders) mode.

Example: Set FLATVIEW=mixednofolders,on

keepformat

Lets you toggle Flat View without changing the current folder format. (Like disabling the Flat View format in Preferences, but only for the current change.) This can be useful if you usually want the location column added, but don't want it when using a particular button. It can also be useful if you want to set up columns and filtering in the file display before switching Flat View on, to reduce overheads (calculating columns you didn't want) and visual noise (things appearing in the file display, only to be removed immediately).

As an example, this toggles Flat View with all files hidden and the Full Path column visible (and Location and Relative Location columns removed, if present):

@if:Set FLATVIEW=grouped
Set FLATVIEW=off,keepformat
Set HIDEFILTERFILENAME
Set FORMAT=!folder
@if:else
Set HIDEFILTERFILENAME=*
Set COLUMNSREMOVE=path,pathrel
Set COLUMNSADD=fullpath(1)
Set FLATVIEW=grouped,keepformat

FOLDERTREESIZE

/K

<size>[,<size>][,left|right|dest]

Adjusts the size of the folder tree pane in the active Lister. The size is given as an absolute width in pixels. It is possible to specify two separate sizes, and the command will toggle between them. You can also make the command operate on a folder tree other than the one attached to the current source file display by appending the left, right or dest keywords.

Example: Set FOLDERTREESIZE 200,300

FORMAT

/K

<format>

Applies the named favorite folder format to the current source file display. The format must have been previously created through the Folders / Folder Formats Preferences page.

Example: Set FORMAT "Photo Viewing"

!default

Applies the Folder Type format applicable to the source file display's path. For example, if the current path is a network drive, the Network Drives format would be applied.

Example: Set FORMAT=!default

!factory

Applies the hardcoded, factory-default folder format to the current source file display.

Example: Set FORMAT !factory

!folder

Finds and applies a folder format by using the same rules as when the folder was initially loaded. This generally gives you what you would get if you opened the current folder in a new window. See the Folders / Folder Formats Preferences page for a description of the rules applied when Opus chooses a folder format for a path.

Example: Set FORMAT !folder

!user

Applies the User Default folder format to the current source file display.

Example: Set FORMAT !user

FORMATLOCK

/K

on

Turns the format lock on in the current Lister. By default this works on the active file display (the one with focus) but you can combine with the other arguments to control which file displays are affected.

Example: Set FORMATLOCK=on

off

Turns the format lock off in the active file display.

Example: Set FORMATLOCK=off

toggle

Toggles the format lock on or off in the current Lister. This command can replace the padlock icon in the default status bar. If combined with the all keyword in a dual display Lister, this will turn the format lock on in both file displays if neither or one are currently on. Only if both are already on will the lock be turned off.

Example: Set FORMATLOCK=toggle,all

left

Applies the format lock to only the left (or top) file display in a dual-display Lister.

Example: Set FORMATLOCK=toggle,left

right

Applies the format lock to only the right (or bottom) file display.

Example: Set FORMATLOCK=toggle,right

source

Applies the format lock to only the source file display in a dual-display Lister.

Example: Set FORMATLOCK=toggle,source

dest

Applies the format lock to only the destination file display.

Example: Set FORMATLOCK=toggle,dest

all

Applies the format lock to both file displays in a dual-display Lister (or the single display otherwise).

Example: Set FORMATLOCK=off,all

FTPMODE

/K

ascii

Sets the file transfer mode for the current FTP connection to ASCII. This command has no effect if the source file display is not currently viewing a remote FTP site.

Example: Set FTPMODE=ascii

binary

Sets the transfer mode to binary for the current FTP connection.

Example: Set FTPMODE=binary

auto

Automatically selects the transfer mode based on the file type being transferred.

Example: Set FTPMODE=auto

GLOBALHIDEFILENAME

/O

(no value)

Clears the Global hide filter filename filter (on the Filters page in Preferences).

Example: Set GLOBALHIDEFILENAME

<pattern>

Sets the Global hide filter filename filter to the specified wildcard pattern.

The supplied pattern can be prefixed with regex: to specify the pattern is a regular expression.

If the filter is already set to the specified pattern, it will be cleared, making the command automatically act as a toggle.

Example: Set GLOBALHIDEFILENAME "(desktop.ini|*.db)"
Example: Set GLOBALHIDEFILENAME regex:.db$

GLOBALHIDEFOLDERS

/O

(no value)

Clears the Global hide filter folder filter (on the Filters page in Preferences).

Example: Set GLOBALHIDEFOLDERS

<pattern>

Sets the Global hide filter folder filter to the specified wildcard pattern.

The supplied pattern can be prefixed with regex: to specify the pattern is a regular expression.

If the filter is already set to the specified pattern, it will be cleared, making the command automatically act as a toggle.

Example: Set GLOBALHIDEFOLDERS .svn

GRIDLINESH

/K

on

Turns horizontal grid lines on in the current file display (only visible in power or details view modes). This command overrides the settings in Preferences (on either the File Display Modes / Power Mode or File Display Modes / Details pages), but changes are only applicable to the current source file display - the global Preferences settings are not modified.

Example: Set GRIDLINESH on

off

Turns horizontal grid lines off in the current file display.

Example: Set GRIDLINESH off

toggle

Toggles horizontal grid lines on or off in the current file display. If the reset keyword is also given, the command will toggle between the grid lines specified in the command line, and the current Preferences settings.

Example: Set GRIDLINESH=toggle

reset

Resets the horizontal grid lines settings in the current file display to those defined in Preferences. You can combine this with the toggle keyword to toggle between the Preferences settings and another set of custom settings.

Example: Set GRIDLINESH=reset,toggle,solid

<style>

Sets horizontal grid lines to use the specified style. Use this keyword in conjunction with the on, off or toggle keywords to control which style is displayed by the command.

Supported styles are solid, alternate, dot, dash, dashdot, dashdotdot and fill. Note that solid indicates a solid unbroken single-pixel line, whereas fill indicates alternating rows (i.e. thick lines which fill the whole background of every second row).

Example: Set GRIDLINESH=toggle,solid

color=<color>

Sets the color of the horizontal grid lines. <color> can be specified in either decimal format (rrr,ggg,bbb) or hex format (#rrggbb). Because the color= keyword contains an equals sign, you must enclose the whole value for the GRIDLINES argument in quotes to avoid confusing the command parser.

Example: Set GRIDLINESH "toggle,fill,color=#ff8000"

opacity=<opacity>

Sets the opacity of the horizontal gridlines. <opacity> must be a value from 1 (nearly transparent) to 100 (solid). Because the opacity= keyword contains an equals sign, you must enclose the whole value for the GRIDLINES argument in quotes to avoid confusing the command parser.

Example: Set GRIDLINESH "toggle,solid,color=#808080,opacity=50"

GROUPBY

/K

<column>

Groups the current file display by the specified column. The value must be one of the valid column keywords.

As well as the column keywords, GROUPBY recognizes the special keyword synonyms accessed, created, date, disksize, modified, path and size. This lets you group by date, size or path without needing to know the exact column that is displayed (e.g. the column could be size, sizekb or sizerel - but the sorting is the same in all cases, and Set GROUPBY=size would work for any column).

If you have any evaluator grouping schemes defined for the specified column, you can use the GROUPSCHEME argument to select one.

The GROUPBY argument also recognizes the special keywords dupes and cdstage. These do not correspond with columns, and are only valid in certain folders.

Set GROUPBY=dupes can only be used in a file collection that has been used as the target of a Duplicate Files search (to group the list by the duplicate file groups found), and Set GROUPBY=cdstage can only be used on a recordable CD/DVD to group the list into files waiting to be burned and files already on the disk.

Example: Set GROUPBY=picsize

Within the Lister Column HeaderContext Menu, you can use %header% to refer to the column which was right-clicked.

Example: Set GROUPBY=%header%,toggle

toggle

Toggles grouping by the specified column on or off. Note that the column name must come first.

Example: Set GROUPBY=picsize,toggle

off

Turns grouping off in the current file display.

Example: Set GROUPBY=off

grouplist

When used on a toolbar or menu, the command will turn into a dynamic list of available columns which can be grouped by. Add the GROUPSCHEME argument to display sub-menus for any grouping schemes defined for those columns.

Example: Set GROUPBY=grouplist GROUPSCHEME

GROUPCOMBINE

/K

normal

Sets the Grouping / Combine option to Combine similar values in the folder format for the current file display. This is the default grouping behaviour. For example, when grouping by filename, you might have groups for names beginning with A-H, I-P and Q-Z.

Example: Set GROUPCOMBINE=normal GROUPBY=name

never

Never combines group values. If this is turned on and the file display is grouped, one group will be created for each distinct value rather than a range of values falling into a single group (e.g. instead of A-H you would have A, B, C, D, E, F, G, H). This is only really useful for text fields like "User description".

Example: Set GROUPCOMBINE=never

other

Groups will be combined as with the normal option, but groups with only one item in them are further combined into a special group called Other.

Example: Set GROUPCOMBINE=other

cycle

Cycles through the three grouping modes.

Example: Set GROUPCOMBINE=cycle

GROUPREVERSE

/K

on

Reverses the direction of grouping in the current file display. The actual order of the groups is reversed, not the order of files within the groups.

Example: Set GROUPREVERSE=on GROUPBY=picsize

off

Turns reverse grouping off.

Example: Set GROUPREVERSE=off

toggle

Toggles reverse grouping on or off in the current file display.

Example: Set GROUPREVERSE=toggle

HEADING

/O

(no value)

When used with commands which generate a list of items (see dynamic buttons), the HEADING argument adds a small heading at the start of the list. The heading will be hidden when the list is empty. Headings only happen for commands which potentially generate multiple items at the same level as the button itself.

When HEADING is used by itself, without specifying a text value, the main button's label text is used for the heading.

Example: Set COLUMNSTOGGLE=columnlist HEADING

<heading text>

You can specify the heading text if you want it to be different to the button's label.

Example: Set SORTBY=sortlist HEADING="Sort"

HIDEEXT

/K

on

Turns the Hide file extension in Filename column option on in the current file display.

Example: Set HIDEEXT=on

off

Turns the Hide file extension option off.

Example: Set HIDEEXT=off

toggle

Toggles the Hide file extension option on or off in the current file display.

Example: Set HIDEEXT=toggle

HIDEFILTERFILENAME

/O

(no value)

Clears the filename hide filter in the source file display. This modifies the folder options for the current folder - the equivalent setting in the Folder Options dialog is Filters / Hide Filter / Filename.

Example: Set HIDEFILTERFILENAME

<pattern>

Sets the filename hide filter in the source file display to the specified wildcard pattern. Files that match the pattern will be hidden from the display of the current folder.

The supplied pattern can be prefixed with regex: to specify the pattern is a regular expression.

If the specified pattern is already set as the filter, the filename filter will be cleared, making the command automatically work as a toggle.

Example: Set HIDEFILTERFILENAME *.(jpg|bmp|png|gif)

HIDEFILTERFOLDERS

/O

(no value)

Clears the folders hide filter in the source file display. This modifies the folder options for the current folder - the equivalent setting in the Folder Options dialog is Filters / Hide Filters / Folder Names.

Example: Set HIDEFILTERFOLDERS

<pattern>

Sets the folders hide filter in the source file display to the specified wildcard pattern. Folders whose name matches the pattern will be hidden from the display of the current folder.

The supplied pattern can be prefixed with regex: to specify the pattern is a regular expression.

If the specified pattern is already set as the filter, the name filter will be cleared, making the command automatically work as a toggle.

Example: Set HIDEFILTERFOLDERS .svn

ICONMODESORTHEADER

/K

on

Turns on the display of the column header (for sorting) in the icon modes (large icon, thumbnail, etc). This controls the Show sort header in icon modes on the File Displays / Options page in Preferences.

Example: Set ICONMODESORTHEADER=on

off

Turns off the column header in the icon modes.

Example: Set ICONMODESORTHEADER=off

toggle

Toggles the icon mode column header on and off.

Example: Set ICONMODESORTHEADER=toggle

IMAGEASPECTOVERLAYS

/K

on

Turns on display of thumbnails-mode aspect ratio bars. This modifies the Overlay aspect ratio bars option on the File Display Modes / Thumbnails page in Preferences. As this is a global setting, all currently open Listers will be affected.

Example: Set IMAGEASPECTOVERLAYS=on

off

Turns off display of thumbnails-mode aspect ratio bars.

Example: Set IMAGEASPECTOVERLAYS=off

toggle

Toggles display of thumbnails-mode aspect ratio bars on or off.

Example: Set IMAGEASPECTOVERLAYS=toggle

JOBSBAR

/K

on

Displays the jobs bar in the current Lister.

Example: Set JOBSBAR=on

off

Hides the jobs bar in the current Lister.

Example: Set JOBSBAR=off

toggle

Toggles the jobs bar on and off.

Example: Set JOBSBAR=toggle

LAYOUT

/K

remember

Remembers the current layout and appearance of the active Lister.

Example: Set LAYOUT=remember

restore

Restores the previously remembered layout and appearance of the active Lister. For example, if you run the Set LAYOUT=remember command, and then make changes to the Lister like closing the tree, opening the viewer pane, or selecting a new style, the Set LAYOUT=restore command would restore the Lister to its original state.

Example: Set LAYOUT=restore

LISTERPOS

/K

<x>,<y>

Sets the position of the active Lister to the specified x and y coordinates. You can also specify a delta to modify the current position.

Example: Set LISTERPOS=500,200
Example: Set LISTERPOS=+100,+50

LISTERTITLE

/O

(no value)

Resets the title of the current Lister back to its default.

Example: Set LISTERTITLE

<custom title>

Sets a custom title for the currently active Lister. You can use several special "tokens" in the title string to insert various pieces of information:

Example: Set LISTERTITLE "Directory Opus - %N"

This command normally act as a toggle, such that the title will be cleared if you run the command when the specified title is already set. You can prevent this by prefixing the title with "notoggle:". This can be useful in event-driven scripts which may make redundant requests to set the title and would have to check its current value to avoid resetting it otherwise.

Example: Set LISTERTITLE "notoggle:Directory Opus - %N"

The %! code lets you hide sections in the string where all other tokens inside the section are empty.

Example: Set LISTERTITLE "%!%T - %!Directory Opus"

That means that if the %T token expands to an empty string, the result will be just "Directory Opus" rather than " - Directory Opus".

MANUALSORTRESET

/O

(no value)

Resets the current manual sort order for the folder in the source file display. The file list will be resorted using the current (non-manual) sort method and your old manual sort order will be discarded.

Example: Set MANUALSORTRESET

<name>

Resets the named manual sort order for the current folder. The name must first have been configured using the manual_sort_names option on the Miscellaneous / Advanced page in Preferences.

Example: Set MANUALSORTRESET=MySortOrder

!default

Resets the default manual sort order for the current folder.

Example: Set MANUALSORTRESET=!default

!all

Resets all manual sort orders (default and named) for the current folder.

Example: Set MANUALSORTRESET=!all

METAPANE

/K

on

Turns the metadata pane on in the currently active Lister.

Example: Set METAPANE=on

off

Turns the metadata pane off in the active Lister.

Example: Set METAPANE=off

toggle

Toggles the metadata pane on or off.

Example: Set METAPANE=toggle

horiz

Forces the metadata pane to horizontal layout when it is opened.

Example: Set METAPANE=toggle,horiz

vert

Specifies vertical layout for the metadata pane.

Example: Set METAPANE=on,vert

togglelayout

Toggles the layout of the metadata pane between vertical and horizontal.

Example: Set METAPANE=togglelayout

MINIMIZEPROGRESS

/K

on

Turns on the Minimize progress indicators automatically option from the Progress Indicators page in Preferences.

Example: Set MINIMIZEPROGRESS=on

off

Turns the Minimize progress indicators automatically option off.

Example: Set MINIMIZEPROGRESS=off

toggle

Toggles Minimize progress indicators automatically on or off.

Example: Set MINIMIZEPROGRESS=toggle

NOOP

/S

(no value)

Guaranteed not to do anything. If specified, other arguments are ignored. Can be used to create a hotkey which does nothing, so pushing that key won't trigger Find-As-You-Type or anything else.

Example: Set NOOP

PRESET

/K

<preset name>

When used in conjunction with the UTILITY argument, this lets you open the Find/Duplicates/Synchronize panel and automatically load the specified preset.

Example: Set UTILITY=Find,Toggle PRESET=WorkDocuments

QUICKFILTER

/O

(no value)

Displays the Filter Bar and gives keyboard focus to the pattern field on it. Similar to pushing the * key under the default keyboard configuration.

Example: Set QUICKFILTER

<pattern>

Sets the quick filter in the current source file display to the specified wildcard pattern. This is the same filter edited by the Filter Bar. Files that do not match the pattern will be hidden from the display.

Normally, if the filter is already set to the specified pattern, it will be cleared, making the command work as a toggle automatically.

Example: Set QUICKFILTER=*.jpg

You can prevent the automatic toggling by prefixing the pattern with "notoggle:".

Example: Set QUICKFILTER="notoggle:Hello World.*"

!clear

Clears the quick filter pattern in the current file display. Note that this does not clear the QUICKFILTERFLAGS value, and so it's possible that files may remain filtered out even after the filter pattern is cleared. Use the QUICKFILTERCLEAR argument to clear the quick filter completely.

Example: Set QUICKFILTER=!clear

!prev

Restores the previous quick filter in the current file display. By default the quick filter is cleared when changing folders (although this can be changed with the Clear Quick filter automatically when changing folders option on the File Displays / Filter Bar page in Preferences). For example, you could assign a hotkey to restore the previous filter after having gone into a sub-directory and then back again to the parent.

Example: Set QUICKFILTER=!prev

QUICKFILTERFLAGS

/O

(no value)

Resets and clears the quick filter flags in the current source file display. The flags are as listed below. Clearing the flags does not clear the filter pattern, so it's possible that files may remain filtered out even after the flags are cleared.

Example: Set QUICKFILTERFLAGS

Alternatively, use the QUICKFILTERCLEAR argument to clear the quick filter completely, both pattern and flags.

set

When combined with other flags, ensures they are only ever turned on. Without set or clear, the other specified tags will be toggled, i.e. turned on if off and off if on.

Example: Set QUICKFILTERFLAGS=set,showfiles

clear

When combined with other flags, ensures they are only ever turned off. Without set or clear, the other specified tags will be toggled, i.e. turned on if off and off if on.

Example: Set QUICKFILTERFLAGS=clear,showfiles

showfiles

Shows all files, even if they are hidden by the filter pattern. This does not override folder format or global filters.

Example: Set QUICKFILTERFLAGS=showfiles

Turning on showfiles will automatically turn off hidefiles.

showdirs

Shows all folders, even if they are hidden by the filter pattern.

Example: Set QUICKFILTERFLAGS=showdirs QUICKFILTER="a*"

Turning on showdirs will automatically turn off hidedirs.

hidefiles

Hides all files, even if they match the filter pattern.

Example: Set QUICKFILTERFLAGS=hidefiles

Turning on hidefiles will automatically turn off showfiles, and also turns off hidedirs unless set is also specified.

hidedirs

Hides all folders, even if they match the filter pattern.

Example: Set QUICKFILTERFLAGS=hidedirs

Turning on hidedirs will automatically turn off showdirs, and also turns off hidefiles unless set is also specified.

disable

Temporarily disables the quick filter, leaving the filter pattern intact.

Example: Set QUICKFILTERFLAGS=disable

flatviewon

Enables filtering of folders when in Flat View, overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=flatviewon

flatviewoff

Disables filtering of folders when in Flat View, overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=flatviewoff

regexpon

Turns on regular expressions (instead of wildcards), overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=regexpon

regexpoff

Turns off regular expressions (i.e. forces wildcards), overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=regexpoff

ignorediacriticson

Turns on the "ignore diacritics" option, overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=ignorediacriticson

ignorediacriticsoff

Turns off the "ignore diacritics" option, overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=ignorediacriticsoff

anywordon

Turns on the "match any word" option, overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=anywordon

anywordoff

Turns off the "match any word" option, overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=anywordoff

partialon

Turns on the "partial matching" option, overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=partialon

partialoff

Turns off the "partial matching" option, overriding the global Preferences setting.

Example: Set QUICKFILTERFLAGS=partialoff

RECYCLEBINEMPTY

/S

(no value)

This has no effect as a command - its only use is with the @ifset and @icon command modifiers. It lets you test if the recycle bin is currently empty.

Example:

@ifset:RECYCLEBINEMPTY
@confirm The recycle bin is 
 empty!
@ifset:else
Delete EMPTYRECYCLE

RELATIVESIZEGRAPHS

/K

on

Turns on the Show graphs behind size columns option on the File Display Columns / Options page in Preferences. As this is a global setting, all currently open Listers will be affected.

Example: Set RELATIVESIZEGRAPHS=on

off

Turns off the Show graphs behind size columns option.

Example: Set RELATIVESIZEGRAPHS=off

toggle

Toggles the Show graphs behind size columns option on or off.

Example: Set RELATIVESIZEGRAPHS=toggle

SAVEFORMAT

/O

(no value)

Displays the Save Folder Format dialog, which lets you save the folder format in the source file display.

Example: Set SAVEFORMAT

folder

Saves the folder format for the current folder (without displaying the Save Folder Format dialog). You can combine this with the replace and subfolders arguments, or with the clear argument.

Example: Set SAVEFORMAT=folder

all

Saves the current format for all folders (i.e. this makes it the new User default format). You can combine this with the clear, replace and quiet arguments.

Example: Set SAVEFORMAT=all

favorite

Saves the current format as a Favorite Format. You can specify the format name using the FORMAT argument.

Example: Set SAVEFORMAT=favorite FORMAT "My Fave Format"

subfolders

Use with the folder argument to save the folder format for the current folder and all sub-folders.

Example: Set SAVEFORMAT=folder,subfolders

replace

Use with the folder or all arguments to replace any existing folder formats within layouts and styles with the new format.

Example: Set SAVEFORMAT=all,replace

clear

Use with the folder argument to delete the saved format (if any) for the current folder.

Example: Set SAVEFORMAT=folder,clear

Use with the all argument to clear any existing saved folder formats (so that the new User default format will be used).

Example: Set SAVEFORMAT=all,clear

After clearing formats, you can tell a folder tab to re-evaluate the format for its current path via Set FORMAT=!folder or similar.

quiet

Use with the all argument to suppress the warning dialog before replacing all existing folder formats.

Example: Set SAVEFORMAT=all,replace,quiet

SHOWFILTERATTR

/O

(no value)

Clears the attributes show filter in the source file display. This modifies the folder options for the current folder - the equivalent setting in the Folder Options dialog is Filters / Show Filter / Attributes.

Example: Set SHOWFILTERATTR

<attributes>

Sets the attributes show filter in the source file display. Only files that have the specified attributes set will be displayed - all others will be hidden.

The <attributes> value is one or more of the following letters: R (read-only), A (archive), H (hidden), S (system), E (encrypted), C (compressed), O (offline), I (non-indexed), P (pinned). See Changing Attributes for detailed descriptions.

Example: Set SHOWFILTERATTR e

If the specified attributes are already set as the filter, the filter will be cleared, making the command automatically act as a toggle. You can also specify two sets of attributes, and the command will alternate between them each time it is run.

Example: Set SHOWFILTERATTR e,ra

SHOWFILTERFOLDERATTR

/O

(no value)

Clears the folder attributes show filter in the source file display. This modifies the folder options for the current folder - the equivalent setting in the Folder Options dialog is Filters / Show Filter / Folder Attributes.

Example: Set SHOWFILTERFOLDERATTR

<attributes>

Sets the folder attributes show filter in the source file display. Only folders that have the specified attributes set will be displayed - all others will be hidden.

The <attributes> value is one or more of the following letters: R (read-only), A (archive), H (hidden), S (system), E (encrypted), C (compressed), O (offline), I (non-indexed), P (pinned). See Changing Attributes for detailed descriptions.

Example: Set SHOWFILTERFOLDERATTR o

If the specified attributes are already set as the filter, the filter will be cleared, making the command automatically act as a toggle. You can also specify two sets of attributes, and the command will alternate between them each time it is run.

Example: Set SHOWFILTERFOLDERATTR o,off

off

Disables the separate folder attributes show filter. When the folder attributes filter is disabled, the regular attributes filter will apply to both files and folders.

Example: Set SHOWFILTERFOLDERATTR off

SHOWMILLIS

/K

on

Turns on the display of milliseconds in file time columns. This controls the Show milliseconds option on the File Display Columns / Options Preferences page. Note that seconds must also be displayed for this command to have any effect.

Example: Set SHOWMILLIS=on

off

Turns off the display of milliseconds in file time columns.

Example: Set SHOWMILLIS=off

toggle

Toggles the display of milliseconds on or off.

Example: Set SHOWMILLIS=toggle

SIDE

/K

left

When tested as a condition, returns true if the command is on a location bar toolbar attached to the left (or top) file display.

Example: @icon:copysourcedest_right,Set SIDE=left

right

True when attached to the right (or bottom) file display.

Example: @icon:copysourcedest_left,Set SIDE=right

SORTNAMEEXTSEPARATELY

/K

on

Turns the Sort name and extension separately option on in the source file display. This modifies the Folder Options for the current folder.

Example: Set SORTNAMEEXTSEPARATELY=on

off

Turns the Sort name and extension separately option off.

Example: Set SORTNAMEEXTSEPARATELY=off

toggle

Toggles the Sort name and extension separately option on or off in the current file display.

Example: Set SORTNAMEEXTSEPARATELY=toggle

SORTNUMERIC

/K

on

Turns the Numeric order filename sorting option on in the source file display. This modifies the Folder Options for the current folder.

Example: Set SORTNUMERIC=on

off

Turns the Numeric order filename sorting option off.

Example: Set SORTNUMERIC=off

toggle

Toggles the Numeric order filename sorting option on or off in the current file display.

Example: Set SORTNUMERIC=toggle

SORTREVERSE

/K

on

Reverses the sort order in the current file display. If the list is only sorted by one column, the direction of that column sort is reversed. If multiple columns are selected for sorting, their directions are not altered but the overall result is reversed as the final step in the sorting.

This modifies the Folder Options for the current folder.

Example: Set SORTREVERSE=on

off

Turns the reverse sort flag off for the current folder, restoring the sort order to normal.

Example: Set SORTREVERSE=off

toggle

Toggles reverse sort on or off in the current folder.

Example: Set SORTREVERSE=toggle

togglesmart

Toggles reverse sort on or off in the current folder. If used with the SORTBY argument on the same command line, this argument operates slightly differently to toggle. If the column specified for SORTBY is already sorted, the sort order will be reversed, but if the specified column is not already sorted, the sort order will not be reversed.

To illustrate this, imagine the list is currently sorted forwards by name, and the command Set SORTBY=size SORTREVERSE=toggle is run multiple times. The resulting sort orders after each iteration would be:

1. Sorted by name, forwards
2. Sorted by size, backwards
3. Sorted by size, forwards

Contrast this with the command Set SORTBY=size SORTREVERSE=togglesmart:

1. Sorted by name, forwards
2. Sorted by size, forwards
3. Sorted by size, backwards

Example: Set SORTBY=desc SORTREVERSE=togglesmart

SOUNDS

/K

on

Turns on the Enable Sound Events option on the Miscellaneous / Sounds page in Preferences.

Example: Set SOUNDS=on

off

Turns off the Enable Sound Events option.

Example: Set SOUNDS=off

toggle

Toggles the Enable Sound Events option on or off.

Example: Set SOUNDS=toggle

SPACING

/K

<item>:<value>

Modifies the spacing of various user interface elements (those that can be changed by a user interface spacing scheme).

You can specify one or more items, separated by commas, and provide either new absolute values or positive or negative deltas, for each item.

The item keywords are:
detailslinespacing, detailslinepadding, powerlinespacing, powerlinepadding, pathiconleft, pathiconright, pathlabelleft, pathlabelright, thumbnailspacingh, thumbnailspacingv, tilespacingh, tilespacingv, treepadding, toolbarspacingh, toolbarspacingv, dragdistance, dblclkdistance.

Example: Set SPACING detailslinespacing:+16,powerlinespacing:+16
Example: Set SPACING tilespacingv:20,tilespacingh:32

STATE

/K

source

Sets the currently active Lister to be the source. When a Lister becomes the source, the previous source (if any) becomes the destination, and the previous destination (if any) is turned off. In a dual-display Lister, this command has no effect, because the currently active file display is by definition already the source.

Example: Set STATE=source

dest

Sets the currently active Lister to be the destination. In a dual-display Lister, this is equivalent to Set SOURCE=toggle - the source will become the destination and vice versa.

Example: Set STATE=dest

lockoff

Locks the active Lister as off. When a Lister is locked off, clicking in it will not make it the source or destination - only another Set STATE command can unlock it. This command has no effect in a dual-display Lister.

Example: Set STATE=lockoff

STATUSBARSTYLE

/K

single

Sets the status bar style to one single status bar even in a dual-display Lister.

Example: Set STATUSBARSTYLE=single

dual

One single status bar, with a separate definition in dual-display mode.

Example: Set STATUSBARSTYLE=dual

independent

Separate status bars for left/right file displays, with separate definitions for left and right.

Example: Set STATUSBARSTYLE=independent

independentsame

Separate status bars for left/right file displays, with the same definition for both.

Example: Set STATUSBARSTYLE=independentsame

bottom

Puts the status bar at the bottom of the Lister rather than at the bottom of the file display.

Example: Set STATUSBARSTYLE=dual,bottom

nobottom

Puts the status bar at the bottom of the file display rather than the bottom of the Lister.

Example: Set STATUSBARSTYLE=independentsame,nobottom

glass

Enable glass when the status bar is at the bottom of the Lister.

Example: Set STATUSBARSTYLE=bottom,glass

noglass

Disable glass when the status bar is at the bottom of the Lister.

Example: Set STATUSBARSTYLE=bottom,single,noglass

TABWIDTH

/K

<size>

Set the width of the folder tab bar, if it is displayed to the left or right of the file display. (All Set TABWIDTH variants have no effect on the folder tab bar if it is above or below the file display.)

Example: Set TABWIDTH=250

The width you specify will normally be DPI scaled, but you can specify a negative number if you want an absolute pixel width without scaling:

Example: Set TABWIDTH=-300

auto

Auto-size the folder tab bar to fit the labels of the current tabs. (Similar to double-clicking the tab bar's splitter.)

Example: Set TABWIDTH=auto

When auto and both are combined, the two tab bars auto-size to an equal width, wide enough for both sides.

Example: Set TABWIDTH=auto,both

(If you want to auto-size both sides indepdently, run Set TABWIDTH=auto,left and then Set TABWIDTH=auto,right.)

source

Specifies that you want to resize the tab bar for the source file display in a dual-display window. (This is usually implicit and does not need specifying, but can override which file display is affected by buttons on the File Display Toolbar.)

Example: Set TABWIDTH=auto,source

dest

Specifies that you want to resize the tab bar for the destination file display in a dual-display window.

Example: Set TABWIDTH=auto,dest

left

Specifies that you want to resize the tab bar for the left (or top) file display.

Example: Set TABWIDTH=auto,left

right

Specifies that you want to resize the tab bar for the right (or bottom) file display.

Example: Set TABWIDTH=auto,right

both

Specifies that you want to resize the tab bars for both the left and right (or top and bottom) file displays at once.

Example: Set TABWIDTH=300,both

Combining both and auto will resize both sides to the maximum needed by either side. See auto, above, for more detail.

thinnest

In a dual-display window, makes both tab bars the same width as the thinnest one.

Example: Set TABWIDTH=thinnest

widest

In a dual-display window, makes both tab bars the same width as the widest one.

Example: Set TABWIDTH=widest

THUMBNAILRATINGS

/K

on

Turns the thumbnail overlay of rating stars on or off. This is a global setting - it modifies the state of the Overlay rating option on the File Display Modes / Thumbnails page in Preferences.

Example: Set THUMBNAILRATINGS=on

off

Turns the ratings overlay off.

Example: Set THUMBNAILRATINGS=off

toggle

Toggles the ratings overlay on or off.

Example: Set THUMBNAILRATINGS=toggle

TREE

/K

on

Turns the folder tree on in the active Lister. In a dual-display Lister, the Open second Folder Tree in dual display mode option on the Folder Tree / Options page in Preferences controls whether a second tree opens automatically - if that option is off, you can use the dual keyword to force a second tree to open as well.

Example: Set TREE=on

off

Turns the folder tree off in the active Lister.

Example: Set TREE=off

toggle

Toggles the folder tree on or off in the active Lister.

Example: Set TREE=toggle

left

Controls the left (or top) folder tree in a dual-display Lister.

Example: Set TREE=left,toggle

right

Controls the right (or bottom) folder tree in a dual-display Lister.

Example: Set TREE=right,toggle

dual

In a dual-display Lister, controls both trees at once.

Example: Set TREE=dual,toggle

source

Controls the folder tree that "belongs" to the source file display.

Example: Set TREE=source,on

dest

Controls the folder tree that belongs to the destination file display.

Example: Set TREE=dest,toggle

TREESHOWPATHTOSEL

/K

on

Turns the folder tree's Highlight path to selected folder option on. This is a global setting and so affects all Listers. When turned on, the additional options on the Folder Tree / Appearance Preferences page apply.

Example: Set TREESHOWPATHTOSEL=on

off

Turns tree path highlighting off.

Example: Set TREESHOWPATHTOSEL=off

toggle

Toggles tree path highlighting on or off.

Example: Set TREESHOWPATHTOSEL=toggle

VIEW

/K

<mode>[,<mode>]

Changes the view mode in the current file display. The valid mode keywords are largeicons, smallicons, list, details, power, thumbnails and tiles.

You can specify two different view modes to create a command that toggles from one mode to the other. With this usage, you can append an asterisk (*) to the view mode keyword to specify that the button should appear highlighted when in that mode.

The cycle keyword can be used to cycle through more than two modes.

Example: Set VIEW=details,thumbnails*

Note that the change does not take place until after the whole command (not just this line) has completed. This usually does not matter, but does if you want to change the view mode and also save it as the folder's new format. Running Set VIEW=thumbnails and then Set SAVEFORMAT=folder in the same command will not work. However, you can combine them into a single line which will work correctly:

Example: Set VIEW=thumbnails SAVEFORMAT=folder

cycle

Cycles through the view modes. If used by itself, this will cycle through all the available view modes - otherwise, combine with the appropriate view mode keywords to create a command that cycles through specific modes.

Example: Set VIEW=largeicons,smallicons,details,cycle

VIEWPANE

/K

on

Turns the viewer pane on in the currently active Lister.

Example: Set VIEWPANE=on

off

Turns the viewer pane off in the active Lister.

Example: Set VIEWPANE=off

toggle

Toggles the viewer pane on or off in the active Lister.

Example: Set VIEWPANE=toggle

horiz

Forces the viewer pane to horizontal layout when it is opened.

Example: Set VIEWPANE=toggle,horiz

vert

Specifies vertical layout for the viewer pane.

Example: Set VIEWPANE=on,vert

togglelayout

Toggles the layout of the viewer pane between vertical and horizontal.

Example: Set VIEWPANE=togglelayout

VIEWPANESHELLICONS

/K

on

Enables shell icons in the viewer pane. See Preferences / Viewer / Viewer Pane / Display shell icons.

Example: Set VIEWPANESHELLICONS=on