Directory Opus Manual

(no argument)

-

-

Display the Find Panel. It will open in whichever mode you last used it.

Example: Find

ANYWORD

/S

(no value)

Use when automating Find Files to enable the Any Word option for name searching.
For example, if this was turned on and you used "cat dog" as the NAME argument, Opus would match filenames containing "cat" or "dog" (or both, in any order). This saves you having to construct complicated OR wildcard patterns.

Example: Find NAME="cat dog" ANYWORD RECURSE IN "c:\"

BOTHWAYS

/S

(no value)

When automating the Synchronize tool with the SYNC argument, this lets you turn on the Copy files in both directions option.

Example: See the SYNC argument for an example.

CLEAR

/O

(no value)

Clear previous results (when the Find Files function is being automated). The output file collection will be cleared before the new Find begins.

Example: Find *.doc IN C:\Data CLEAR

no

Do not clear previous results.

Example: Find *.doc in C:\Data CLEAR=no

COLUMN

/K

<column name>

When automating the duplicate finder tool with the DUPES argument, specifies that duplicates should be matched using the value of a specific column.

Example: Find IN C:\Data DUPES COLUMN=createddate

name

Match duplicates by name as well as the value of the specified column

Example: Find IN C:\Data DUPES COLUMN=createddate,name

size

Match duplicates by size as well as the value of the specified column

Example: Find IN C:\Data DUPES COLUMN=createddate,name,size

COMPUTERS

/S

(no value)

Launch the Windows Search for Computers function (depending on your version of Windows, this may have no effect).

Example: Find COMPUTERS

CONTANYWORD

/S

(no value)

Use when automating Find Files to specify that the CONTAINING argument should be handled in "any word" mode, similar to the related checkbox in the UI.

Example: Find *.txt CONTAINING "apple pear peach plum" CONTANYWORD IN C:\Inventory

CONTIGNOREDIACRITICS

/S

(no value)

Use when automating Find Files to specify that the CONTAINING argument should ignore diacritics (accent marks), similar to the related checkbox in the UI.

Example: Find *.txt CONTAINING "aeiou" CONTIGNOREDIACRITICS IN C:\Documents

CONTWILD

/S

(no value)

Use when automating Find Files to specify that the CONTAINING argument should be treated as a wildcard, similar to the related checkbox in the UI.

Example: Find *.txt CONTAINING (foo|bar) CONTWILD IN C:\Things

CONTUTF8

/S

(no value)

When automating the Find Files function, plain text files will be assumed to be UTF-8 if no BOM is detected (similar to the related checkbox in the UI).

Example: Find *.txt CONTAINING printf IN C:\SourceCode CONTUTF8

DSTCOMPENSATION

/S

(no value)

When automating the Synchronize tool with the SYNC argument, this lets you select to ignore one hour time differences (daylight savings time) when comparing timestamps.

Example: See the SYNC argument for an example.

EXCLUDEHIDDEN

/O

(no value)

Excludes hidden folders (those with the H attribute set) from the search.

Example: Find *.txt IN D:\ EXCLUDEHIDDEN

no

Does not exclude hidden folders. Use this to override a saved preset.

Example: Find PRESET=DocFiles EXCLUDEHIDDEN=no IN \\storage\data

FILTER

/S

(no value)

Indicates that the value of the NAME argument is the name of a pre-defined filter. This lets you automate more complex searches than just those based on filename and containing text.

Example: Find NAME image_files IN C:\Pictures FILTER

FROM

/K

<path>

When automating the Synchronize tool with the SYNC argument, this lets you specify the folder that is the source of the synchronize operation.

Example: See the SYNC argument for an example.

HIDEUNAFFECTED

/S

(no value)

When automating the Synchronize tool with the SYNC argument, this lets you select to hide unaffected files once the comparison process has run.

Example: See the SYNC argument for an example.

IGNORELINKS

/S

(no value)

When automating the Duplicate File Finder, this lets you turn on the Ignore hard links option.

Example: Find IN C:\Data DUPES IGNORELINKS

IN

/K/M

<search location> …

Specify the folder or folders to search in when automating a search. Remember that if the paths contain a space you must enclose the value in quotes.

Example: Find *.txt IN "C:\Folder 1" "C:\Folder 2"

MD5

/O

(no value)

Search for duplicates using the MD5 checksum (used with the DUPES argument). The default behaviour is to search based on filename and size.

Example: Find IN C:\Data DUPES MD5

<percentage>

Only calculate checksums based on a percentage of the file's contents. This can dramatically speed up duplicate checking for large files, at the expense of some accuracy.

Example: Find IN C:\Data DUPES MD5=75

cache

Use the checksum cache for large files. If a file's checksum has previously been cached and the file does not appear to have changed, the cached value will be used instead of recalculating its checksum.

Example: Find IN C:\Downloads DUPES MD5=cache,50

NAME

<filename>

This is the default argument for the Find command, which means you do not need to use the NAME keyword before it (unless you are searching for a word which is recognized as another argument keyword).

Specify the filename or wildcard pattern to search for. To automate the Find Files function you must specify both the NAME argument, and the location to search using the IN argument.

The NOWILD, ANYWORD and NOPARTIAL arguments can be used to control whether or not wildcards, "any word" or partial matching are used when searching names, similar to the checkboxes in the UI.

You can start the wildcard pattern with regex: to use regular expressions instead of wildcards. (Do not specify the NOWILD argument in this case.)

You can also search using a pre-defined filter by providing the filter name for the NAME argument and also specifying the FILTER switch.

Example: Find *.(doc|txt|bmp) IN C:\ RECURSE ARCHIVES
Example: Find regex:foo.+bar\.txt IN C:\ RECURSE
Example: Find NAME="Text File (1).txt" NOWILD IN C:\ RECURSE

When used with the DUPES argument, this lets you provide a filename filter for the duplicates search. When used like this, you can specify a regular expression pattern by prefixing the wildcard with the regex: prefix.

Example: Find *.pdf IN C:\Documents RECURSE CLEAR MD5 DUPES

NOAUTORUN

/S

(no value)

Lets you prevent an automated search from taking place - instead, the Find, Duplicates or Synchronize panel will open with the controls initialised but allow you to make further changes before starting the search. For example, when both the NAME and IN arguments are provided, the Find Files operation normally begins automatically. To prevent this, specify the NOAUTORUN argument as well.

Example: Find *.doc IN /mydocuments RECURSE NOAUTORUN

NOWILD

/S

(no value)

Use when automating Find Files to prevent wildcard name matching. Like the similar checkbox in the UI.

Example: Find "File (1).txt" IN "c:\" RECURSE NOWILD

OF

/K/M

<file to match> …

Specifies one or more files to search for duplicates of. If you don't use this argument, all duplicate files in the specified locations will be found. Remember that if the file path you are providing contains spaces, you must enclose the value in quotes.

Example: Find DUPES OF C:\Report.txt IN C:\Backups MD5

ONLYEXISTING

/S

(no value)

When automating the Synchronize tool with the SYNC argument, this lets you select to only synchronize existing files.

Example: See the SYNC argument for an example.

QUERY

/K/R

<query string>

Performs a search in the specified location using the Windows Search system.

If used on its own, without other arguments, it is like typing a query string into the search field at the top-right of the lister to search below the current folder. You can also run a Windows Search query on a specified folder or into a custom results collection.

Everything which follows the QUERY argument will be passed to Windows Search as the query string, so it must be the last argument to the command.

Example: Find QUERY filename:*.doc author:"Leo Davidson"
Example: Find IN "C:\Documents" COLLNAME "Leo's Docs" QUERY filename:*.doc author:"Leo Davidson"

REGEXP

/S

(no value)

When automating the Find Files function, enables regular expressions for the value of the NAME field.

Example: Find "foo.+bar\.txt" IN C:\ RECURSE REGEXP

SAVEQUERY

/S

(no value)

When you are currently viewing the results of a Windows Search query, this command will save the search as a stored query collection.

Example: Find SAVEQUERY

SIMPLE

/S

(no value)

Display the Find Panel in simple mode.

Example: Find SIMPLE

SYNC

/O

(no value)

In conjunction with other arguments, this lets you automate the Synchronize tool. The other relevant arguments are FROM, TO, BOTHWAYS, DELETE, COMPARE, IGNORESECONDS, DSTCOMPENSATION, HIDEUNAFFECTED, ONLYEXISTING.

This process requires the use of multiple commands. Find SYNC performs the initial step in the synchronize process - the comparison. You then need to use Copy SYNC to perform any copying required. Finally, Set CLEARSYNC can be used to exit synchronize mode once finished.

Example:

Find SYNC FROM "D:\Work" TO "D:\Backups" RECURSE COMPARE=newer HIDEUNAFFECTED
Copy SYNC
Set CLEARSYNC

ltr

Performs the synchronize from left-to-right rather than source-to-destination.

UAC

/O

(no value)

Enables UAC prompts if elevation may be required to search inside folders.

Example: Find *.txt UAC IN D:\

no

Suppresses UAC prompts, skipping folders you don't have access to. (This is the default, so it doesn't normally need specifying. Can be useful if you want to override a preset which enables UAC prompts.)

Example: Find PRESET=DocFiles UAC=no IN D:\