ADMIN

/K

on

Turns Administrator mode in in the active Lister. Opus will prompt you for the timeout, after which Administrator mode is automatically deactivated. This function has no effect on Windows XP, or if UAC is disabled.

Example: Set ADMIN=on

off

Turns Administrator mode off in the active Lister.

Example: Set ADMIN=off

toggle

Toggles Administrator mode on or off.

Example: Set ADMIN=toggle

<timeout>

Specify a timeout (in minutes) to suppress the timeout dialog from appearing.

Example: Set ADMIN=toggle,10

If you specify 0 (zero), the timeout is disabled and Administrator mode will stay on in the Lister until the button is pushed again or the window is closed.

Example: Set ADMIN=toggle,0

AUTOSIZECOLUMNS

/O

(no value)

Automatically resizes all columns in the source file display (applies to details and power modes only). This is a one-off width change based on the current column contents, as opposed to setting the columns into autosize mode like the AUTOSIZE argument would do. Another difference is that this will not override columns with maximum widths set, nor ones set to Collapse, and so on.

Example: Set AUTOSIZECOLUMNS

dest

Automatically resizes all columns in the destination file display.

Example: Set AUTOSIZECOLUMNS=dest

left

Resizes all columns in the left (or top) file display of a dual display Lister.

Example: Set AUTOSIZECOLUMNS=left

right

Resizes all columns in the right (or bottom) file display.

Example: Set AUTOSIZECOLUMNS=right

both

Resizes all columns in both file displays of a dual display Lister (or the sole display of a single display Lister).

Example: Set AUTOSIZECOLUMNS=both

focus

Resizes all columns in the file display that currently has input focus. (This is almost always the same as the source file display.)

Example: Set AUTOSIZECOLUMNS=focus

widest

Resizes the columns on both sides of a dual display Lister, setting the columns on both sides to the same width (the widest of the two).

Example: Set AUTOSIZECOLUMNS=widest

CALCFOLDERSIZES

/K

all

Turns on the Preferences option to calculate folder sizes automatically (for all folders). Note that this simply modifies the Preferences setting - any currently open Listers won't calculate their folder sizes until they are refreshed.

Example: Set CALCFOLDERSIZES=all

local

Turns on the option to calculate folder sizes automatically for all local drives.

Example: Set CALCFOLDERSIZES=local

fixed

Turns on the option for all fixed local drives.

Example: Set CALCFOLDERSIZES=fixed

off

Turns automatic folder size calculation off.

Example: Set CALCFOLDERSIZES=off

toggle

Toggles calculation on or off for the specified folder type.

Example: Set CALCFOLDERSIZES=local,toggle

skipjunctions

Specify this flag as well to turn on the Skip junctions and softlinks option.

Example: Set CALCFOLDERSIZES=local,toggle,skipjunctions

CLEARFILTERS

/S

(no value)

Clears all file and folder filters in the current source file display. The filters that are cleared are those controlled by the HIDEFILTERFILENAME, HIDEFILTERFOLDERS, SHOWFILTERFILENAME and SHOWFILTERFOLDERS arguments.

Example: Set CLEARFILTERS

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:

• (<pos>) - Specify the position of the column (0 is the left-most).
• (<pos>,<size>) - Specify both the position and size.
• (<pos>,<size>,<max>) - Specify position, size and maximum width.

The <pos> argument indicates the position to insert the column. This can be a number where 0 represents the left-most column, 1 the second column and so on.

The position 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 <size>, the <pos> argument must be included first. If you want to specify a size without a position, use * for <pos> to have the column added at the end.

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

The <size> argument indicates the width of the new column. This can be a number in pixels, a for Auto, f for Fill, e for Expand and c for Collapse.

The <max> argument lets you specify the maximum width for automatically-sized columns. This can be a number in pixels, or f for Fill.

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

• %header% - Turns into the name of the column which was right-clicked. (Typically used to remove the column which was right-clicked.)
• %headeritem% Turns into the position nearest where you right-clicked. (Typically used to insert a column nearest where you right-clicked.)

If the position is not specified, the column will be added to the end of the existing columns.

Specifying the size of columns only works if the auto-size flag is turned off in Folder Options. If an asterisk (*) is specified for the size value, the column will be automatically sized to fit the content.

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

COLUMNSTOGGLE

/K

<column>, ...

Toggles the specified columns on or off in the current source display. The position and size of added columns can be given as for COLUMNSADD.

You can specify one or more comma-separated column keywords. If more than one column name is provided, the named columns will only be turned off if all specified columns are currently present. Otherwise, those columns not currently present will be added.

Example: Set COLUMNSTOGGLE=desc(2),author
Example: Set COLUMNSTOGGLE=Status(1+Name)

(See the COLUMNSADD argument, above, for detail on how to specify positions if the examples are not clear.)

Within the Lister Column Header Context Menu only:

• You can use %headeritem% for the position to insert columns nearest where you right-clicked instead of at the end.

Example: Set COLUMNSTOGGLE=picwidth(%headeritem%)

any

Makes the command consider similar columns to be the same with regard to toggling.

For example, there are several columns which display file sizes in different units. If Size (Bytes) is the only size column in use, and any is not used, then a command to toggle the Size (KB) column will result in both size columns on at once. Adding any would instead turn off the Size (Bytes) column in that situation and not turn anything on the first time. If the command was then run a second time, with no size column present, then it would add the Size (KB) column.

Example: Set COLUMNSTOGGLE=any,sizekb

columnlist

Specify the columnlist keyword to have Opus automatically generate a list of columns which can be toggled.

The list will appear as a several sub-menus, one for each column category (Name and Path, Date and Time, Picture Metadata, etc.). This is similar to the list in the default Lister Column Header Context Menu.

Example: Set COLUMNSTOGGLE=columnlist

The columnlist keyword is only supported by the COLUMNSTOGGLE argument; the similar COLUMNSADD and COLUMNSREMOVE arguments can't use it, but are unlikely to need it.

insert

The insert keyword, when combined with the columnlist keyword and used in the Lister Column Header Context Menu, causes Opus to insert new columns in the position nearest where the you right-clicked the header. Without it, new columns will be added to the end.

Example: Set COLUMNSTOGGLE=columnlist,insert

The insert keyword does not work without the columnlist keyword or when used outside the Lister Column Header menu. To do something similar in a command which toggles one specific column, use %headeritem% for the position, as documented above.

CONTENTFORMAT

/K

<content group>

Sets the current source file display to use the named content type folder format.

Example: Set CONTENTFORMAT Images

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

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

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

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

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 Folders / Global 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 Folders / Global 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 a solid color fill of alternating colors the height of each 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). 

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.

Example: Set GROUPBY=grouplist

GROUPFOLDERSATTOP

/K

on

Turns on the Keep folders at top when grouped option in the current file display.

Example: Set GROUPFOLDERSATTOP=on

off

Turns off the Keep folders at top when grouped option.

Example: Set GROUPFOLDERSATTOP=off

toggle

Toggles the Keep folders at top when grouped option on or off in the current file display.

Example: Set GROUPFOLDERSATTOP=toggle

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

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 Filter / Folders.

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

INVERT

/S

(no value)

Inverts the appearance of toolbar buttons that appear highlighted (or checked) when the Set option they control is currently on.

For example, a command like Set TREE=toggle will appear highlighted on the toolbar when the folder tree is displayed. Changing the command to Set TREE=toggle INVERT would cause the toolbar button to appear highlighted when the tree is not displayed.

Example: Set HIDESYSTEMFILES=toggle INVERT

KEEPFOLDERSALPHA

/K

on

Turns the Keep folders sorted alphabetically option on in the source file display. This modifies the Folder Options for the current folder.

Example: Set KEEPFOLDERSALPHA=on

off

Turns the Keep folders sorted alphabetically option off.

Example: Set KEEPFOLDERSALPHA off

toggle

Toggles the state of the Keep folders sorted alphabetically option.

Example: Set KEEPFOLDERSALPHA=toggle

LISTERCMD

/K

minimize

Minimizes the currently active Lister window.

Example: Set LISTERCMD=minimize

maximize

Maximizes the currently active Lister window.

Example: Set LISTERCMD=maximize

restore

Restores the original size and position of the window (before it was either minimized or maximized).

Example: Set LISTERCMD=restore

togglemaximize

If the current Lister window is not maximized, it will be maximized, otherwise it will be restored. You could use this to add a hotkey that switches a Lister in and out of "full-screen" mode.

Example: Set LISTERCMD=togglemaximize

showall

Makes all currently open Listers visible. Minimized windows will be restored, and all Lister windows will come to the front.

Example: Set LISTERCMD=showall

minimizeall

Minimizes all currently open Listers.

Example: Set LISTERCMD=minimizeall

tileh

Tiles all currently open Listers horizontally across the screen.

Example: Set LISTERCMD=tileh

tilev

Tiles all Listers vertically across the screen.

Example: Set LISTERCMD=tilev

cascade

Cascades all Lister windows. All windows are made the same size and positioned staggered diagonally down and across the screen.

Example: Set LISTERCMD=cascade

toggleminimizeall

Minimizes all currently open Lister windows. If all windows are already minimized they will all be restored.

Example: Set LISTERCMD=toggleminimizeall

ontopon

Sets the Lister's "on top" state to on (so it appears above all non-topmost windows).

Example: Set LISTERCMD=ontopon

ontopoff

Sets the Lister's "on top" state to off (so it can go behind normal windows).

Example: Set LISTERCMD=ontopoff

tofront

Brings the Lister window to the front. This command is most useful when run from a script.

Example: Set LISTERCMD=tofront

LISTERSIZE

/K

<w>,<h>

Sets the size of the currently active Lister to the specified width and height. You can also specify a delta to modify the current size.

Example: Set LISTERSIZE=1024,768
Example: Set LISTERSIZE=+50,+50

auto

Automatically resizes the Lister horizontally (as much as possible) to exactly fit the currently displayed columns (only in Details or Power mode).
 

Example: Set LISTERSIZE=auto

MANUALSORT

/K

on

Turn on manual sorting in the current file display. The default manual sort order will be used unless alternative manual sort names have been configured and you specify the name using the <name> parameter.
 

Example: Set MANUALSORT=on,MySortOrder

off

Turn off manual sorting in the current source file display.
 

Example: Set MANUALSORT=off

toggle

Toggle the manual sort mode on or off in the current file display.
 

Example: Set MANUALSORT=toggle

<name>

Specifies an alternative name for the sort order to use, which must first have been configured using the manual_sort_names option on the Miscellaneous / Advanced page in Preferences.
 

Example: Set MANUALSORT=MySortOrder,toggle

MANUALSORTSAVE

/S

(no value)

Saves the current manual sort order in the current folder. You would only need to use this command if you don't have automatic saving of manual sort orders enabled.
 

Example: Set MANUALSORTSAVE

METAPANESIZE

/K

<size>[,<size>]

Adjusts the size of the metadata pane in the active Lister. The size is given as a percentage of the total size of the Lister, and applies in the appropriate dimension based on the current layout of the metadata pane (so for example, when the pane is horizontal this affects its height).

It is also possible to specify two separate sizes, and the command will toggle between them.

Example: Set METAPANESIZE 25,50

NOSCRIPT

/S

(no value)

Use the NOSCRIPT argument to prevent script events from firing in response to the Set command. Currently this only works with the Set LISTERCMD=ToFront command, to prevent the OnActivateLister event from being triggered.
 

Example: Set LISTERCMD=ToFront NOSCRIPT

QUICKFILTERCLEAR

/S

(no value)

Clears the quick filter in the current source file display. Both the filter pattern and the flags are cleared. This does not affect filtering caused by folder options or the global filters in Preferences.

Example: Set QUICKFILTERCLEAR

READONLY

/K

on

Makes the current file display read-only. Currently this is only supported by Zip archives. When the file display is marked as read-only, attempts to modify the contents of the current Zip archive will fail. This command has no affect when not viewing a Zip archive.

Example: Set READONLY=on

off

Clears the read-only flag from the current file display. The Open Zip files as read-only by default option on the Zip & Other Archives / Zip Files page in Preferences can make Zip archives read-only by default, and you can then use this command to make them writeable.

Example: Set READONLY=off

toggle

Toggles the read-only flag on or off in the current file display.

Example: Set READONLY=TOGGLE

RELATIVEDATEGRAPHS

/K

on

Turns on the Show relative graphs behind modified date columns option on the Folders / Folder Display page in Preferences. As this is a global setting, all currently open Listers will be affected.
 

Example: Set RELATIVEDATEGRAPHS=on

off

Turns off the Show relative date graphs behind modified date columns option.
 

Example: Set RELATIVEDATEGRAPHS=off

toggle

Toggles the Show relative date graphs behind modified date columns option on or off.
 

Example: Set RELATIVEDATEGRAPHS=toggle

RELDIMENSIONOVERLAYS

/K

on

Turns the display of thumbnails-mode relative dimension bars on. This modifies the Overlay relative dimension 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 RELDIMENSIONOVERLAYS=on

off

Turns the display of thumbnails-mode relative dimension bars off.

Example: Set RELDIMENSIONOVERLAYS=off

toggle

Toggles the display of thumbnails-mode relative dimension bars on or off.

Example: Set RELDIMENSIONOVERLAYS=toggle

SHOWCOMPATIBILITYFILES

/K

on

Turns the Show compatibility files option on in the source file display. This modifies the Folder Options for the current folder. See the section on Compatibility Files for more information about this concept.

Example: Set SHOWCOMPATIBILITYFILES=on

off

Turns the Show compatibility files option off in the source file display.

Example: Set SHOWCOMPATIBILITYFILES=off

toggle

Toggles the Show compatibility files option on or off.

Example: Set SHOWCOMPATIBILITYFILES=toggle

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 Preferences / Folders / Folder Display / Show milliseconds option. 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

SORTBY

/K

<column>, ...

Sorts the current file display by the specified column. The value must be one of the valid column keywords, and the column must also be displayed in the file display.

As well as the column keywords, SORTBY recognizes the special keyword synonyms accessed, created, date, disksize, modified, path and size. This lets you sort 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 SORTBY=size would work for any column).

It is possible to sort the list by multiple columns, by specifying more than one comma-separated keyword. You can also specify that the sort order for a particular column should be reversed by prefixing its keyword with a hyphen.
 

The Set SORTBY command can also be used to automatically add the specified columns to the file display (since a column needs to be displayed in the list in order to sort by it). Prefix the column with a + sign to enable this. If the column is not already in the list it will be added to the end of the existing columns. You can also specify the position where the column should be added if it doesn't already exist - see the description of the Set COLUMNSADD command for details on this.

Example: Set SORTBY=picsize,-modified
Example: Set SORTBY=+datetaken

sortlist

When used on a toolbar or menu, the command will turn into a dynamic list of available columns which can be sorted by.

Example: Set SORTBY=sortlist

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

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

TREELOCK

/K

on

Turns the folder tree lock on for the active Lister (or when there are two trees, for the source file display). This is equivalent to clicking the padlock icon in the folder tree's header, but can be used even if the tree header is turned off in Preferences. When the folder tree is locked it no longer changes selection automatically to follow the current source path.

Example: Set TREELOCK=on

off

Turns the folder tree lock off for the active Lister.

Example: Set TREELOCK=off

toggle

Toggles the folder tree lock on and off.

Example: Set TREELOCK=toggle

TREEROOT

/K

<location>

Rebuilds the folder tree for the current source folder so that it is rooted at the specified location. The folder you specify will appear at the top of the tree, and the file display will change to show the root folder (unless it's already displaying a folder underneath that root).

Example: Set TREEROOT "C:\Program Files"

reset

Resets the root of the folder tree to the root specified by the Start Folder Tree at option the Folder Tree / Options page in Preferences.

Example: Set TREEROOT=reset

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

off

Disables shell icons in the viewer pane.

Example: Set VIEWPANESHELLICONS=off

toggle

Toggles shell icons in the viewer pane on or off.

Example: Set VIEWPANESHELLICONS=toggle

VIEWPANESIZE

/K

<size>[,<size>]

Adjusts the size of the viewer pane in the active Lister. The size is given as a percentage of the total size of the Lister, and applies in the appropriate dimension based on the current layout of the viewer pane (so for example, when the pane is horizontal this affects its height).

It is also possible to specify two separate sizes, and the command will toggle between them.

Example: Set VIEWPANESIZE 25,50