SetAttr

The SetAttr internal command can be used to:

 

Command Arguments:

Argument

Type

Possible values

Description

(no argument)

-

-

Displays the Change Attributes & Times dialog, which lets you modify the attributes and timestamps of selected files and folders.

Example: SetAttr

ATTR

/K

<attributes>

Sets the specified attributes for selected files and folders, and clears all others. The <attributes> value must consist of one or more of the following letters:

 

R

  Read-only (files can not be deleted or overwritten)

A

  Archive (file needs to be archived, used by backup tools)

H

  Hidden (files can be marked as hidden to hide them from the display)

S

  System (file is a system file - usually set in conjunction with H)

N

  Normal (normal attributes, none of the other attributes set)

I 

  Non-content Indexed (contents will not be indexed by the system)

C

  Compressed (on NTFS-formatted drives only)

E

  Encrypted (on NTFS-formatted drives only)

 

Note that modifying the C or E attributes may take longer than normal, as the file data has to be (un)compressed or (un)encrypted. Setting these attributes for folders sets the default compression/encryption state for new files created in those folders. A file can be compressed, or encrypted, but not both at once.

Example: SetAttr ATTR rca

CHMOD

/K

<attribute mask>

Sets the specified attributes for files on a remote FTP site. The <attribute mask> is specified using octal notation.

Example: SetAttr CHMOD 666

CLEARATTR

/K

<attributes>

Clears the specified attributes for selected files and folders. The specified attributes will be turned off, but other attributes will be untouched. See the description of the ATTR argument for a list of attribute values.

Example: SetAttr CLEARATTR c

CREATED

/K

<date/time>

Sets the creation timestamp for selected files and folders. The value for this argument can be given as either a date only, a time only, or a date and time.

The accepted formats for the date string are YYYYMMDD or YYYY-MM-DD, and the time string must be in the format HH:MM:SS.

If you specify a time as well as a date the time must come after the date, separated by a space, and you must enclose the entire value in quotes (because of the embedded space). If only a time is provided, the file's current date will be preserved (and vice versa).

Example: SetAttr CREATED "1973-09-22 3:35"

 

 

now

Sets the creation timestamp to the current date and time.

Example: SetAttr CREATED=now

 

 

modified

Copies the last modified timestamp of the file.
 

Example: SetAttr CREATED=modified

 

 

taken

For image files, copies the Date Taken timestamp. If the file doesn't have an EXIF tag the creation timestamp won't be changed.
 

Example: SetAttr CREATED=taken

 

 

digitized

For image files, copies the Date Digitized timestamp. If the file doesn't have an EXIF tag the creation timestamp won't be changed.
 

Example: SetAttr CREATED=digitized

 

 

parent

Copies the creation timestamp from the parent folder.
 

Example: SetAttr CREATED=parent

 

 

doccreated

For document files, copies the Document Created timestamp. If the file doesn't have this timestamp in its metadata the creation timestamp won't be changed.
 

Example: SetAttr CREATED=doccreated

 

 

docedited

For document files, copies the Document Last Edited timestamp. If the file doesn't have this timestamp in its metadata the creation timestamp won't be changed.
 

Example: SetAttr CREATED=docedited

 

 

docsaved

For document files, copies the Document Last Saved timestamp. If the file doesn't have this timestamp in its metadata the creation timestamp won't be changed.
 

Example: SetAttr CREATED=docsaved

DEHYDRATE

/S

(no value)

For cloud files on Windows 10 and above, this command "dehydrates" the file (removes local data and replaces it with a placeholder). This is equivalent to the "Free up space" context menu command that OneDrive adds.
 

Example: SetAttr DEHYDRATE

DESCRIPTION

/O

(no value)

Displays the Set Description dialog, which lets you assign your own description string to selected files and folders.

Example: SetAttr DESCRIPTION

 

 

<description>

Sets the description for selected files and folders to the specified string.

Example: SetAttr DESCRIPTION "Project Files for Keith"

Note that an empty string will be treated the same as not passing a string at all, causing the Set Description dialog to open. If you want an empty string to clear the description, use the SETDESCRIPTION argument instead.

FILE

/M

<filename>, ...

Specifies the name of the file or files to modify. If you don't provide this argument the command operates on all selected items in the source Lister. This is the default argument for the SetAttr command - you don't need to specify the FILE keyword.

If you only specify the filename instead of the full path of the file or files, Opus will look in the current source folder. You can also specify a wildcard pattern. Remember that if the filename contains spaces you need to enclose it in quotes.

Example: SetAttr *.xls DESCRIPTION "Annual Results for 2011" SETATTR r

FILTER

/K

<filter>

Applies the specified filter to the contents of selected folders. This must have previously been created from the File Operations / Filters page in Preferences. You can also directly specify a simple wildcard pattern

Example: SetAttr FILTER "temp files" ATTR n

META

/O/M

(no value)

Displays the Set Metadata dialog, which lets you modify the metadata for selected files and folders.

Example: SetAttr META

 

 

keyword:<value>, ...

Sets the specified metadata fields to the supplied values. Changes are made (where applicable) to all selected files.

Each keyword:<value> pair must be enclosed in quotes if the value contains any spaces. This argument can accept multiple keyword:<value> pairs to make changes to more than one metadata field at once.

See the section on programmatic setting of metadata for more information.

Example: SetAttr META "artist:Pink Floyd" "album:Dark Side of the Moon"

MODIFIED

/K

<date/time>

Sets the last modified timestamp for selected files and folders. The value for this argument can be given as either a date only, a time only, or a date and time.

The accepted formats for the date string are YYYYMMDD or YYYY-MM-DD, and the time string must be in the format HH:MM:SS.

If you specify a time as well as a date the time must come after the date, separated by a space, and you must enclose the entire value in quotes (because of the embedded space). If only a time is provided, the file's current date will be preserved (and vice versa).

Example: SetAttr MODIFIED 20080110

 

 

now

Sets the last modified timestamp to the current date and time.

Example: SetAttr MODIFIED=now

 

 

created

Copies the creation timestamp of the file.
 

Example: SetAttr MODIFIED=created

 

 

taken

For image files, copies the Date Taken timestamp. If the file doesn't have an EXIF tag the last modified timestamp won't be changed.
 

Example: SetAttr MODIFIED=taken

 

 

digitized

For image files, copies the Date Digitized timestamp. If the file doesn't have an EXIF tag the last modified timestamp won't be changed.
 

Example: SetAttr MODIFIED=digitized

 

 

parent

Copies the last modified timestamp from the parent folder.
 

Example: SetAttr MODIFIED=parent

 

 

doccreated

For document files, copies the Document Created timestamp. If the file doesn't have this timestamp in its metadata the last modified timestamp won't be changed.
 

Example: SetAttr MODIFIED=doccreated

 

 

docedited

For document files, copies the Document Last Edited timestamp. If the file doesn't have this timestamp in its metadata the last modified timestamp won't be changed.
 

Example: SetAttr MODIFIED=docedited

 

 

docsaved

For document files, copies the Document Last Saved timestamp. If the file doesn't have this timestamp in its metadata the last modified timestamp won't be changed.
 

Example: SetAttr MODIFIED=docsaved

PIN

/O

(no value)

For cloud files on Windows 10 and above, this command toggles the "pinned" status of the file on and off. This is equivalent to the "Always keep on this device" context menu command that OneDrive adds. When a file is "pinned", it's always kept on the device. When it's "unpinned" it may or may not be kept locally.
 

Example: SetAttr PIN

 

 

yes

Sets the pinned state on selected cloud files.
 

Example: SetAttr PIN=yes

 

 

no

Clears the pinned state on selected cloud files.

Example: SetAttr PIN=no

RECURSE

/S

(no value)

Changes made by this command will be recursively applied to files within selected folders. This does not affect the META argument - only attributes, timestamps and descriptions can be applied recursively.

Example: SetAttr CLEARATTR hs RECURSE

SETATTR

/K

<attributes>

Sets the specified attributes for selected files and folders. The specified attributes will be turned on, but other attributes will be untouched. See the description of the ATTR argument for a list of attribute values.

Example: SetAttr SETATTR r

SETDESCRIPTION

/O

(no value)

Clears the description for selected files and folders.

Example: SetAttr SETDESCRIPTION

The difference between the DESCRIPTION and SETDESCRIPTION arguments is what they do when not given a value. SETDESCRIPTION clears the description while DESCRIPTION opens a dialog for you to type in a description.

 

 

<description>

Sets the description for selected files and folders to the specified string.

Example: SetAttr SETDESCRIPTION "Approved for release"

TOGGLEATTR

/K

<attributes>

Toggles (inverts) the state of the specified attributes. If each attribute specified is currently set it will be cleared, and vice versa. Attributes that aren't specified will be unaffected. See the description of the ATTR argument for a list of attribute values.

Example: SetAttr TOGGLEATTR h

ZIPCOMMENT

/S

(no value)

Lets you edit the internal Zip comment when viewing the contents of a Zip archive. The comment is stored inside the Zip file and can be displayed by other Zip tools.

Example: SetAttr ZIPCOMMENT