BACKLIST

/O

(no value)

Display a list of all previous folders in the history list (acts as a dynamic button). This is used on the drop-down menu attached to the Back button on the default toolbar.

Example: Go BACKLIST

noicons

Does not display icons on the generated history list.

Example: Go BACKLIST=noicons

keys

Assigns the accelerator keys 0 through 9 to the first ten items displayed on the generated history list.

Example: Go BACKLIST=noicons,keys

sort

Sorts the history list alphabetically instead of in chronological order.

Example: Go BACKLIST=sort

CONNECT

/O

(no value)

Display the system dialog that allows you to map a network share to a drive letter.

Example: Go CONNECT

<network path>

Map the specified network path to a drive letter.

Example: Go CONNECT \\server\share

CURRENT

/S

(no value)

Indicates the current source folder. This argument is used to open the current folder in another tab, Lister or file display.

Example: Go CURRENT OPENINDUAL

DISCONNECT

/S

(no value)

Display the system dialog that allows you to disconnect (unmap) a network share.

Example: Go DISCONNECT

DUALPATH

/K

<path to read>

Specify a path to read into the destination file display of a dual-display Lister (the standard PATH argument reads into the source file display).

Example: Go C:\ DUALPATH D:\

EXISTINGLISTER

/O

(no value)

If the specified folder is already open in an existing lister (including inactive folder tabs in other windows) then the command will activate that lister and the appropriate tab within it and do nothing else. If another window is found then the rest of the command's arguments are ignored. If the specified path is not already open in another window then the command continues as if the EXISTINGLISTER argument had not been given.

Example: Go "C:\Program Files" NEW EXISTINGLISTER

seltabsonly

Only selected folder tabs will be considered. If the specified folder is open in an existing lister, but in a folder tab which is not currently selected, then that tab will be ignored.

Example: Go "C:\Program Files" NEW EXISTINGLISTER=seltabsonly

FDBBUTTONS

/O

(no value)

This command acts as a dynamic button. It lets you add buttons to a toolbar that mimic the standard File Display Border buttons. The command is designed to be used on the File Display toolbar as an alternative to the standard buttons.

By default the command will add Back, Forward, Up, Copy, Swap and Toggle Layout buttons. You can use the various keywords to control exactly which buttons are added.

Example:Go FDBBUTTONS

<button keywords>

Use combinations of the keywords back, forward, up, copy, swap and layout to control exactly which buttons are added.

Example:Go FDBBUTTONS back,forward - show Back and Forward buttons
Example:Go FDBBUTTONS -layout - show all but the Toggle Layout button

noicons

Do not display icons for the generated buttons.

Example:Go FDBBUTTONS -layout,noicons

nolabels

Do not display labels for the generated buttons.

Example:Go FDBBUTTONS swap,layout,nolabels

dropdowns

Make the generated buttons drop-down buttons where applicable.

Example:Go FDBBUTTONS back,forward,up,dropdowns

FOLDERCONTENT

/O

(no value)

Display the contents of the path specified by the PATH argument in drop-down menus (acts as a dynamic button). Sub-folders in the generated list can be selected to navigate to that location, and files in the generated list can be selected to open that file. You can also right-click on items to display their context menus, and drag-and-drop files to folders (to copy or move them) or over other files (to open them). If you hover the mouse over a sub-folder it will expand to display another menu showing the contents of the sub-folder.

When used with FOLDERCONTENT only, the PATH argument supports multiple paths separated with a vertical bar (|). For example, this would let you reproduce (to some extent anyway) the Windows start menu in a drop-down menu in a Lister, by showing both the current user's start folder and the common (all users) start folder.

Example: Go /start|/commonstartmenu FOLDERCONTENT

button

Sub-folders in the generated FOLDERCONTENT list will appear as menu buttons. Clicking the button part will read the sub-folder, expanding the drop-down will display its contents.

Example: Go C: FOLDERCONTENT=button

norecurse

Prevents sub-folders in the generated list from being expanded; the list will be limited to a single folder level (although sub-folders will still be displayed, you will not be able to expand them).

Example: Go C: FOLDERCONTENT=norecurse

nodirs

Excludes sub-folders from the generated list - only files will be shown.

Example: Go /temp FOLDERCONTENT=nodirs

nofiles

Excludes files from the generated list - only folders will be shown.

Example: Go C: FOLDERCONTENT=nofiles

showhidden

Includes hidden files and folders in the list - without this, items with the H attribute set will be excluded.

Example: Go C: FOLDERCONTENT=nofiles,showhidden

noparselinks

Prevents shortcuts from being resolved. Without this, a shortcut to a folder will be expandable just like a normal sub-folder.

Example: Go /profile FOLDERCONTENT=noparselinks

showempty

Empty sub-folders will be included in the generated list. Without this, empty sub-folders are excluded.

Example: Go CURRENT FOLDERCONTENT=showempty

filefilter=<pattern>

Specifies a wildcard pattern that the names of files must match to be included in the generated list (without this, all files are included). Because this keyword requires an embedded equals sign, you must enclose the entire argument value in quotes to avoid confusing the command parser.

Example: Go C: FOLDERCONTENT="filefilter=*.exe"

dirfilter=<pattern>

Specifies a wildcard pattern that folder names must match to be included in the generated list (without this, all folders are included). Because this keyword requires an embedded equals sign, you must enclose the entire argument value in quotes to avoid confusing the command parser.

Example: Go C:\Work FOLDERCONTENT="dirfilter=~(.svn)"

maxdepth=<levels>

Specify the maximum number of levels deep that sub-folders can be expanded in the generated list. Because this keyword requires an embedded equals sign, you must enclose the entire argument value in quotes to avoid confusing the command parser.

Example: Go C: FOLDERCONTENT="maxdepth=10"

hideext

Do not show the filename extensions for files in the generated list.

Example: Go /mydocuments FOLDERCONTENT=hideext

sortext

Sorts files in the generated list by file extension.

Example: Go /temp FOLDERCONTENT=nodirs,sortext

sortsize

Sorts files in the generated list by size.

Example: Go "C:\Program Files" FOLDERCONTENT=sortsize

sortdate

Sorts files and folders in the generated list by timestamp.

Example: Go /downloads FOLDERCONTENT=sortdate

sortreverse

Reverse the normal sort order of items in the generated list.

Example: Go /downloads FOLDERCONTENT=sortdate,sortreverse

copy

The generated list is dedicated to copying selected files to the folders shown in the list. This modifies the standard behaviour when you select a sub-folder from the drop-down menu. For example, if you select some files in the current folder, and then choose a sub-folder from the drop-down Go FOLDERCONTENT menu, the files would be copied to that folder.

Example: Go \\NAS\Music FOLDERCONTENT=nofiles,copy

move

Selecting a sub-folder from the generated list will move selected files to that folder.

Example: Go D:\Archive\Documents FOLDERCONTENT=nofiles,move

nomenusel

Hovering over a sub-folder will no longer expand it - instead, you can expand a sub-folder by clicking it. This means it will not be possible to select a sub-folder to navigate to it (unless the button keyword is also given).

Example: Go C: FOLDERCONTENT=nomenusel

dblclickmenu

Both hovering and single-clicking a sub-folder will expanded it, and a double-click will select it to navigate to it.

Example: Go C: FOLDERCONTENT=dblclickmenu

FORWARDLIST

/O

(no value)

Display a list of all subsequent folders in the history list (acts as a dynamic button). This is used on the drop-down menu attached to the Forward button on the default toolbar.

Example: Go FORWARDLIST

noicons

Does not display icons on the generated history list.

Example: Go FORWARDLIST=noicons

keys

Assigns the accelerator keys 0 through 9 to the first ten items displayed on the generated history list.

Example: Go FORWARDLIST=noicons,keys

sort

Sorts the history list alphabetically instead of in chronological order.

Example: Go FORWARDLIST=sort

FTP

/S

(no value)

Displays the FTP Connect dialog, allowing you to make an ad-hoc connection to an FTP site.

Example: Go FTP

FTPSITE

/K

<site name>

Connect to an FTP site listed in the FTP address book. The site must be specified by name, and if the site is in a sub-folder of the address book you must include the complete path of the entry. The FTPSITE argument is the equivalent of prefixing the site entry name with @ in the PATH argument.

Example: Go FTPSITE "Work Servers\Dallas\Production"

FTPSITELIST

/O

(no value)

Displays a list of the sites in the FTP address book (acts as a dynamic button).

Example: Go FTPSITELIST

<site prefix>

Displays the FTP site list starting from a specified sub-folder of the address book.

Example: Go FTPSITELIST "Work Servers"

GROUPEXPAND

/K

<group name>

Expand a specified file group. The group name must match exactly, but you can also use a wildcard pattern to expand all groups matching that pattern.

Example: Go GROUPEXPAND *

IGNOREQUAL

/S

(no value)

Override the default behaviour of the Go command when various qualifiers are held down. By default, holding the Shift key opens a new Lister, the Control key reads the folder into the opposite file display, and the Alt key opens a new tab. If you specify this argument this functionality is disabled. You would use this if you wanted to define your own qualifier-specific behaviour using the @keydown command modifier.

Example: Go IGNOREQUAL

KEYARGS

/K/M

<qualifier:arguments> ...

Provides an alternate way to modify the behaviour of the Go command depending on which qualifier keys are held down (instead of using the @keydown command modifier). This is a multiple value argument - for each qualifier key combination listed, you can define a separate set of arguments that will be used when command is run and that key combination is held.

For example, you could configure a Go button to open a folder in a new tab by default, but in a new Lister if the Control key were held down.

The qualifier part of the value consists of one or more keywords that represent the qualifier keys - ctrl, shift and alt. These can be combined, for example ctrlshift means that both the Control and Shift keys must be held down. You can also use the keyword none to indicate arguments that are applied when no qualifiers are held.

Example: Go FROMSEL KEYARGS "ctrl:NEW" "none:NEWTAB=findexisting"

LASTCRUMB

/S

(no value)

If the file display has a breadcrumbs location field associated with it, and a ghost path is currently shown, this command will go to the last "crumb" in the ghost path.

Example:Go LASTCRUMB

NEW

/O

(no value)

Opens a new Lister. The Default Lister settings are used for the newly opened Lister, although the various other arguments for the Go command can be used to override the settings of the Default Lister.

Example: Go C:\ NEW

<x>,<y>,<w>,<h>

Specify the position and size of the new Lister window. <x> and <y> represent the left and top edge coordinates of the window, and <w> and <h> the width and height.
Example: Go NEW 240,300,640,480

max

Maximize the new Lister window. You can use the <x> and <y> parameters to control which monitor the window appears maximized on.

Example: Go NEW -1024,0,max

min

Minimize the new Lister window. If a size and position is specified as well, it will represent the restored position once you un-minimize (restore) the Lister.

Example: Go NEW 1800,50,1024,768,min

norm

The new Lister window is to be neither minimized nor maximized. Use this to override if the Default Lister is maximized, for example.

Example: Go NEW norm

source

Set the new Lister to be the current source.

Example: Go FROMSEL NEW=source

dest

Set the new Lister to be the destination.

Example: Go C:\Backup NEW=dest

lockoff

The new Lister will be set as "off" - neither source nor destination.

Example: Go NEW=off

tree

Opens the folder tree in the new Lister.

Example: Go C:\Windows NEW=tree

notree

Does not open the folder tree in the new Lister.

Example: Go NEW=0,0,640,480,notree

dual

Open the new Lister in dual-display mode, layed out vertically.

Example: Go NEW=dual C:\ DUALPATH D:\

dualhoriz

Opens the new Lister in dual-display mode, layed out horizontally.

Example: Go NEW=dualhoriz FROMSEL

nodual

Opens the new Lister in single-display mode.

Example: Go NEW=nodual

viewpane

Displays the viewer pane in the new Lister.

Example: Go NEW=viewpane

noviewpane

Does not display the viewer pane in the new Lister.

Example: Go NEW=noviewpane,notree

findpanel

Displays the utility panel in Find Files mode in the new Lister.

Example: Go CURRENT NEW=findpanel

syncpanel

Displays the utility panel in Synchronize mode in the new Lister.

Example: Go {sourcepath} DUALPATH {destpath} NEW=syncpanel

dupepanel

Displays the utility panel in Duplicate File Finder mode in the new Lister.

Example: Go {sourcepath} NEW=dupepanel

noutilitypanel

Do not display the utility panel in the new Lister.

Example: Go NEW=noutilitypanel

metapane

Displays the metadata pane in the new Lister.

Example: Go NEW=metapane

nometapane

Does not display the metadata pane.

Example: Go NEW=nometapane,noutilitypanel,noviewpane,notree,nodual

NEXTCRUMB

/S

(no value)

If the file display has a breadcrumbs location field associated with it, and a ghost path is currently shown, this command will go to the next "crumb" in the ghost path.

Example:Go NEXTCRUMB

OPENCONTAINER

/O

(no value)

Opens the container (parent folder) of the selected item. In normal folders this is not that useful (since the parent of the selected item is the folder you're already in), but in file collections, libraries and flat view it lets you quickly go to the actual folder where a file is located.

This command also works when multiple items are selected and may cause multiple windows or tabs to open if the selected items come from multiple containers.

This command is used on the default collection item context menu.

Example: Go OPENCONTAINER

target

Derefrerences a shortcut or junction. This is similar to the Find Target button in the system Properties dialog for shortcuts. When you run this command with a shortcut selected, the folder containing the target of the shortcut will be loaded and the target itself will be automatically selected (unless noselect is also given; see below). Similarly, if a junction is selected, you'll be taken the parent of its target and its target will be selected. If the selected item is neither a shortcut nor a junction then the command functions the same as if target had not been specified.

Example: Go OPENCONTAINER=target NEW

noselect

Normally, the item or items in question are selected and made visible in the containing folder. Specifying this argument prevents the selection and just opens the containing folder.

Example: Go OPENCONTAINER=target,noselect NEWTAB

OPENINDUAL

/O

(no value)

The specified folder will be read into the destination file display in a dual-display Lister. The difference between this argument and OPENINDEST is that this will force a single-display Lister into dual-display mode if it is not in that mode already. The default layout (horizontal or vertical) will be used in this case.

Example: Go CURRENT OPENINDUAL

horiz

Force the layout of the dual-display Lister to horizontal (one display above the other).

Example: Go C:\Windows OPENINDUAL=horiz

vert

Force the layout to vertical (side-by-side displays).

Example: Go CURRENT NEWTAB OPENINDUAL=vert

OPENINRIGHT

/O

(no value)

Reads the specified folder into the right-hand (or bottom) file display in a dual-display Lister. If the current Lister is not already in dual-display mode it will be set to that mode automatically. The default layout (horizontal or vertical) will be used in this case.

Example: Go {leftpath} OPENINRIGHT

horiz

Force the layout of the dual-display Lister to horizontal (one display above the other).

Example: Go C:\Windows OPENINRIGHT=horiz

vert

Force the layout to vertical (side-by-side displays).

Example: Go {leftpath} NEWTAB OPENINRIGHT=vert

PATHENTRY

/O

(no value)

Displays the find-as-you-type field in a special mode ("go" mode) that lets you navigate to another folder in the current file display. This command is equivalent to CLI QUICKGO.

Example: Go PATHENTRY

dest

The "Go" field will act on the destination file display rather than the source. Note that it will still appear at the bottom of the source file display, but once you press Enter the folder will be read into the destination.

Example: Go PATHENTRY=dest

left

The "Go" field will act on the left-hand file display, whether it is the source or destination.

Example: Go PATHENTRY=left

right

The "Go" field will act on the right-hand file display.

Example: Go PATHENTRY=right

REFRESHTHUMBS

/O

(no value)

Refreshes thumbnails displayed in the current folder. If thumbnail caching is enabled the cache for the current folder is cleared, forcing thumbnails to be regenerated.

Example: Go REFRESHTHUMBS

shift

Refreshes thumbnails only if the Shift key is held down. This lets you combine a normal folder refresh with a thumbnail refresh on the one command - it could perform an ordinary folder refresh by default, and also force the regeneration of thumbnails with the Shift key held down.

Example: Go REFRESH REFRESHTHUMBS=shift

alt

Refresh thumbnails only if the Alt key is held down.

Example: Go REFRESHTHUMBS=alt

ctrl

Refresh thumbnails only if the Control key is held down.

Example: Go REFRESHTHUMBS=ctrl REFRESH=all

ROOTTREE

/S

(no value)

Roots the folder tree to the specified path. Opus will read the path provided, and the tree will be rebuilt to start from that path.

Example: Go C:\ ROOTTREE

SWAP

/S

(no value)

Swaps the folders displayed in the source and destination file displays.

Example: Go SWAP

TABCLOSE

/O

(no value)

Close the current folder tab in the source file display.

You can combine this with the PATH argument to specify the path of a tab that should be closed. When used in this context the PATH argument can accept wildcards - all tabs matching the supplied pattern will be closed. The PATH argument can also be used to specify the index (starting from 0) of a specific tab to close.

Examples:
Close the current tab: Go TABCLOSE
Close all tabs showing a drive on C: Go TABCLOSE PATH=C:\*
Close the first tab: Go TABCLOSE PATH=0

When used from a script, you can pass the default value of a Tab object to specify the tab you wish to close.

Example:Go TABCLOSE=<tab>

left

Close a folder tab in the left (or top) file display, irrespective of whether it is the source or not.

Example:Go TABCLOSE=left

right

Close a folder tab in the right (or bottom) file display.

Example:Go TABCLOSE=right PATH=1

dest

Close a folder tab in the destination file display.

Example:Go TABCLOSE=dest PATH=C:\*

TABDUPLICATE

/O

(no value)

Duplicates the current folder tab.

Example: Go TABDUPLICATE

dual

Creates a duplicate of the current folder tab in the other file display of a dual-display Lister.

Example: Go TABDUPLICATE=dual

TABGROUPLIST

/O

(no value)

Displays a list of your saved Folder Tab Groups (acts as a dynamic button). Selecting a group from the list will open those tabs in the current file display.

Example: Go TABGROUPLIST

keys

Assigns the accelerator keys 0 through 9 to the first ten items displayed on the generated tab group list.

Example: Go TABGROUPLIST=keys

icons

Displays icons for items on the generated tab group list.

Example: Go TABGROUPLIST=keys,icons

TABGROUPSAVE

/O

(no value)

Save the current set of folder tabs as a new tab group. You will be prompted to provide a name for the group.

Example: Go TABGROUPSAVE

<group name>

Save the current set of folder tabs using the specified group name.

Example: Go TABGROUPSAVE "My Tab Group"

!both

In a dual-display Lister, this will save the tabs from both file displays to a single group using the "specific sides" option. You can also specify a group name by following the keyword with a comma. (The group name, if any, must come after the keyword and not before.)

Example:Go TABGROUPSAVE "!both,My Tab Group"

TABLIST

/O

(no value)

Displays a list of the currently open folder tabs (acts as a dynamic button). Selecting a tab from the list will switch to that tab. You can also drag and drop files to the items in the list to copy them to that tab's folder.

By default the tabs shown are those from the current source file display, but you can combine with the OPENINLEFT, OPENINRIGHT and OPENINDEST arguments to display tabs from other file displays.

Example:Go TABLIST

keys

Assigns the accelerator keys 0 through 9 to the first ten items displayed on the generated tab list.

Example: Go TABLIST=keys

sort

Sorts the tab list alphabetically (without this, the items in the list are listed in the same order as the physical tabs). The sort order is based on the folder name (or tab label).

Example:Go TABLIST=sort,keys

sortpath

Sorts the tab list alphabetically, based on the full path of each folder.

Example:Go TABLIST=sortpath

icons

Displays folder icons for each tab in the list.

Example:Go TABLIST=sortpath,icons

nameonly

Only displays the folder name for each tab rather than the full path. This results in the items displaying the same label as the tabs themselves.

Example:Go TABLIST=sort,nameonly

maxwidth=<width>

Specifies a maximum width (in characters) for each item in the list. When showing the full path of each tab, you may want to use this to stop the tab list from being too wide. If not specified, a maximum width of 50 is used by default - you can disable this (and have no maximum width at all) by specifying maxwidth=0.

Note that because this parameter requires an equals sign, you must enclose the whole value of the TABLIST argument in quotes.

Example:Go TABLIST="keys,maxwidth=70"

TABLOCKDIR

/S

(no value)

Indicates the original (locked) directory of the current folder tab. This is the directory that was shown in the tab when it was set to 'Lock Allow Changes' mode. You can use this to return to the locked folder, or open it in another tab or Lister. If the current tab is not locked this argument behaves the same as the CURRENT argument.

Example: Go TABLOCKDIR

TABNAME

/O

(no value)

Clears the name of the current tab if one has been assigned. This will reset the tab label back to the default which is to show the name of the current folder.

Example:Go TABNAME

<tab name>

Assigns the specified name to the current tab. If combined with the NEWTAB argument the name will be assigned to the newly created tab.

Example:Go C:\Work NEWTAB TABNAME "My Work Dir"

TABSCROLL

/O

(no value)

If there are more tabs open than will fit in the display, this command displays the tab overflow menu (useful if you want to bind this to a hotkey). You can combine this with the OPENINDEST, OPENINLEFT and OPENINRIGHT arguments to display the overflow menu in other file displays.

Example: Go TABSCROLL

<delta>

Scroll the folder tabs left or right if there are more tabs open than will fit in the display.

Example: Go TABSCROLL=-1

TABSWAP

/O

(no value)

Swaps the active tab in the left file display with the active tab in the right file display.

Example:Go TABSWAP

<index1>,<index2>

Specify indices to swap a specific tab from the left file display with a specific tab in the right file display.

Example:Go TABSWAP=0,0

TITLE

/K

<custom title>

Specifies a custom title when opening a new Lister using the NEW argument. You can use several special "tokens" in the title string to insert various pieces of information:

        %P - full path of the current (source) folder
        %N - name of the current (source) folder
        %R - drive root of the current (source) folder
        %D - full path of the destination folder
        %M - name of the destination folder
        %L - name of the Layout the Lister came from (if any)
        %T - complete original title (useful for simply adding a prefix or suffix)

Example:Go NEW TITLE "Directory Opus - %N"

UNDOCLOSELISTER

/O

(no value)

Reopens the last Lister that was closed (so if, for example, you accidentally close the Lister you're working with, this command would bring it back).

Example: Go UNDOCLOSELISTER

closeexisting

Reopens the last Lister that was closed, and closes all other open Listers.

Example: Go UNDOCLOSELISTER=closeexisting

USEQUALKEYS

/S

(no value)

Activates pre-configured behaviour for the main qualifier keys - Control will open the favorite folder in the dual-display, Shift in a new Lister and Alt in a new tab.

This is equivalent to KEYARGS ctrl:OPENINDUAL shift:NEW alt:NEWTAB.

Example: Favorites USEQUALKEYS

VIEW

/K

largeicons

Changes the view mode of the new folder to Large Icons mode.

Example: Go CURRENT NEWTAB VIEW=largeicons

smallicons

Changes the view mode of the new folder to Small Icons mode.

Example: Go C:\ VIEW smallicons

list

Changes the view mode to List mode.

Example: Go {destpath} VIEW list

details

Changes the view mode to Details mode.

Example: Go CURRENT LAYOUT=PhotoLayout VIEW=details

power

Changes the view mode to Power mode.

Example: Go NEW VIEW=power

thumbnails

Changes the view mode to Thumbnails mode.

Example: Go /desktop VIEW=thumbnails

tiles

Changes the view mode to Tiles mode.

Example: Go @WorkFTP NEWTAB VIEW tiles