ADDTOARCHIVE

/O

(no value)

Displays the Add to Archive dialog, to create an archive from the selected files. The dialog will default to creating a Zip file.

Example: Copy ADDTOARCHIVE

The CREATEFOLDER argument can be used to change the default archive name.

Example: Copy ADDTOARCHIVE CREATEFOLDER="Backup"

<archive format>

Displays the Add to Archive dialog with the archive type set to the specified format (given as the file extension of the desired format).

Example: Copy ADDTOARCHIVE=.rar

The archive format can be optionally followed by parameters that are specific to the selected format. Currently the only format that defines optional parameters is Zip, those are listed below.

Example: Copy ADDTOARCHIVE=.zip,fullpaths

You can also use this command to create a self-extracting archive from the selected files, with the following arguments:

Example: Copy ADDTOARCHIVE=.zip+sfx

fullpaths

When creating Zip archives, this turns on the Save full file paths option by default.

Example: Copy ADDTOARCHIVE=.zip,fullpaths

nofullpaths

When creating Zip archives, this disables the Save full file paths option.

Example: Copy ADDTOARCHIVE=.zip,nofullpaths

split:<size>

When creating Zip archives, this sets the default value for the Split archive option.

Example: Copy ADDTOARCHIVE=.zip,fullpaths,split:2.5MB

nosplit

When creating Zip archives, this disables the Split archive option.

Example: Copy ADDTOARCHIVE=.zip,nosplit,nofullpaths

AS

/O

(no value)

When copying or moving files, you will be prompted to enter a new name for each file.

Example: Copy MOVE AS

<new name>

Specifies the new name or wildcard pattern for the copied or moved files.

Example: Copy AS *.bak HERE

BURNCD

/S

(no value)

Invokes the system CD Burning Wizard, which initiates burning of any files you have previously copied to the CD staging area.

Example: Copy BURNCD

COLLLIST

/S

(no value)

Displays a dynamically generated list of file collections - you can add selected files and folders to a file collection simply by selecting it from this list. Acts as a dynamic button. Most useful when used in a drop-down menu or on a context menu.

Example: Copy COLLLIST

COPYCREATIONTIME

/K

yes

Preserve the creation time of copied files and folders.

Overrides the no_copy_creation_time option on the Miscellaneous / Advanced Preferences page.

COPYCREATIONTIME=yes will cause file and folder creation times to be preserved even if COPYFILETIMES=no or COPYDIRTIMES=no are used.

Modified and accessed times are not affected by this argument.

Example: Copy COPYCREATIONTIME=yes

no

Do not preserve the creation time of copied files and folders. (The current time will be used instead.)

COPYCREATIONTIME=no will prevent preservation of file and folder creation times even if COPYFILETIMES=yes or COPYDIRTIMES=yes are used.

Modified and accessed times are not affected by this argument.

Example: Copy COPYCREATIONTIME=no

COPYDIRTIMES

/K

yes

Preserves the created, modified and accessed times of copied folders.

Overrides the Preserve the timestamps of copied files option on the File Operations / Copy Attributes Preferences page and the no_copy_dir_dates option on the Miscellaneous / Advanced Preferences page.

You can override the COPYDIRTIMES argument itself, for just the created timestamps, using the COPYCREATIONTIME argument.

Example: Copy COPYDIRTIMES=yes

no

Prevents preservation of the created, modified and accessed times of copied folders.

Example: Copy COPYDIRTIMES=no

COPYOWNER

/K

local

Copy file owner information when the copy takes place between local drives only (overrides the Copy owner option on the File Operations / Copy Attributes Preferences page). Note that under Vista and above, setting the file owner requires elevation and so may produce a UAC prompt.

Example: Copy COPYOWNER=local

all

Copy file owner information for all drives, not just local ones.

Example: Copy COPYOWNER=all

no

Do not copy file owner information.

Example: Copy COPYOWNER=no

COPYSECURITY

/K

yes

Copy security permissions when copying files between NTFS drives (overrides the Copy security permissions option on the File Operations / Copy Attributes Preferences page).

Example: Copy COPYSECURITY=yes

no

Do not copy security permissions. Newly copied files will inherit the default security permissions of the destination folder.

Example: Copy COPYSECURITY=no

CREATEFOLDER

/O

(no value)

Prompts for the name of a new folder and copies the selected files and folders into that folder.

Example: Copy CREATEFOLDER

<folder name>

Creates a new folder with the specified name and copies selected items into that folder. You can specify an absolute path, or just a name - if only a name is provided the folder is created in the destination (or source if the HERE argument is also specified). You can also use the external control codes to (for example) automatically create a folder based on the current date.

Example: Copy CREATEFOLDER "Backup-{date|yyyyMMdd}"

When archiving files, this specifies the name of the archive to create or update. (If you don't specify an archive name it will default to the name of the first selected file, without its extension, or the name of the current folder if no file selection is used.). The example below adds the selected files to an archive called "Cat Photos.zip" below the current folder:

Example: Copy HERE ARCHIVE=.zip CREATEFOLDER="Cat Photos"

EXTRACT

/O

(no value)

Extracts the contents of selected archives to the destination folder. You can also use this with folders to copy their contents without copying the folder itself.

Example: Copy EXTRACT

sub

Creates a sub-folder in the destination named after the archive, and extracts the archive contents to that folder.

Example: Copy EXTRACT=sub

checkout

Extracts the contents of an archive to a temporary folder and automatically opens that folder in a new Lister. You can use this to "check out" the files in an archive before you decide if and where you want to extract them to.

Example: Copy EXTRACT=checkout

FILTER

/O

(no value)

Copies with filtering enabled (without having to activate the copy filter in the Lister first). Opus will prompt you to define the filter.

Example: Copy FILTER

<filter>

Copies using the specified filter. This must have previously been created from the File Operations / Filters page in Preferences. You can also directly specify a simple wildcard pattern

Example: Copy FILTER *.(jpg|png)

shift

Copies with filtering enabled if the Shift key is held down. Opus will prompt you to define the filter.

Example: Copy FILTER=shift

alt

Copies with filtering enabled if the Alt key is held down.

Example: Copy FILTER=alt

ctrl

Copies with filtering enabled if the Ctrl key is held down.

Example: Copy FILTER=ctrl

FORCE

/S

(no value)

Automatically replace existing files without prompting. In-use files that cannot be replaced will be automatically scheduled for replacement next reboot.

Example: Copy FORCE

INCLUDEINLIBRARY

/O

(no value)

Displays a dynamically generated list of libraries - you can include a selected folder in a library simply by selecting it from this list. Acts as a dynamic button. Most useful when used in a drop-down menu or on a context menu.

Opus will automatically navigate to show the contents of the library with the newly included folder.

Example: Copy INCLUDEINLIBRARY

noread

Prevents Opus from automatically navigating to the library when you include a folder in it via the generated list.

Example: Copy INCLUDEINLIBRARY noread

$new

Include selected folders in a new library. The new library will be given the name of the first selected folder. Opus will automatically navigate to the new library unless you include the noread: prefix.

Example: Copy INCLUDEINLIBRARY noread:$new

<library name>

Include selected folders in the named library. Opus will automatically navigate to the new library unless you include the noread: prefix.

Example: Copy INCLUDEINLIBRARY "noread:Movie Files"

MAKELINK

/O

(no value)

Creates shortcuts to all selected files and folders. Shortcuts do not require NTFS. Shortcuts may point to things on different drives to themselves.

Example: Copy MAKELINK TO /desktop

junction

Creates junctions to all selected folders. Junctions are only supported on NTFS drives. Junctions only work with folders (not with files). Junctions may point to folders on different drives to themselves.

Example: Copy MAKELINK=junction

hardlink

Creates hardlinks to all selected files. Hardlinks are only supported on NTFS drives. Hardlinks only work with files (not folders). Hardlinks cannot point to files on different drives to themselves.

Example: Copy MAKELINK=hardlink

softlink

Creates softlinks to all selected files or folders, using absolute paths. Softlinks require Windows Vista or above and are only supported on NTFS drives. Softlinks work with both files and folders. Softlinks may point to things on different drives to themselves. Creating softlinks requires administrator access and will trigger a UAC prompt if neccessary.

Example: Copy MAKELINK=softlink

relsoftlink

Creates softlinks to any selected files or folders, using relative paths where possible. A regular absolute link will be created if the target can not be expressed relative to the link. (See softlink for more information on softlinks.)

Example: Copy MAKELINK=relsoftlink

auto

Automatically determines the most suitable type of link to create. On Vista and above, it will usually create softlinks (for both files and folders). On Windows XP, it will usually create junctions (for folders) and hardlinks (for files). Shortcuts will be created instead in cases where the desired link type is not applicable. For example, a shortcut will be created if the drives are not NTFS or if a hardlink is desired but the source and destination are on different drives.

Example: Copy MAKELINK=auto

autonosoft

Does the same as auto except that it will not try to create softlinks. It will usually create junctions (for folders) and hardlinks (for files). Shortcuts will be created instead in cases where the desired link type is not applicable. For example, a shortcut will be created if the drives are not NTFS or for files where the source and destination are on different drives.

Example: Copy MAKELINK=autonosoft

MARKDESTARCHIVE

/K

yes

Set the A attribute on newly copied files. You can use this if have a backup solution that uses the A attribute as an indication that a file has been backed up (overrides the Mark copied files as archived option on the File Operations / Copy Attributes Preferences page).

Example: Copy MARKDESTARCHIVE=yes

no

Do not set the A attribute on newly copied files.

Example: Copy MARKDESTARCHIVE=no

MOVE

/S

(no value)

Move selected files and folders to the destination (a.k.a. cut-and-paste). If the destination folder is on the same drive as the source then generally items can be moved through a simple rename operation, which is very quick. When moving files between devices Opus first copies them to the destination, and then deletes them from the source.

Example: Copy MOVE

MOVEWITHSHIFT

/S

(no value)

Selected items will be moved if the Shift key is held down when the command is executed, otherwise they will be copied.

Example: Copy MOVEWITHSHIFT

PATTERN

/K

<old name pattern>

Specifies the "old name" or "from" wildcard pattern for the copied or moved files. Use this in conjunction with AS to control wildcard renaming of copied or moved files.

Example:Copy DUPLICATE PATTERN *.* AS *_{date|yyyy-MM-dd}.*

RENAMEWHENSAME

/S

(no value)

If the source and destination are the same folder, the newly copied file will be automatically renamed to avoid a clash.

Example: Copy RENAMEWHENSAME 

SENDTO

/K

<send-to target>

Send selected files to the specified "send to" target. This can be any item that appears in the system Send To context menu, and lets you perform the same action without actually displaying the context menu. The value given for the target must be the name of the actual file in the SendTo folder (to find the SendTo folder and see what's in there, use the /sendtofolder alias).

Example: Copy SENDTO "Web Publishing Wizard"

UNATTENDED

/K

yes

Enables unattended copy mode. In this mode, Opus will not display any confirmation prompts or error dialogs - the copy will proceed until the end, and any errors will be summarised upon completion. Use the other arguments like WHENEXISTS to control what happens in certain situations.

Example: Copy UNATTENDED=yes TO=@myftpsite WHENEXISTS=replace 

no

Disables unattended copy mode.

Example: Copy UNATTENDED=no

UPDATEEXISTING

/O

(no value)

Update existing files in the destination folder (a simple form of one-way synchronization). Only files that already exist in the destination, but are different from the source files, will be copied. Files that do not already exist, as well as files that have not changed, will be skipped. A file is defined as different if either its timestamp or size has changed.

Example: Copy UPDATEEXISTING

size

Update existing files whose size is different (ignore timestamp).

Example: Copy UPDATEEXISTING=size

date

Update existing files whose timestamp is different (ignore file size).

Example: Copy UPDATEEXISTING=date

UPDATETOLERANCE

/K/N

<tolerance seconds>

Sets the maximum number of seconds an existing file's timestamp can vary before it will be considered "different" by the UPDATEALL or UPDATEEXISTING functions. The default is two seconds (that is, a file will be considered different if its timestamp is two or more seconds different to the source file). You can use this to make allowances for daylight-savings time, or for file systems that don't preserve file dates to a high enough resolution.

Example: Copy UPDATEEXISTING UPDATETOLERANCE=3600