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)

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 current date is used.

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

 

 

now

Sets the creation timestamp to the current date and time.

Example: SetAttr CREATED=now

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 current date is used.

Example: SetAttr MODIFIED 20080110

 

 

now

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

Example: SetAttr MODIFIED=now

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