The Go internal command can be used to:
Command Arguments:
Argument |
Type |
Possible values |
Description |
---|---|---|---|
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. |
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. |
|
|
namesonly |
Display only folder names, not full paths. Tooltips will show full
paths when hovering over items. |
|
|
noicons |
Does not display icons on the generated history
list. |
|
|
keys |
Assigns the accelerator keys 0 through
9 to the first ten items displayed on the generated
history list. |
|
|
sort |
Sorts the history list alphabetically instead of in chronological
order. |
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. |
CONNECT |
/O |
(no value) |
Display the system dialog that allows you to map a network share to a
drive letter. |
|
|
<network path> |
Map the specified network path to a drive
letter. |
COPYARGS |
/K/R |
(no value) |
A command like Go FOLDERCONTENT=copy which generates a list of buttons, each of which copies or moves files to or from a different place. Each generated button runs the Opus Copy command, which takes different arguments to the Go command. The COPYARGS argument allows you to specify one or more additional Copy-command arguments which are added to each of the generated buttons. Since this is a "raw" argument, it should be the last thing on the
line. All text after the word "COPYARGS" will be taken as-is, including
any quote characters, and appended to the copy command of each generated
button. |
CURDIR |
/O |
(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. |
|
|
rootmode |
Modifies "current directory" mode so that clicking the button for the
drive you are already on takes you to the root of the drive (ordinarily it
would do nothing). |
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. |
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). |
DISCONNECT |
/S |
(no value) |
Display the system dialog that allows you to disconnect (unmap) a
network share. |
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. |
|
|
fixed |
Only display the fixed drives (hard
drives). |
|
|
network |
Only display network (mapped)
drives. |
|
|
cdrom |
Only display CD-ROM (and DVD)
drives. |
|
|
removable |
Only display removable drives (floppies, and some USB
drives). |
|
|
ramdisk |
Only display RAM drives. |
|
|
mtp |
Only display MTP (portable) devices. |
|
|
iconlettersoff |
Disable the display of small drive letters as part of each drive's
icon. |
|
|
iconletterson |
Enable the display of small drive letters as part of each drive's icon.
Example: Go DRIVEBUTTONS=iconletterson |
|
|
labels |
Displays the label of each drive. By default only each drive's letter
is shown. |
|
|
noletters |
Prevents the display of each drive's letter, if labels are being shown
using the labels keyword. Note that if you want to
completely disable any text being displayed in the button you need to turn
off the button's Show Label checkbox in the button
editor. |
|
|
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. |
|
|
multifunctabs |
Similar to multifunc, except the left and right mouse
button functions will open a new tab on the appropriate side of the
Lister. You can control how new tabs are opened with the
NEWTAB argument. |
|
|
lettersbeforelabels |
When showing both drive letters and labels, the letters will be
displayed first. Without this letters are shown following the
labels. |
|
|
offline |
When showing network drives, only offline drives will be shown (by
default both connected and offline drives are
shown). |
|
|
online |
When showing network drives, only online (connected) drives will be
shown. |
|
|
hideempty |
Hides the display of empty drives. Removable disks (floppies, card
readers, DVDs) that have no media inserted in them will not be
displayed. |
|
|
+<letters> |
Only display the specified drive letters. Any drives not specified will
be hidden. |
|
|
-<letters> |
Do not display the specified drive
letters. |
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). |
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. |
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. |
|
|
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. |
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. |
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. |
|
|
<button keywords> |
Use combinations of the keywords back,
forward, up, copy,
swap and layout to control exactly which
buttons are added. |
|
|
noicons |
Do not display icons for the generated
buttons. |
|
|
nolabels |
Do not display labels for the generated
buttons. |
|
|
dropdowns |
Make the generated buttons drop-down buttons where
applicable. |
FINDTITLE |
/K |
<title string> |
Finds all currently open Listers with titles that match the specified
string, and brings them to the front. The string to search for can be a
specific title or a wildcard
pattern. |
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. |
|
|
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. |
|
|
nomenusel |
Hovering over a sub-folder will expand it, while single-clicking will
navigate to it. Also forces empty folders to be hidden, even if
showempty is also
specified. |
|
|
dblclickmenu |
For folders with sub-items, both hovering and single-clicking will
expand their sub-menus, while double-clicking will navigate to them. For
folders without sub-items, a single-click will be enough to navigate to
them. |
|
|
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). |
|
|
noparselinks |
Prevents shortcuts from being resolved. Without this, a shortcut to a
folder will be expandable just like a normal
sub-folder. |
|
|
nodirs |
Excludes sub-folders from the generated list - only files will be
shown. |
|
|
nofiles |
Excludes files from the generated list - only folders will be
shown. |
|
|
showhidden |
Includes hidden files and folders in the list - without this, items
with the H attribute set will be
excluded. |
|
|
showempty |
Empty sub-folders will be included in the generated list. Without this,
empty sub-folders are excluded. |
|
|
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. If you need a comma (,) character within the pattern, put embedded
quotes around the pattern as well. The examples below both specify
*,* as the pattern: |
|
|
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. If you need a comma (,) character within the pattern, put embedded quotes around the pattern, similar to the filefilter examples above. |
|
|
maxfiles=<num> |
Specify the maximum number of files to list at each level. If menus for sub-folders are generated, each menu is limited in a similar way. Because this keyword requires an embedded equals sign, you must enclose
the entire argument value in quotes to avoid confusing the command
parser. If you wish to exclude files entirely, it is more efficient to use nofiles rather than maxfiles=0. |
|
|
maxdirs=<num> |
Specify the maximum number of directories to list at each level. If menus for sub-folders are generated, each menu is limited in a similar way. Because this keyword requires an embedded equals sign, you must enclose
the entire argument value in quotes to avoid confusing the command
parser. If you wish to exclude directories entirely, it is more efficient to use nodirs rather than maxdirs=0. |
|
|
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. |
|
|
hideext |
Do not show the filename extensions for files in the generated
list. |
|
|
sortext |
Sorts files in the generated list by file
extension. |
|
|
sortsize |
Sorts files in the generated list by
size. |
|
|
sortdate |
Sorts files in the generated list by
timestamp. |
|
|
sortreverse |
Reverse the normal sort order of items in the generated
list. |
|
|
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. |
|
|
move |
Selecting a sub-folder from the generated list will move selected files
to that folder. |
|
|
copytosource |
Clicking a file or folder in the generated list will copy it into the current folder. (Note that this copy is in the opposite direction to the copy and move modes discussed just above.) This could be useful if you have a folder containing template items
which you frequently need to copy into different folders as you move
around. To update the list of template items, you would just need to add
or remove things (or softlinks to them) to the
folder. Each generated button will run the Copy command. You
can use the separate COPYARGS argument to specify
additional Copy-command arguments which are included in
each generated button. There are no separate "move" versions of the "copyto..." keywords,
since it seems unlikely they'd be needed, but you can achieve the same
thing via the COPYARGS
argument: |
|
|
copytodest |
Similar to copytosource, except the item you click
will be copied to the destination folder rather than the current (source)
folder. |
|
|
copytoleft |
Similar to copytosource, except the item you click
will always be copied to the left folder (assuming a dual-display
window). |
|
|
copytoright |
Similar to copytosource, except the item you click
will always be copied to the right folder (assuming a dual-display
window). |
|
|
useshell |
Normally folder paths like C:\ are enumerated using
the native Windows API functions. If you specify the useshell
keyword, they'll instead be enumerated using the shell (i.e.
Explorer). This may give you localized names in some cases, as well as
different ordering and different contents. Example: Go C: FOLDERCONTENT=useshell |
FORWARD |
/S |
(no value) |
Navigate to the next folder in the history
list. |
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. |
|
|
namesonly |
Display only folder names, not full paths. Tooltips will show full
paths when hovering over items. |
|
|
noicons |
Does not display icons on the generated history
list. |
|
|
keys |
Assigns the accelerator keys 0 through
9 to the first ten items displayed on the generated
history list. |
|
|
sort |
Sorts the history list alphabetically instead of in chronological
order. |
FROMSEL |
/S |
(no value) |
Indicates the first selected folder in the source file display. This
argument is used to open the selected folder (in the current file
display, another tab, a new Lister,
etc). |
FTP |
/S |
(no value) |
Displays the FTP
Connect dialog, allowing you to make an ad-hoc connection to
an FTP site. |
FTPCMD |
/K/R |
<command> |
Sends a raw command to the remote FTP server (when currently viewing an
FTP directory). If no FTP site is currently connected the command has no
effect. The effects of the command, if any, can be viewed in the FTP
log. |
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. |
FTPSITEICONS |
/S |
(no value) |
In conjunction with the FTPSITELIST argument, displays
icons for all sites in the list generated by the
command. |
FTPSITELIST |
/O |
(no value) |
Displays a list of the sites in the FTP address book (acts as a dynamic
button). |
|
|
<site prefix> |
Displays the FTP site list starting from a specified sub-folder of the
address book. |
GROUPCOLLAPSE |
/K |
<group name> |
When the file display is grouped, this command can be used to
collapse a specified group. The group name must match exactly, but you can
also use a wildcard
pattern to collapse all groups matching that
pattern. |
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. |
HISTORYLIST |
/O |
(no value) |
Display the contents of the history list (acts as a dynamic button). This is a combination of
the previous (BACKLIST) and subsequent
(FORWARDLIST)
folders. |
|
|
namesonly |
Display only folder names, not full paths. Tooltips will show full
paths when hovering over items. |
|
|
noicons |
Does not display icons on the generated history
list. |
|
|
keys |
Assigns the accelerator keys 0 through
9 to the first ten items displayed on the generated
history list. |
|
|
sort |
Sorts the history list alphabetically instead of in chronological
order. |
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. |
INITIALDIR |
/S |
(no value) |
Returns the file display to the very first folder that it
read. |
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. |
LASTACTIVELISTER |
/S |
(no value) |
Brings the most recently active Lister to the front. If there is no
valid Lister currently open, any other arguments provided to the command
are used instead. So for example, you could have a global hotkey that
brings the previous Lister to the front, or opens a new one if no Lister
is open. |
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. |
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. |
LIMITPATH |
/K/M |
<paths> |
Restricts the Lister to the specified path or paths (and their descendants). Attempts to navigate outside of the allowed paths will display an error.
You can use this in conjunction with the NEW argument
to apply restrictions to a new Lister. If you use this function in a Lister and then save it as a Layout (or it becomes the Default Lister), the restricted paths will be remembered. A new Lister opened from a restricted Lister will also inherit its restrictions.
Example: Go LIMITPATH D:\ E:\ |
|
|
current |
Restricts the Lister to only those paths currently shown in its
tabs (and their descendants). Example: Go LIMITPATH=current |
|
|
reset |
Removes any previously set path restrictions. Example: Go LIMITPATH=reset |
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. |
|
|
<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. |
|
|
max |
Maximize the new Lister window. You can use the <x> and
<y> parameters to control which monitor the window appears
maximized on. |
|
|
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. |
|
|
norm |
The new Lister window is to be neither minimized nor maximized. Use
this to override if the Default Lister is maximized, for
example. |
|
|
source |
Set the new Lister to be the current
source. |
|
|
dest |
Set the new Lister to be the
destination. |
|
|
lockoff |
The new Lister will be set as "off" - neither source nor
destination. |
|
|
tree |
Opens the folder tree in the new
Lister. |
|
|
notree |
Does not open the folder tree in the new
Lister. |
|
|
dual |
Open the new Lister in dual-display mode, taking the vertical or
horizontal layout from the Default
Lister. |
|
|
dualhoriz |
Opens the new Lister in dual-display mode, laid out
horizontally. |
|
|
dualvert |
Open the new Lister in dual-display mode, laid out
vertically. |
|
|
nodual |
Opens the new Lister in single-display
mode. |
|
|
viewpane |
Displays the viewer pane
in the new Lister. |
|
|
noviewpane |
Does not display the viewer pane in the new
Lister. |
|
|
findpanel |
Displays the utility
panel in Find Files mode in the new
Lister. |
|
|
syncpanel |
Displays the utility panel in Synchronize mode in the new
Lister. |
|
|
dupepanel |
Displays the utility panel in Duplicate File Finder mode in the new
Lister. |
|
|
noutilitypanel |
Do not display the utility panel in the new
Lister. |
|
|
metapane |
Displays the metadata
pane in the new Lister. |
|
|
nometapane |
Does not display the metadata
pane. |
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. You can use the TABPOS argument to control where
the newly-opened tab is
positioned. |
|
|
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. |
|
|
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. The
active tab is checked first, and nothing will happen if the active tab
already displays the specified
path. In some situations, findexisting is the default behavior, and nofindexisting can be used to suppress it. |
|
|
findinactive |
Like findexisting, except that if the active tab
already has the specified path then a new tab will be opened. Intended for
buttons which switch to existing tabs to reduce clutter while retaining
the ability to open a second tab for the same folder when
needed. |
|
|
nofindexisting |
Explicitly suppresses the findexisting behavior
described above. The default for most commands it to not look for existing
tabs, but some (e.g. Go OPENCONTAINER NEWTAB) will look
for existing tabs unless explicitly told not
to. |
|
|
nofocus |
The new tab will not be made
active. |
|
|
tofront |
Brings the Lister to the front. This is useful when opening a tab in
the destination Lister. |
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. |
NOSCRIPT |
/S |
(no value) |
Allows a script to run Go commands without triggering other scripts (or itself). Adding the NOSCRIPT argument disables the OnBeforeFolderChange, OnAfterFolderChange, OnOpenTab and OnOpenLister events that would otherwise be triggered by the command. |
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. When combined with the NEWTAB argument, existing tabs
are searched for automatically, without having to explicitly use
NEWTAB=findexisting. If you want a new tab to open all
the time, ignoring any existing tabs for the same folder, then you can use
NEWTAB=nofindexisting. |
|
|
target |
Dereferences 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. |
|
|
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. |
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 it could mean the
folder is read into another Lister altogether. You can combine this with
NEWTAB to open tabs in the
destination. |
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. |
|
|
horiz |
Force the layout of the dual-display Lister to horizontal (one display
above the other). |
|
|
vert |
Force the layout to vertical (side-by-side displays).
|
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). |
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. |
|
|
horiz |
Force the layout of the dual-display Lister to horizontal (one display
above the other). |
|
|
vert |
Force the layout to vertical (side-by-side displays).
|
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:
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. |
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. |
|
|
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. |
|
|
left |
The "Go" field will act on the left-hand file display, whether it is
the source or destination. |
|
|
right |
The "Go" field will act on the right-hand file
display. |
REBUILDTREE |
/O |
(no value) |
Rebuilds the contents of the folder tree attached to the source file
display. This is the equivalent of turning the tree off and then back on
again. Example: Go REBUILDTREE |
|
|
dest |
Rebuilds the folder tree attached to the destination file display (when
dual trees are enabled). Example: Go REBUILDTREE=dest |
|
|
left |
Rebuilds the folder tree attached to the left/top file
display. Example: Go REBUILDTREE=left |
|
|
right |
Rebuilds the folder tree attached to the right/bottom file display
(when dual trees are enabled). Example: Go REBUILDTREE=right |
|
|
both |
Rebuilds both folder trees (or the single tree, whichever is
applicable). Example: Go REBUILDTREE=both |
REFRESH |
/O |
(no value) |
Refresh the display of the current folder in the source file
display. |
|
|
tree |
Refresh the folder tree. |
|
|
both |
Refresh both file displays in a dual-display
Lister. |
|
|
all |
Refresh both file displays and folder
trees. |
|
|
source |
Refresh the source file display and its
tree. |
|
|
dest |
Refresh the destination file display and its
tree. |
|
|
viewpane |
Refresh the viewer pane.
The image or file currently displayed in the pane will be
reloaded. |
|
|
left |
Refresh the left-hand file
display. |
|
|
right |
Refresh the right-hand file
display. |
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. |
|
|
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. |
|
|
alt |
Refresh thumbnails only if the Alt key is held
down. |
|
|
ctrl |
Refresh thumbnails only if the Control key is held
down. |
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:. |
|
|
collapse |
Collapses the current drive's branch in the folder tree at the same
time as navigating to the root
folder. |
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. |
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. |
SWAP |
/S |
(no value) |
Swaps the folders displayed in the source and destination file
displays. |
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. |
TABCLOSE |
/O |
(no value) |
Close the current folder tab in
the source file display. |
|
|
left |
Close a folder tab in the left (or top) file display, irrespective of
whether it is the source or not. |
|
|
right |
Close a folder tab in the right (or bottom) file
display. |
|
|
dest |
Close a folder tab in the destination file
display. |
TABCLOSEALL |
/O |
(no value) |
Close all folder tabs except the current one. |
|
|
left |
Close all folder tabs to the left of the current
tab. |
|
|
right |
Close all folder tabs to the right of the current
tab. |
|
|
dest |
Lets you close tabs in the destination file display in a dual-display
Lister. Example: Go TABCLOSEALL=dest,right |
|
|
force |
Forces locked tabs to be closed. Normally locked tabs are not closed by
this command. |
|
|
expand |
Expands tabs to Listers. The tabs will be closed in the current Lister,
and each folder opened as a new
Lister. |
|
|
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. |
TABCOLOR |
/K |
<color> |
Assigns a custom color to the current tab. You can specify the color in
the decimal form R,G,B (e.g. 127,192,55) or the hex form #RRGGBB (e.g.
#ff0033). Example: Go TABCOLOR #ff8000 |
|
|
reset |
Resets the current tab's color.
|
TABDUPLICATE |
/O |
(no value) |
Duplicates the current folder
tab. |
|
|
dual |
Creates a duplicate of the current folder tab in the other file display
of a dual-display Lister. |
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. |
TABGROUPFORCE |
/S |
(no value) |
Use in conjunction with the TABGROUPLOAD or
TABGROUPLIST arguments to force folders in the loaded
tabs to load immediately even if they would normally be blocked by the
Auto-Loading settings in Preferences. Example: Go TABGROUPLOAD "My Tab Group" TABGROUPFORCE |
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.
|
|
|
keys |
Assigns the accelerator keys 0 through
9 to the first ten items displayed on the
generated tab group list. |
|
|
icons |
Displays icons for items on the generated tab group
list. |
|
|
nohighlight |
Prevents the active tab group from being
highlighted. |
|
|
savecurrent |
Saves the current folder tab group (if any) before loading a new one. Without this, any changes to a tab group will be lost when loading another one, unless you explicitly save them. As a special case, clicking the button for the current tab group will reload that group without first saving over it, giving you a way to reset to the group's last saved state. If no tab group is currently loaded, nothing will be saved before
loading the new tab group. Note that if you want Opus to save tab groups automatically in this way, you may also want to add something to trigger Go TABGROUPSAVE=!current,!quiet when listers close, or on other events such as opening/closing tabs or changing folders, depending on when you want the tab group to be updated. This probably also only makes sense if you only use one lister, since multiple listers may have differnet views of the currently open groups and save over each other. But if you want auto-saving tab groups, you're probably already using a single window all the time, as other people would use separate windows for separate tab groups and switch between windows instead of switching groups in a single window. |
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. |
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. |
|
|
<group name> |
Save the current set of folder tabs using the specified group
name. |
|
|
!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.) |
|
|
!closeall |
Saves the tab group such that it will close all existing tabs when it
is loaded (unless overridden at the time of loading). If neither
!closeall nor !nocloseall are specified,
saving over an existing group will preserved its mode, new groups created
non-interactively will close existing tabs by default, and new groups
created interactively will default to the mode used the last time the
interactive dialog was displayed. (The group name, if any, must come after
the keyword and not before.) |
|
|
!nocloseall |
Saves the tab group such that it will not close any existing tabs when
it is loaded (unless overridden at the time of loading). See
!closeall, above, for more information. (The group name,
if any, must come after the keyword and not before.) |
|
|
!current |
Saves over the folder tab group which was last loaded. The
!both keyword is ignored, and instead the mode is
inherited from the existing group. Add the !quiet keyword
to make the command do nothing if there is no current tab group to save
over; otherwise you will be prompted for the name of a new group in that
situation. |
|
|
!quiet |
Combine !quiet with !current to
prevent being asked to name a new tab group if there isn't one to save
over. |
|
|
!unless |
Combine !unless with !current to tell
the command to save the current group unless it has a particular name. You
probably won't need to use this directly, but it is how the Go
TABGROUPLIST=savecurrent command avoids saving over the current
group if you click its button to reload it. |
|
|
!forget |
Tells the file display to forget the name of the last tab group it
loaded. Combine with !both to make both sides of a
dual-display lister forget. You may wish to use this if you load a tab
group and then modify it to the point that it no longer has any connection
to the original group, and you do not want it to remain selected in any
tab group lists. |
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. |
|
|
off |
If the currently active tab is linked, this will unlink
it. |
|
|
toggle |
Toggles tab linking on or off for the currently active tabs in both
left and right file displays. |
|
|
navlock |
Use in conjunction with on or toggle
to specify that the tab is to be linked in navigation lock mode (so that it
follows the other tab whenever the folder is changed). |
|
|
reset |
When two tabs are linked in navigation lock mode, the reset keyword
lets you reset the sync position to the current locations (for recovering
when they get out of sync). |
|
|
unlinkall |
Unlinks all linked tabs in the current Lister. |
|
|
<tab1>,<tab2> |
When used from a script,
you can pass the default value of two Tab objects to specify the precise
tabs you wish to link. The two values must be comma-separated. If only one
Tab object
is specified, it will be unlinked if it is currently
linked. |
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. |
|
|
keys |
Assigns the accelerator keys 0 through
9 to the first ten items displayed on the generated tab
list. |
|
|
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). |
|
|
sortpath |
Sorts the tab list alphabetically, based on the full path of each
folder. |
|
|
icons |
Displays folder icons for each tab in the
list. |
|
|
namesonly |
Only displays the folder name for each tab rather than the full path.
Does not affect tabs which use custom labels; custom labels are always
displayed as-is. |
|
|
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. |
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. |
|
|
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. |
|
|
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. |
|
|
off |
Unlock the current folder tab. |
|
|
toggle |
Combine with the various lock keywords to toggle that
lock mode on or off. |
|
|
all |
Lock or unlock all folder
tabs. |
|
|
left |
Lock or unlock all tabs to the left of the current
tab. |
|
|
right |
Lock or unlock all tabs to the right of the current
tab. |
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. |
TABMOVE |
/O |
(no value) |
Move the current folder tab to the other file display. (See
TABPOS for repositioning tabs without changing sides.)
The Lister will be set to dual-display mode if it's not in that mode
already. |
|
|
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. |
|
|
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. |
|
|
<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. |
|
|
active |
If specified, the moved tab will be made active. Otherwise the
previously active tab in the other file display remains
active. |
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. |
|
|
<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. |
TABPOS |
/K |
first |
When used with the NEWTAB argument, causes the newly
created tab to appear as the first on the tab bar. When used with
TABCLOSE, closes the first tab. When used on its own,
repositions the active folder tab so it is first on the tab
bar. When used from a script,
you can pass the default value of a Tab object to specify the tab you
wish to reposition as the second
parameter. |
|
|
last |
When used with the NEWTAB argument, causes the newly
created tab to appear as the last on the tab bar. When used with
TABCLOSE, closes the last tab. When used on its own,
repositions the active folder tab so it is last on the tab
bar. When used from a script,
you can pass the default value of a Tab object to specify the tab you
wish to reposition as the second
parameter. |
|
|
+1 |
When used with the NEWTAB argument, causes the newly
created tab to appear as to the right of the currently active tab. When
used with TABCLOSE, closes the tab to the right of the
active tab. When used on its own, repositions the active folder tab to the
right of its current position on the tab bar. You can also use +2 for two
positions to the right, and so
on. When used from a script,
you can pass the default value of a Tab object to specify the tab you
wish to reposition as the second
parameter. |
|
|
-1 |
When used with the NEWTAB argument, causes the newly
created tab to appear to the left of the currently active tab. When used
with TABCLOSE, closes the tab to the left of the active
tab. When used on its own, repositions the active folder tab to the left
of its current position on the tab bar. You can also use -2 for two
positions to the left, and so on. When used from a script,
you can pass the default value of a Tab object to specify the tab you
wish to reposition as the second
parameter. |
|
|
<index> |
When used with the NEWTAB argument, specifies the
position for the newly created tab. When used with
TABCLOSE, specifies the position of the tab to close.
When used on its own, repositions the active folder tab to a specific
place on the tab bar. 0 is the first tab (you can also use "first"), 1 the
second, 2 the third, and so on. When used from a script,
you can pass the default value of a Tab object to specify the tab you
wish to reposition as the second
parameter. |
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. |
|
|
<delta> |
Scroll the folder tabs left or right if there are more tabs open than
will fit in the display. |
TABSELECT |
/K |
first |
Select (make active) the first folder tab in the current file
display. |
|
|
last |
Select the last folder tab in the current file
display. |
|
|
prev |
Reselect the previously selected folder
tab. |
|
|
+1 |
Select the next folder tab. |
|
|
-1 |
Select the previous folder
tab. |
|
|
home |
Resets a locked tab to its "home" directory. This is equivalent to
Go TABLOCKDIR. If the current tab is not set to 'Locked
Allow Changes' mode this command has no
effect. |
|
|
<index> |
Select a specific folder tab. The index is 0 relative (so Go
TABSELECT 0 is equivalent to Go TABSELECT
first). |
|
|
$<tab> |
Select a specific folder tab from a script. If you have a Tab object
and want to activate it, add it to the command string prefixed by a
$
character. |
TABSWAP |
/O |
(no value) |
Swaps the active tab in the left file display with the active tab in
the right file display. |
|
|
<index1>,<index2> |
Specify indices to swap a specific tab from the left file display with
a specific tab in the right file
display. |
TABUNDOCLOSE |
/S |
(no value) |
Undoes the last action that resulted in one or more tabs being
closed. |
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: |
TOFRONT |
/S |
(no value) |
Makes the Lister the active window and brings it to the front.
Typically used when sending commands from outside of Opus, to make sure
the window that reads the folder is
visible. |
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). |
|
|
closeexisting |
Reopens the last Lister that was closed, and closes all other open
Listers. |
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. |
USEQUALKEYS |
/S |
(no value) |
Activates pre-configured behaviour for the main qualifier keys -
Control will open the folder in the dual-display,
Shift in a new Lister and Alt in a new
tab. |
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. |
VIEW |
/K |
largeicons |
Changes the view mode of
the new folder to Large Icons
mode. |
|
|
smallicons |
Changes the view mode of the new folder to Small Icons
mode. |
|
|
list |
Changes the view mode to List
mode. |
|
|
details |
Changes the view mode to Details
mode. |
|
|
power |
Changes the view mode to Power
mode. |
|
|
thumbnails |
Changes the view mode to Thumbnails
mode. |
|
|
tiles |
Changes the view mode to Tiles
mode. |
WHENDUAL |
/K |
checkmouse |
This works in conjunction with the BACK,
FORWARD and UP arguments and is designed
to be used with "app command" hotkeys like the Back button on a mouse. It
lets you make navigation commands triggered from the mouse act on the file
display underneath the mouse pointer in a dual display Lister, rather
than, as is the default, the source file display. |
|
r |
anydevice |
Use with the checkmouse argument to cause the
WHENDUAL argument to activate when the command is run
from a non-mouse device (e.g. when the command is bound to a Back
button on a keyboard). Example: Go BACK WHENDUAL=checkmouse,anydevice |
|
|
deffocus |
Add the deffocus argument to cause the command to fall back to the
original behavior if the mouse pointer isn't currently over either of the
file displays. |