Keywords for Columns

The following keywords are used by the Set command (with the COLUMNS, COLUMNSADD, COLUMNSREMOVE and COLUMNSTOGGLE arguments) to change which columns are displayed in the file display (in details and power modes), and with the GROUPBY and SORTBY arguments to modify the group and sort fields. For example, Set COLUMNSADD=desc adds the Description column to the file display.

They are also used by the Rename function when renaming using metadata, and in the File Types editor when defining your own tile and infotip definitions.

Note that some columns appear in multiple categories. For historic reasons, column keywords sometimes only reflect a narrow usage when the column actually works in a wider range of situations. For example, the Duration column (mp3songlength) works with various music file types, and some movie types, not just MP3 music files.

Where columns are used to output text (for example, when generating filenames for a rename, or when displaying info tips), the format of dates, times and numeric values can be overridden:

• Date and time fields let you configure the date format, the time format, or both. For example,
  
  {datetaken|D#yyyy-MM-dd} - inserts the date only in yyyy-MM-dd format (e.g. 2008-09-22).
  {modified|T#HH-mm-ss} - inserts the modified time in HH-mm-ss format (e.g. 13:10:55)
  {datetaken|D#yyyyMMddT#HHmmss} - inserts both the date and time as yyyyMMddHHmmss (e.g. 20051130154410).
  
  As you can see in the examples, D# is used to mark the date format, and T# is used to mark the time format. See the Codes for date and time page for information on date and time formats.
  
  
• Numeric fields let you control zero-padding. For example,
  
  {size|#8} - zero-pads the size in bytes to eight places (e.g. 00045412)
  {mp3track|#2) - zero-pads the track number to two places (e.g. 08)
  
  

You can also access some columns that aren't part of the standard set of columns shown above. These can come from various places - third-party shell namespace extensions can provide custom columns, as can Opus plugins. Additionally, Zip and FTP define several columns that are only valid in those types of folders. In Opus, these columns all appear under the Other category. To refer to one of these columns from a command you need to know the name of the column, and then use the appropriate prefix to indicate that you want to use a special column.

Columns provided by shell extensions (as in the screenshot above) are prefixed with sh: in Opus - the keyword for the column is the name shown in the list without spaces.

For example, to add the SVN Status column you might use the command Set COLUMNSADD sh:svnstatus.

Columns provided by plugins (e.g. the 7-Zip plugin) must be prefixed by the name of the plugin DLL (e.g. opus7zip:packed).

The following column keywords are provided by Opus but only valid in certain folders:

• FTP keywords are only valid in an ftp:// path
• Zip keywords are only valid when viewing a Zip archive
• 7-Zip keywords are only valid when viewing an archive handled by the 7-Zip plugin
• Computer keywords are only valid when viewing the native Computer folder

Within the Lister Column HeaderContext Menu, you can use %header% to refer to the column which was right-clicked. For example, Set GROUPBY=%header%,toggle would group by the column which had been clicked to open the menu.