BACK

/S

(no value)

Navigate to the previous folder in the history list. The history list preserves the file selection and scroll offset state of the folder. The BACK argument can be combined with the UP argument; in that case, if the previous folder in the history list is the current folder's parent, Opus will go back (preserving selections, etc) rather than UP.

Example: Go BACK

COMPATIBILITYFILES

/S

(no value)

Switch between a folder and its compatibility store (Vista and above only). Not all folders have compatibility stores - this command will do nothing in that case. For example, from C:\Program Files you would be taken to C:\Users\...\VirtualStore\Program Files, and vice versa.

Example: Go COMPATIBILITYFILES

CURDIR

/S

(no value)

Activates "current directory" mode for the Go command. When used with a drive letter for the PATH argument, this mode makes Opus navigate to the most recently accessed folder on the specified drive. Opus will remember the "current directory" for each drive in your system, even from one session to the next.

When used in conjunction with the DRIVEBUTTONS argument, the generated drive letter buttons will have the same behaviour, and will highlight to indicate the "current drive". In this way you can click around from one drive to another remembering the previously used folder on each drive.

Example:Go D: CURDIR
Example:Go DRIVEBUTTONS=fixed CURDIR

DESTPATH

/S

(no value)

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

Example: Go DESTPATH

DRIVEBUTTONS

/O

(no value)

Display a list of all the drives currently on your system (acts as a dynamic button). Clicking a button navigates the source folder to that drive's root. The drive buttons can also be right-clicked to display the context menu for each drive.

The various values for this argument can be used to restrict the drives that are shown.

Example: Go DRIVEBUTTONS

fixed

Only display the fixed drives (hard drives).

Example:  Go DRIVEBUTTONS=fixed

network

Only display network (mapped) drives.

Example: Go DRIVEBUTTONS=network

cdrom

Only display CD-ROM (and DVD) drives.

Example: Go DRIVEBUTTONS=cdrom

removable

Only display removable drives (floppies, and some USB drives).

Example: Go DRIVEBUTTONS=removable,cdrom

ramdisk

Only display RAM drives.

Example:  Go DRIVEBUTTONS=ramdisk

mtp

Only display MTP (portable) devices.

Example:Go DRIVEBUTTONS=mtp

labels

Displays the label of each drive. By default only each drive's letter is shown.

Example: Go DRIVEBUTTONS=fixed,labels

noletters

Prevents the display of each drive's letter.

Example: Go DRIVEBUTTONS=labels,noletters

multifunc

The generated drive buttons will be multiple function buttons (three-button buttons) - clicking them with the left mouse button will act as if OPENINLEFT were set, the right button will act as if OPENINRIGHT were set, and the middle mouse button will act as if NEW were set.

Example: Go DRIVEBUTTONS=fixed,network,multifunc

multifunctabs

Similar to multifunc, except the left and right mouse button functions will open a new tab on the appropriate side of the Lister.

Example: Go DRIVEBUTTONS=multifunctabs,labels,fixed

lettersbeforelabels

When showing both drive letters and labels, the letters will be displayed first. Without this letters are shown following the labels.

Example: Go DRIVEBUTTONS=fixed,labels,lettersbeforelabels

offline

When showing network drives, only offline drives will be shown (by default both connected and offline drives are shown).

Example: Go DRIVEBUTTONS=network,offline

online

When showing network drives, only online (connected) drives will be shown.

Example: Go DRIVEBUTTONS=network,online

hideempty

Hides the display of empty drives. Removable disks (floppies, card readers, DVDs) that have no media inserted in them will not be displayed.

Example: Go DRIVEBUTTONS=cdrom,removable,hideempty

+<letters>

Only display the specified drive letters. Any drives not specified will be hidden.

Example:Go DRIVEBUTTONS=removable,+fhjm

-<letters>

Do not display the specified drive letters.

Example:Go DRIVEBUTTONS=-d

EJECT

/S

(no value)

Trigger an eject of the media in the drive specified by the PATH argument. This command has no effect if the drive does not have an eject mechanism.

Example: Go D: EJECT

EXPANDTREE

/S

(no value)

Automatically expands the folder tree to display the contents of the new folder. This is only of use if the Automatically expand to current folder option on the Folder Tree / Options Preferences page is turned off.

Example: Go "C:\Program Files\GPSoftware\Directory Opus" NEW EXPANDTREE

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"

LAYOUT

/K

<layout name>

Opens the folder in a new Lister loaded from the specified layout. If the layout contains more than one Lister, only the first Lister is used. The other arguments of the Go command can be used to override the settings in the layout.

Example: Go FROMSEL LAYOUT=Pictures VIEW=details

NEWTAB

/O

(no value)

Opens a new folder tab. If no path is specified (e.g. via the PATH argument) then an empty tab is opened, otherwise the specified path will be loaded into the new tab.

Example: Go C:\ NEWTAB

deflister

If the command is run without a lister then the Default Lister will open along with a new tab for the specified folder. If a lister already exists then a new tab for the specified folder will open normally in the existing lister.

Example: Go C:\ NEWTAB=deflister,findexisting

findexisting

Look for the specified path in existing tabs. If found, the existing tab will be brought to the front - otherwise a new tab will be opened.

Example: Go CURRENT NEWTAB=findexisting OPENINDUAL

nofocus

The new tab will not be made active.

Example: Go CURRENT NEWTAB=nofocus

tofront

Brings the Lister to the front. This is useful when opening a tab in the destination Lister.

Example: Go CURRENT NEWTAB=tofront OPENINDEST

OPENINDEST

/S

(no value)

The specified folder will be read into the destination file display. If the current Lister is not in dual-display mode, then could mean the folder is read into another Lister altogether. You can combine this with NEWTAB to open tabs in the destination.

Example: Go CURRENT OPENINDEST

OPENINLEFT

/S

(no value)

Reads the specified folder into the left-hand (or top) file display in a dual-display Lister. In a single-display Lister, this argument has no effect (the folder will be read into the single display as normal).

Example: Go {rightpath} OPENINLEFT

PATH

(no value)

Specify the path to read (or in conjunction with the FOLDERCONTENT argument, the path to display the contents of).

Opus supports paths in many formats, for example:

• An absolute path like C:\Windows
• A relative path like ..\.. (goes up two levels from the current folder)
• A virtual filesystem URL-style path (e.g. ftp://ftp.microsoft.com or lib://Documents)
• An FTP address-book shortcut (e.g. @MyFtpSite)
• A folder alias like /mydocuments
• An environment variable like %USERPROFILE%
• An external control code like {sourcepath}

This is the default argument for the Go command and so you do not need to specify the PATH keyword. Remember that if the path contains spaces it needs to be enclosed in quotes.

Example: Go "C:\Program Files\GPSoftware\Directory Opus"

REFRESH

/O

(no value)

Refresh the display of the current folder in the source file display.

Example: Go REFRESH 

tree

Refresh the folder tree.

Example: Go REFRESH=tree

both

Refresh both file displays in a dual-display Lister.

Example: Go REFRESH=both

all

Refresh all file displays and folder trees.

Example: Go REFRESH=all

source

Refresh the source file display and its tree.

Example: Go REFRESH=source

dest

Refresh the destination file display and its tree.

Example: Go REFRESH=dest

viewpane

Refresh the viewer pane. The image or file currently displayed in the pane will be reloaded.

Example: Go REFRESH=viewpane

left

Refresh the left-hand file display.

Example: Go REFRESH=left

right

Refresh the right-hand file display.

Example: Go REFRESH=right

ROOT

/O

(no value)

Navigate to the root of the current folder. For example, the root of C:\Program Files\GPSoftware\Directory Opus is C:.

Example: Go ROOT

collapse

Collapses the current drive's branch in the folder tree at the same time as navigating to the root folder.

Example: Go ROOT=collapse

RUNEMBEDDEDIFNOTFOUND

/S

(no value)

This argument is used when embedding a function in the Go FINDTITLE command. Normally the embedded function will not be run if no Listers exist that match the supplied string. If the RUNEMBEDDEDIFNOTFOUND argument is specified, the embedded command will be run in the current Lister if a matching Lister is not found.

Example:Go FINDTITLE PhotoWork RUNEMBEDDEDIFNOTFOUND
             [Set VIEW=Thumbnails]

SWITCHPATH

/K/M

<alternate path> ...

Switches between (or cycles through) two or more paths. The PATH argument is used to provide the first path in the sequence, and then the SWITCHPATH argument provides the second and subsequent paths. When you run this command, Opus looks at the current path shown in the source file display. If it matches one of the provided paths, the next path in the sequence is read (and then the next, and then the next, and so on). If the current path does not match one of the provided ones the first path in the sequence is read.

Example: Go C:\ SWITCHPATH D:\ E:\ F:\ G:\

TABCLOSEALL

/O

(no value)

Close all folder tabs except the current one.

When combined with the TABGROUPLOAD command, this overrides the tab group's Close existing Folder Tabs setting, and forces existing tabs to be closed.

Example: Go TABCLOSEALL

left

Close all folder tabs to the left of the current tab.

Example: Go TABCLOSEALL=left

right

Close all folder tabs to the right of the current tab.

Example: Go TABCLOSEALL=right

force

Forces locked tabs to be closed. Normally locked tabs are not closed by this command.

Example: Go TABCLOSEALL=right,force

expand

Expands tabs to Listers. The tabs will be closed in the current Lister, and each folder opened as a new Lister.

Example: Go TABCLOSEALL=right,expand

no

When combined with the TABGROUPLOAD command, this overrides the tab group's Close existing Folder Tabs setting, and forces existing tabs to be retained.

This value has no meaning when not used in conjunction with TABGROUPLOAD.

Example:Go TABGROUPLOAD=MyTabs TABCLOSEALL=no

TABFINDEXISTING

/S

(no value)

If the specified folder is open in another tab Opus will switch to that tab, otherwise the folder will be read into the current tab. Enables similar behavior to the NEWTAB=findexisting argument, except that a new tab is not opened if the path is not found.

Example:Go /mydocuments TABFINDEXISTING

TABGROUPLOAD

/K

<group name>

Loads the named folder tab group. This can be combined with OPENINDUAL etc. to open the tab group in another file display. You can also combine the TABCLOSEALL argument to override the tab group's Close existing Folder Tabs setting.

Example: Go TABGROUPLOAD "My Tab Group" TABCLOSEALL=no

TABLINK

/K

on

In a dual-display Lister, links the current active tab in the source file display with the current active tab in the destination file display.

Example:Go TABLINK=on

off

If the currently active tab is linked, this will unlink it.

Example:Go TABLINK=off

toggle

Toggles tab linking on or off for the currently active tabs in both left and right file displays.

Example:Go TABLINK=toggle

slave

Use in conjunction with on or toggle to specify that the tab is to be linked as a "slave" (so that it follows the other tab whenever the folder is changed).

Example:Go TABLINK=toggle,slave

TABLOCK

/K

lock

Lock the current folder tab to prevent any folder changes. Attempts to change the folder will result in a new tab being created.

Example: Go TABLOCK=lock

lockchanges

Lock the current tab. Folder changes will be allowed, but the tab will revert to its original (locked) directory if it is clicked, or if the focus is moved to another tab and then back to this one. You can also use the command Go TABLOCKDIR to revert to the original directory.

Example: Go TABLOCK=lockchanges

lockreuse

Lock the current tab. Attempts to change folder will result in the first already existing, unlocked tab being used to read the new directory. A new tab will be opened if there are no unlocked tabs that can be used.

Example: Go TABLOCK=lockreuse

off

Unlock the current folder tab.

Example: Go TABLOCK=off

toggle

Combine with the various lock keywords to toggle that lock mode on or off.

Example: Go TABLOCK=lockchanges,toggle

all

Lock or unlock all folder tabs.

Example: Go TABLOCK=lock,all

left

Lock or unlock all tabs to the left of the current tab.

Example: Go TABLOCK=lockchanges,toggle,left

right

Lock or unlock all tabs to the right of the current tab.

Example: Go TABLOCK=off,right

TABMOVE

/O

(no value)

Move the current folder tab to the other file display. The Lister will be set to dual-display mode if it's not in that mode already.

Example: Go TABMOVE

split

Splits the folder tabs currently open in a single-display Lister. The Lister will be set to dual-display mode, and all tabs from the current tab onwards will be moved to the other display. If the Lister is already in dual-display mode this command has no effect.

Example: Go TABMOVE=split 

splitlister

Splits the folder tabs in the current file display to a new Lister. All tabs from the current tab onwards will be closed in the current display, and reopened in a new Lister.

Example: Go TABMOVE=splitlister

<new position>

Specify the new position for the moved tab. You can specify an absolute position, -1 to indicate the same relative position, and -2 to position the moved tab to the right of the currently active tab. If not specified, the moved tab will be positioned at the end of all existing tabs.

Example:Go TABMOVE=-2

active

If specified, the moved tab will be made active. Otherwise the previously active tab in the other file display remains active.

Example:Go TABMOVE=active,-2

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"

UP

/S

(no value)

Navigate up to the parent of the current folder. You can combine this with OPENINDUAL etc. to open the parent of the current folder in another file display or Lister. This can also be combined with the BACK argument - in that case, if the parent of the current folder is also the previous folder in the history list, Opus will move back rather than up - preserving the file selection and other state of the previous folder.

Example: Go UP

USER

/K

<user name>

Can be used when certain folder aliases are supplied for the PATH argument. This lets you specify an alternative user name, to access a specific user's instance of a system folder (providing you have the appropriate permissions, of course). If the specified alias doesn't support multiple users this argument has no effect. 

Example: Go /desktopdir USER="Leo Nudelson"