# &app; Manual

&app; Desktop Application Manual V&manrevision;
2007
2006
Piotr Eljasiak
GNOME Documentation Project
GNOME Documentation Project
GNOME
Piotr
Eljasiak
GNOME Commander Manual V1.2.3;
2006-12-11

Piotr Eljasiak epiotr@cvs.gnome.org

GNOME Documentation Project

GNOME Commander Manual V1.2.4;
2007-06-09

Piotr Eljasiak epiotr@cvs.gnome.org

GNOME Documentation Project

This manual describes version &appversion; of &app;.

## Feedback

To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the GNOME Feedback Page.

&app; is a lighweight and fast file manager for the GNOME desktop.

## Introduction

The &app; application is a fast and powerful graphical file manager for the Gnome desktop environment, it has a "two-pane" interface based on the orthodox file manager (OFM) principle, in the tradition of Norton and Midnight Commander.

&app; provides the following features:

- GTK-2 GUI with standard mouse interactions

- Gnome MIME types

- Remote connections using GnomeVFS: FTP/SFTP and SAMBA

- Right click mouse menu

- User defined context menu

- Quick device access buttons with automatic mounting and unmounting

- History of accessed locations

- Folder bookmarks

- Plugin support

- Fast file viewer for text and images

- Meta data support for Exif, IPTC, ID3, OLE2 and ODF tags

- Tools for advanced batch renaming of files, searching, quick file name searching in current dir, symlinking, comparing directories

- Integrated command line

- Colour profiles

- Support for over 30 languages.

If you are using a development or SVN version, it is possible that the latest new features are not yet in this manual. Please read the detailed ChangeLog online or in the &app; sources to find out more about the new features.

## Getting Started

### To Start &app;

You can start &app; in the following ways:

Applications menu

  Choose Accessories &app; .

Command line

  To start &app; from a command line, type the following command, then press Return:

  `gnome-commander`

### When You Start &app;

When you start &app;, the following window is displayed.

#### &app; Window

Shows &app; main window. Contains titlebar, menubar, toolbar, display area, and scrollbars. Menubar contains File, View, Settings, and Help menus.

The &app; window contains the following elements:

Menubar.

  The menus on the menubar contain all of the commands you need to work with files in &app;.

Toolbar.

  The toolbar contains a subset of the commands that you can access from the menubar.

Statusbar.

  The statusbar displays information about current &app; activity and contextual information about the menu items.

### Command Line Options

Options

  - --help

    Show summary of options.

  - --version

    Show version of &app;.

  - -l, --start-left-dir=STRING

    Specify the start directory for the left pane.

  - -r, --start-right-dir=STRING

    Specify the start directory for the right pane.

  - -d, --debug=STRING

    Specify debug flags to use. Debug output will be written to stdout.

    Possible flags:

    - a user actions debugging

    - c file and directory counting

    - d directory ref-counting

    - f file ref-counting

    - g run_command debugging

    - i image loader

    - k directory pool

    - l directory listings

    - m connection debugging

    - n directory monitoring

    - p python plugins

    - s SMB network browser

    - t metadata tags

    - v internal viewer

    - w widget_lookup

    - x xfer

    - y brief MIME based imageload

    - z detailed MIME based imageload

  - [gtk,gnome,bonobo options]

    Standard gtk, gnome, bonobo options are supported. Use --help to see possible options.

Examples

  `gnome-commander `-d nvl``

  Starts &app; with debugging of directory listings, internal viewer and directory monitoring facilities.

## Usage

You can use the &app; application to perform the following tasks:

### Selecting Files and Folders

### Drag-and-Drop

### Copying a File or Folder

### Moving a File or Folder

### Renaming a File or Folder

### Deleting a File or Folder

### Creating a Folder

### Searching For Files

### Creating a Symbolic Link to a File or Folder

A symbolic link is a special type of file that points to another file or folder. When you perform an action on a symbolic link, the action is performed on the file or folder to which the symbolic link points. However, when you delete a symbolic link, you delete the link file, not the file to which the symbolic link points.

To create a symbolic link to a file or folder, select the file or folder to which you want to create a link. Choose File Create Symbolic Link. A link to the file or folder is added to the current folder.

Alternatively, grab the item to which you want to create a link, then press-and-hold CTRLSHIFT. Drag the item to the location where you want to place the link.

The permissions of a symbolic link are determined by the file or folder to which a symbolic link points.

For more on dragging items, see .

### Viewing the Properties of a File or Folder

To view the properties of a file or folder, perform the following steps:

1. Select the file or folder whose properties you want to view.

2. Choose File Properties.... A properties dialog is displayed.

On the Permissions tab (see Figure xxx), you can change the permissions and ownership of a file (that is, if you have the right permissions yourself). You can change the read, write, and execute settings for a file. For more information on permissions, see Chapter xxx.

The following table lists the properties that you can view or set for files and folders, the exact information shown depends on the object type:

Property | Description
--- | ---
Name | The name of the file or folder.
Type | The type of object, file or folder.
,
MIME Type | The official naming of the type of file.
Modified | The date and time at which the object was last changed.
Accessed | The date and time at which the object was last viewed.
Size | The amount of data occupied by object, file or folder.

### Changing Permissions

To change the permissions of a file or a folder, perform the following steps:

1. Select the file that you want to change.

2. Choose File Properties. The properties window for the item is displayed.

3. Click on the Permissions tab.

4. To change the file's group, choose from the groups the user belongs to in the drop-down selector.

5. For each of the owner, the group, and all other users, choose from these permissions for the file:

   Read

     The users can read a file

   Write

     The users can save a file.

   Execute

     The users can run a file as a program.

### Using Bookmarks

### Hidden Files

By default, &app; does not display certain system and backup files in folders. This prevents accidental modification or deletion of them, which can impair the operation of your computer, and also reduces clutter in locations such as your Home Folder. &app; does not display:

- Hidden files, whose filename begins with a period (.),

- Backup files, whose filename ends with a tilde (~) or with extension `'.bak'`

- Files that are listed in a particular folder's `.hidden` file.

You may hide or show hidden files in a particular folder by selecting View Show Hidden Files.

### Advanced file renaming

A powerful tool for batch renaming of the files selected in &app;. It allows you to easily rename lots of files in one go. The filenames can be created by parts of the original filename, its path, numbering the files or accessing hundreds of informations about the file, like creation date or Exif/IPTC informations of an image.

When started, the following dialog is displayed:

#### Advanced Rename Tool Dialog

Shows advanced file renaming dialog.

Template

  Specifies template for file renaming. All ordinary characters placed in the format string go into new name without conversion. Conversion specifiers are introduced by a few placeholders (see below for the detailed list of placeholders). Additionally strftime() format controls are also accepted - except for "%D", "%n" and "%t" for obvious reasons. If found, they are converted into single "%".

Regex replacing

  List of regular expression patterns. The patterns are matched in against Template. If matched, patterns are replaced with their corresponding replacements. The order of execution is top-bottom.

Result

  List of the new file names.

Options

  Additional settings for file name processing (start value, step and precision for counters).

OK

  Starts to rename files. A warning message will popup in case of any name conflicts.

Cancel

  Closes the dialog without file renaming.

#### Template Placeholders

Placeholder | Replacement
--- | ---
$N | The whole file name (with extension)
$N(range) | Part of the whole file name (with extension)
$n | File name without extension
$n(range) | Part of the file name without extension
$e | File extension
$e(range) | Part of the file extension
$p | Parent dir name
$p(range) | Part of the parent dir name
$g | Grandparent dir name
$g(range) | Part of the grandparent dir name
$c | File counter
$c(precision) | File counter with specified digit number (precision)
$T(metatag) | Metadata tag
$$ | A literal "$" character

Broken - like $n(), $e(0,-3) or $N(abc) - or unknown placeholders are copied verbatim without any substitution.

#### Metadata Tags (Metatags)

Metadata is usually defined as data about data. Metadata describes data about files that is often user visible in file managers, office applications, document viewers and audio players. Metadata can typically be viewed or written by selecting "properties" from the file menu of one of these applications.

For all metadata, each metadata tag (metatag) needs to be namespaced with its class type using a "." qualifier (e.g.

Audio.Artist
represents the metadata Artist for an audio class file).

The placeholder for metadata is

$T(metatag)
. Use, for example,
$T(Exif.DateTime)
to get image capture date/time and to insert it to new filename (metatags names are case insensitive, so we could use also
$T(exif.datetime)
here). The generic
'Audio.'
,
'Doc.'
,
'File.'
and
'Image.'
metatags are independent of the used framework and they provide unified access to respectively audio, doc, file or image metadata. Please refer to freedesktop.org for more details on the generic metatags.

Metatag | Name | Description
--- | --- | ---
Audio.Album | Album | Name of the album
Audio.AlbumArtist | Album Artist | Artist of the album
Audio.AlbumGain | Album Gain | Gain adjustment of album
Audio.AlbumPeakGain | Album Peak Gain | Peak gain adjustment of album
Audio.AlbumTrackCount | Album Track Count | Total number of tracks on the album
Audio.Artist | Artist | Artist of the track
Audio.Bitrate | Bitrate | Bitrate in kbps
Audio.Channels | Channels | Number of channels in the audio (2 = stereo)
Audio.Codec | Codec | Codec encoding description
Audio.CodecVersion | Codec Version | Codec version
Audio.Comment | Comment | Comments on the track
Audio.CoverAlbumThumbnailPath | Cover album thumbnail path | File path to thumbnail image of the cover album
Audio.DiscNo | Disc Number | Specifies which disc the track is on
Audio.Duration | Duration | Duration of track in seconds
Audio.Genre | Genre | Type of music classification for the track as defined in ID3 spec
Audio.IsNew | Is new | Set to "1" if track is new to the user (default "0")
Audio.LastPlay | Last Play | When track was last played
Audio.Lyrics | Lyrics | Lyrics of the track
Audio.MBAlbumArtistID | MB album artist id | MusicBrainz album artist ID in UUID format
Audio.MBAlbumID | MB Album ID | MusicBrainz album ID in UUID format
Audio.MBArtistID | MB Artist ID | MusicBrainz artist ID in UUID format
Audio.MBTrackID | MB Track ID | MusicBrainz track ID in UUID format
Audio.Performer | Performer | Name of the performer/conductor of the music
Audio.PlayCount | Play Count | Number of times the track has been played
Audio.ReleaseDate | Release Date | Date track was released
Audio.Samplerate | Sample Rate | Sample rate in Hz
Audio.Title | Title | Title of the track
Audio.TrackGain | Track Gain | Gain adjustment of the track
Audio.TrackNo | Track Number | Position of track on the album
Audio.TrackPeakGain | Track Peak Gain | Peak gain adjustment of track
Doc.Author | Author | Name of the author
Doc.ByteCount | Byte Count | Number of bytes in the document
Doc.CaseSensitive | Case Sensitive | Case sensitive
Doc.Category | Category | Category
Doc.CellCount | Cell Count | Number of cells in the spreadsheet document
Doc.CharacterCount | Character Count | Number of characters in the document
Doc.Codepage | Codepage | The MS codepage to encode strings for metadata
Doc.Comments | Comments | User definable free text

Doc.Company

Company

Organization that the
Doc.Creator
entity is associated with

Doc.Created | Created | Datetime document was originally created
Doc.Creator | Creator | An entity primarily responsible for making the content of the resource, typically a person, organization, or service
Doc.DateCreated | Date Created | Date associated with an event in the life cycle of the resource (creation/publication date)
Doc.DateModified | Date Modified | The last time the document was saved
Doc.Description | Description | An acccount of the content of the resource
Doc.Dictionary | Dictionary | Dictionary
Doc.EditingDuration | Editing Duration | The total time taken until the last modification
Doc.Generator | Generator | The application that generated this document
Doc.HiddenSlideCount | Hidden Slide Count | Number of hidden slides in the presentation document
Doc.ImageCount | Image Count | Number of images in the document
Doc.InitialCreator | Initial Creator | Specifies the name of the person who created the document initially
Doc.Keyword | Keywords | Searchable, indexable keywords
Doc.Keywords | Keywords | Searchable, indexable keywords
Doc.Language | Language | The locale language of the intellectual content of the resource
Doc.LastPrinted | Last Printed | The last time this document was printed
Doc.LastSavedBy | Last Saved By | The entity that made the last change to the document, typically a person, organization, or service
Doc.LineCount | Line Count | Number of liness in the document
Doc.LinksDirty | Links Dirty | Links dirty
Doc.LocaleSystemDefault | Locale System Default | Identifier representing the default system locale
Doc.MMClipCount | MM Clip Count | Number of multimedia clips in the document

Doc.Manager

Manager

Name of the manager of
Doc.Creator
entity

Doc.NoteCount | Note Count | Number of "notes" in the document
Doc.ObjectCount | Object Count | Number of objects (OLE and other graphics) in the document
Doc.PageCount | Page Count | Number of pages in the document
Doc.ParagraphCount | Paragraph Count | Number of paragraphs in the document
Doc.PresentationFormat | Presentation Format | Type of presentation, like "On-screen Show", "SlideView", etc
Doc.PrintDate | Print Date | Specifies the date and time when the document was last printed
Doc.PrintedBy | Printed By | Specifies the name of the last person who printed the document
Doc.RevisionCount | Revision Count | Number of revision on the document
Doc.Scale | Scale | Scale
Doc.Security | Security | One of: "Password protected", "Read-only recommended", "Read-only enforced" or "Locked for annotations"
Doc.SlideCount | Slide Count | Number of slides in the presentation document
Doc.SpreadsheetCount | Spreadsheet Count | Number of pages in the document
Doc.Subject | Subject | Document subject
Doc.TableCount | Table Count | Number of tables in the document
Doc.Template | Template | The template file that is been used to generate this document
Doc.Thumbnail | Thumbnail | Thumbnail data of the document, typically a preview image of the document
Doc.Title | Title | Title of the document
Doc.WordCount | Word Count | Number of words in the document
Exif.ApertureValue | Aperture | The lens aperture. The unit is the APEX value
Exif.Artist | Artist | Name of the camera owner, photographer or image creator. The detailed format is not specified, but it is recommended that the information be written for ease of Interoperability. When the field is left blank, it is treated as unknown
Exif.BatteryLevel | Battery Level |
Exif.BitsPerSample | Bits per Sample | The number of bits per image component. Each component of the image is 8 bits, so the value for this tag is 8. In JPEG compressed data a JPEG marker is used instead of this tag
Exif.BrightnessValue | Brightness | The value of brightness. The unit is the APEX value. Ordinarily it is given in the range of -99.99 to 99.99
Exif.CFAPattern | CFA Pattern | Indicates the color filter array (CFA) geometric pattern of the image sensor when a one-chip color area sensor is used. It does not apply to all sensing methods
Exif.CFAPattern | CFA Pattern | The color filter array (CFA) geometric pattern of the image sensor when a one-chip color area sensor is used. It does not apply to all sensing methods
Exif.CFARepeatPatternDim | CFA Repeat Pattern Dim |
Exif.ColorSpace | Color Space | The color space information tag is always recorded as the color space specifier. Normally sRGB (=1) is used to define the color space based on the PC monitor conditions and environment. If a color space other than sRGB is used, Uncalibrated (=FFFF.H) is set. Image data recorded as Uncalibrated can be treated as sRGB when it is converted to FlashPix

Exif.ComponentsConfiguration

Components Configuration

Information specific to compressed data. The channels of each component are arranged in order from the 1st component to the 4th. For uncompressed data the data arrangement is given in the
Exif.PhotometricInterpretation
tag. However, since
Exif.PhotometricInterpretation
can only express the order of Y, Cb and Cr, this tag is provided for cases when compressed data uses components other than Y, Cb, and Cr and to enable support of other sequences

Exif.CompressedBitsPerPixel | Compressed Bits per Pixel | Information specific to compressed data. The compression mode used for a compressed image is indicated in unit bits per pixel
Exif.Compression | Compression | The compression scheme used for the image data. When a primary image is JPEG compressed, this designation is not necessary and is omitted. When thumbnails use JPEG compression, this tag value is set to 6
Exif.Contrast | Contrast | The direction of contrast processing applied by the camera when the image was shot

Exif.Copyright

Copyright

Copyright information. The tag is used to indicate both the photographer and editor copyrights. It is the copyright notice of the person or organization claiming rights to the image. The Interoperability copyright statement including date and rights should be written in this field; e.g., "Copyright, John Smith, 19xx. All rights reserved.". The field records both the photographer and editor copyrights, with each recorded in a separate part of the statement. When there is a clear distinction between the photographer and editor copyrights, these are to be written in the order of photographer followed by editor copyright, separated by NULL (in this case, since the statement also ends with a NULL, there are two NULL codes) (see example 1). When only the photographer is given, it is terminated by one NULL code. When only the editor copyright is given, the photographer copyright part consists of one space followed by a terminating NULL code, then the editor copyright is given. When the field is left blank, it is treated as unknown

Exif.CustomRendered | Custom Rendered | The use of special processing on image data, such as rendering geared to output. When special processing is performed, the reader is expected to disable or minimize any further processing
Exif.DateTime | Date and Time | The date and time of image creation
Exif.DateTimeDigitized | Date and Time (digitized) | The date and time when the image was stored as digital data
Exif.DateTimeOriginal | Date and Time (original) | The date and time when the original image data was generated. For a digital still camera the date and time the picture was taken are recorded
Exif.DeviceSettingDescription | Device Setting Description | Information on the picture-taking conditions of a particular camera model. The tag is used only to indicate the picture-taking conditions in the reader
Exif.DigitalZoomRatio | Digital Zoom Ratio | The digital zoom ratio when the image was shot. If the numerator of the recorded value is 0, this indicates that digital zoom was not used
Exif.DocumentName | Document Name |
Exif.ExifIfdPointer | Exif IFD Pointer | A pointer to the Exif IFD. Interoperability, Exif IFD has the same structure as that of the IFD specified in TIFF
Exif.ExifVersion | Exif Version | The version of Exif standard supported. Nonexistence of this field is taken to mean nonconformance to the standard
Exif.ExposureBiasValue | Exposure Bias | The exposure bias. The units is the APEX value. Ordinarily it is given in the range of -99.99 to 99.99
Exif.ExposureIndex | Exposure Index | The exposure index selected on the camera or input device at the time the image is captured
Exif.ExposureMode | Exposure Mode | This tag indicates the exposure mode set when the image was shot. In auto-bracketing mode, the camera shoots a series of frames of the same scene at different exposure settings
Exif.ExposureProgram | Exposure Program | The class of the program used by the camera to set exposure when the picture is taken
Exif.ExposureTime | Exposure Time | Exposure time, given in seconds
Exif.FileSource | File Source | Indicates the image source. If a DSC recorded the image, this tag value of this tag always be set to 3, indicating that the image was recorded on a DSC
Exif.FillOrder | Fill Order |
Exif.Flash | Flash | This tag is recorded when an image is taken using a strobe light (flash)
Exif.FlashEnergy | Flash Energy | Indicates the strobe energy at the time the image is captured, as measured in Beam Candle Power Seconds (BCPS)
Exif.FlashPixVersion | FlashPixVersion | The FlashPix format version supported by a FPXR file
Exif.FNumber | F Number | The F number
Exif.FocalLength | Focal Length | The actual focal length of the lens, in mm. Conversion is not made to the focal length of a 35 mm film camera

Exif.FocalLengthIn35mmFilm

Focal Length In 35mm Film

This tag indicates the equivalent focal length assuming a 35mm film camera, in mm. A value of 0 means the focal length is unknown. Note that this tag differs from the
Exif.FocalLength
tag

Exif.FocalPlaneResolutionUnit

Focal Plane Resolution Unit

Indicates the unit for measuring
Exif.FocalPlaneXResolution
and
Exif.FocalPlaneYResolution
. This value is the same as the
Exif.ResolutionUnit

Exif.FocalPlaneXResolution

Focal Plane x-Resolution

Indicates the number of pixels in the image width (X) direction per
Exif.FocalPlaneResolutionUnit
on the camera focal plane

Exif.FocalPlaneYResolution

Focal Plane y-Resolution

Indicates the number of pixels in the image height (V) direction per
Exif.FocalPlaneResolutionUnit
on the camera focal plane

Exif.GainControl | Gain Control | This tag indicates the degree of overall image gain adjustment
Exif.Gamma | Gamma | Indicates the value of coefficient gamma

Exif.GPS.Altitude

Altitude

Indicates the altitude based on the reference in
Exif.GPS.AltitudeRef
. The reference unit is meters

Exif.GPS.AltitudeRef

Altitude Reference

Indicates the altitude used as the reference altitude. If the reference is sea level and the altitude is above sea level, 0 is given. If the altitude is below sea level, a value of 1 is given and the altitude is indicated as an absolute value in the
Exif.GPS.Altitude
tag. The reference unit is meters

Exif.GPS.InfoIFDPointer | GPS Info IFDPointer | A pointer to the GPS Info IFD. The Interoperability structure of the GPS Info IFD, like that of Exif IFD, has no image data
Exif.GPS.Latitude | Latitude | Indicates the latitude. The latitude is expressed as three RATIONAL values giving the degrees, minutes, and seconds, respectively. When degrees, minutes and seconds are expressed, the format is dd/1,mm/1,ss/1. When degrees and minutes are used and, for example, fractions of minutes are given up to two decimal places, the format is dd/1,mmmm/100,0/1
Exif.GPS.LatitudeRef | North or South Latitude | Indicates whether the latitude is north or south latitude. The ASCII value 'N' indicates north latitude, and 'S' is south latitude
Exif.GPS.Longitude | Longitude | Indicates the longitude. The longitude is expressed as three RATIONAL values giving the degrees, minutes, and seconds, respectively. When degrees, minutes and seconds are expressed, the format is ddd/1,mm/1,ss/1. When degrees and minutes are used and, for example, fractions of minutes are given up to two decimal places, the format is ddd/1,mmmm/100,0/1
Exif.GPS.LongitudeRef | East or West Longitude | Indicates whether the longitude is east or west longitude. ASCII 'E' indicates east longitude, and 'W' is west longitude

Exif.GPS.VersionID

GPS tag version

Indicates the version of
Exif.GPS.InfoIFD
. This tag is mandatory when
Exif.GPS.Info
tag is present

Exif.ImageDescription

Image Description

A character string giving the title of the image. Two-bytes character codes cannot be used. When a 2-bytes code is necessary, the Exif Private tag
Exif.UserComment
is to be used

Exif.ImageLength | Image Length | The number of rows of image data. In JPEG compressed data a JPEG marker is used instead of this tag
Exif.ImageResources | Image Resources Block |
Exif.ImageUniqueID | Image Unique ID | This tag indicates an identifier assigned uniquely to each image. It is recorded as an ASCII string equivalent to hexadecimal notation and 128-bit fixed length
Exif.ImageWidth | Image Width | The number of columns of image data, equal to the number of pixels per row. In JPEG compressed data a JPEG marker is used instead of this tag
Exif.InterColorProfile | Inter Color Profile |

Exif.InteroperabilityIFDPointer

Interoperability IFD Pointer

Interoperability IFD is composed of tags which stores the information to ensure the Interoperability and pointed by the following tag located in Exif IFD. The Interoperability structure of Interoperability IFD is the same as TIFF defined IFD structure but does not contain the image data characteristically compared with normal TIFF IFD

Exif.InteroperabilityIndex | Interoperability Index | Indicates the identification of the Interoperability rule. Use "R98" for stating ExifR98 Rules. Four bytes used including the termination code (NULL)
Exif.InteroperabilityVersion | Interoperability Version |
Exif.IPTC_NAA | IPTC/NAA |
Exif.ISOSpeedRatings | ISO Speed Ratings | Indicates the ISO Speed and ISO Latitude of the camera or input device as specified in ISO 12232
Exif.JPEGInterchangeFormat | JPEG Interchange Format | The offset to the start byte (SOI) of JPEG compressed thumbnail data. This is not used for primary image JPEG data

Exif.JPEGInterchangeFormatLength

JPEG Interchange Format Length

The number of bytes of JPEG compressed thumbnail data. This is not used for primary image JPEG data. JPEG thumbnails are not divided but are recorded as a continuous JPEG bitstream from SOI to EOI. Appn and COM markers should not be recorded. Compressed thumbnails must be recorded in no more than 64 Kbytes, including all other data to be recorded in APP1

Exif.JPEGProc | JPEG Proc |
Exif.LightSource | Light Source | The kind of light source
Exif.Make | Manufacturer | The manufacturer of the recording equipment. This is the manufacturer of the DSC, scanner, video digitizer or other equipment that generated the image. When the field is left blank, it is treated as unknown
Exif.MakerNote | Maker Note | A tag for manufacturers of Exif writers to record any desired information. The contents are up to the manufacturer
Exif.MaxApertureValue | Max Aperture Value | The smallest F number of the lens. The unit is the APEX value. Ordinarily it is given in the range of 00.00 to 99.99, but it is not limited to this range
Exif.MeteringMode | Metering Mode | The metering mode
Exif.Model | Model | The model name or model number of the equipment. This is the model name or number of the DSC, scanner, video digitizer or other equipment that generated the image. When the field is left blank, it is treated as unknown
Exif.NewSubfileType | New Subfile Type | A general indication of the kind of data contained in this subfile

Exif.OECF

OECF

Indicates the Opto-Electoric Conversion Function (OECF) specified in ISO 14524.
Exif.OECF
is the relationship between the camera optical input and the image values

Exif.Orientation | Orientation | The image orientation viewed in terms of rows and columns
Exif.PhotometricInterpretation | Photometric Interpretation | The pixel composition. In JPEG compressed data a JPEG marker is used instead of this tag
Exif.PixelXDimension | Pixel X Dimension | Information specific to compressed data. When a compressed file is recorded, the valid width of the meaningful image must be recorded in this tag, whether or not there is padding data or a restart marker. This tag should not exist in an uncompressed file

Exif.PixelYDimension

Pixel Y Dimension

Information specific to compressed data. When a compressed file is recorded, the valid height of the meaningful image must be recorded in this tag, whether or not there is padding data or a restart marker. This tag should not exist in an uncompressed file. Since data padding is unnecessary in the vertical direction, the number of lines recorded in this valid image height tag will in fact be the same as that recorded in the SOF

Exif.PlanarConfiguration | Planar Configuration | Indicates whether pixel components are recorded in a chunky or planar format. In JPEG compressed files a JPEG marker is used instead of this tag. If this field does not exist, the TIFF default of 1 (chunky) is assumed

Exif.PrimaryChromaticities

Primary Chromaticities

The chromaticity of the three primary colors of the image. Normally this tag is not necessary, since colorspace is specified in
Exif.ColorSpace
tag

Exif.ReferenceBlackWhite | Reference Black/White | The reference black point value and reference white point value. No defaults are given in TIFF, but the values below are given as defaults here. The color space is declared in a color space information tag, with the default being the value that gives the optimal image characteristics Interoperability these conditions
Exif.RelatedImageFileFormat | Related Image File Format |
Exif.RelatedImageLength | Related Image Length |
Exif.RelatedImageWidth | Related Image Width |

Exif.RelatedSoundFile

Related Sound File

This tag is used to record the name of an audio file related to the image data. The only relational information recorded here is the Exif audio file name and extension (an ASCII string consisting of 8 characters + '.' + 3 characters). The path is not recorded. When using this tag, audio files must be recorded in conformance to the Exif audio format. Writers are also allowed to store the data such as Audio within APP2 as FlashPix extension stream data. Audio files must be recorded in conformance to the Exif audio format. If multiple files are mapped to one file, the above format is used to record just one audio file name. If there are multiple audio files, the first recorded file is given. When there are three Exif audio files "SND00001.WAV", "SND00002.WAV" and "SND00003.WAV", the Exif image file name for each of them, "DSC00001.JPG", is indicated. By combining multiple relational information, a variety of playback possibilities can be supported. The method of using relational information is left to the implementation on the playback side. Since this information is an ASCII character string, it is terminated by NULL. When this tag is used to map audio files, the relation of the audio file to image data must also be indicated on the audio file end

Exif.ResolutionUnit

Resolution Unit

The unit for measuring
Exif.XResolution
and
Exif.YResolution
. The same unit is used for both
Exif.XResolution
and
Exif.YResolution
. If the image resolution is unknown, 2 (inches) is designated

Exif.RowsPerStrip | Rows per Strip | The number of rows per strip. This is the number of rows in the image of one strip when an image is divided into strips. With JPEG compressed data this designation is not needed and is omitted
Exif.SamplesPerPixel | Samples per Pixel | The number of components per pixel. Since this standard applies to RGB and YCbCr images, the value set for this tag is 3. In JPEG compressed data a JPEG marker is used instead of this tag
Exif.Saturation | Saturation | This tag indicates the direction of saturation processing applied by the camera when the image was shot

Exif.SceneCaptureType

Scene Capture Type

This tag indicates the type of scene that was shot. It can also be used to record the mode in which the image was shot. Note that this differs from
Exif.SceneType
tag

Exif.SceneType | Scene Type | Indicates the type of scene. If a DSC recorded the image, this tag value must always be set to 1, indicating that the image was directly photographed
Exif.SensingMethod | Sensing Method | Indicates the image sensor type on the camera or input device
Exif.Sharpness | Sharpness | This tag indicates the direction of sharpness processing applied by the camera when the image was shot
Exif.ShutterSpeedValue | Shutter speed | Shutter speed. The unit is the APEX (Additive System of Photographic Exposure) setting
Exif.Software | Software | This tag records the name and version of the software or firmware of the camera or image input device used to generate the image. When the field is left blank, it is treated as unknown
Exif.SpatialFrequencyResponse | Spatial Frequency Response | This tag records the camera or input device spatial frequency table and SFR values in the direction of image width, image height, and diagonal direction, as specified in ISO 12233
Exif.SpectralSensitivity | Spectral Sensitivity | Indicates the spectral sensitivity of each channel of the camera used
Exif.StripByteCounts | Strip Byte Count | The total number of bytes in each strip. With JPEG compressed data this designation is not needed and is omitted
Exif.StripOffsets | Strip Offsets | For each strip, the byte offset of that strip. It is recommended that this be selected so the number of strip bytes does not exceed 64 Kbytes. With JPEG compressed data this designation is not needed and is omitted
Exif.SubIFDs | Sub IFD Offsets | Defined by Adobe Corporation to enable TIFF Trees within a TIFF file
Exif.SubjectArea | Subject Area | This tag indicates the location and area of the main subject in the overall scene
Exif.SubjectDistance | Subject Distance | The distance to the subject, given in meters
Exif.SubjectDistanceRange | Subject Distance Range | This tag indicates the distance to the subject

Exif.SubjectLocation

Subject Location

Indicates the location of the main subject in the scene. The value of this tag represents the pixel at the center of the main subject relative to the left edge, prior to rotation processing as per the
Exif.Rotation
tag. The first value indicates the X column number and second indicates the Y row number

Exif.SubsecTime

Subsec Time

A tag used to record fractions of seconds for the
Exif.DateTime
tag

Exif.SubSecTimeDigitized

Subsec Time Digitized

A tag used to record fractions of seconds for the
Exif.DateTimeDigitized
tag

Exif.SubSecTimeOriginal

Subsec Time Original

A tag used to record fractions of seconds for the
Exif.DateTimeOriginal
tag

Exif.TIFF/EPStandardID | TIFF/EP Standard ID |

Exif.TransferFunction

Transfer Function

A transfer function for the image, described in tabular style. Normally this tag is not necessary, since color space is specified in
Exif.ColorSpace
tag

Exif.TransferRange | Transfer Range |

Exif.UserComment

User Comment

A tag for Exif users to write keywords or comments on the image besides those in
Exif.ImageDescription
, and without the character code limitations of the
Exif.ImageDescription
tag. The character code used in the
Exif.UserComment
tag is identified based on an ID code in a fixed 8-byte area at the start of the tag data area. The unused portion of the area is padded with NULL ("00.h"). ID codes are assigned by means of registration. The value of CountN is determinated based on the 8 bytes in the character code area and the number of bytes in the user comment part. Since the TYPE is not ASCII, NULL termination is not necessary. The ID code for the
Exif.UserComment
area may be a Defined code such as JIS or ASCII, or may be Undefined. The Undefined name is UndefinedText, and the ID code is filled with 8 bytes of all "NULL" ("00.H"). An Exif reader that reads the
Exif.UserComment
tag must have a function for determining the ID code. This function is not required in Exif readers that do not use the
Exif.UserComment
tag. When a
Exif.UserComment
area is set aside, it is recommended that the ID code be ASCII and that the following user comment part be filled with blank characters [20.H]

Exif.WhiteBalance | White Balance | The white balance mode set when the image was shot

Exif.WhitePoint

White Point

The chromaticity of the white point of the image. Normally this tag is not necessary, since color space is specified in
Exif.ColorSpace
tag

Exif.XMLPacket | XML Packet | XMP Metadata

Exif.XResolution

x Resolution

The number of pixels per
Exif.ResolutionUnit
in the
Exif.ImageWidth
direction. When the image resolution is unknown, 72 [dpi] is designated

Exif.YCbCrCoefficients | YCbCr Coefficients | The matrix coefficients for transformation from RGB to YCbCr image data. No default is given in TIFF; but here "Color Space Guidelines" is used as the default. The color space is declared in a color space information tag, with the default being the value that gives the optimal image characteristics Interoperability this condition

Exif.YCbCrPositioning

YCbCr Positioning

The position of chrominance components in relation to the luminance component. This field is designated only for JPEG compressed data or uncompressed YCbCr data. The TIFF default is 1 (centered); but when Y:Cb:Cr = 4:2:2 it is recommended that 2 (co-sited) be used to record data, in order to improve the image quality when viewed on TV systems. When this field does not exist, the reader shall assume the TIFF default. In the case of Y:Cb:Cr = 4:2:0, the TIFF default (centered) is recommended. If the reader does not have the capability of supporting both kinds of
Exif.YCbCrPositioning
, it shall follow the TIFF default regardless of the value in this field. It is preferable that readers be able to support both centered and co-sited positioning

Exif.YCbCrSubSampling | YCbCr Sub-Sampling | The sampling ratio of chrominance components in relation to the luminance component. In JPEG compressed data a JPEG marker is used instead of this tag

Exif.YResolution

y Resolution

The number of pixels per
Exif.ResolutionUnit
in the
Exif.ImageLength
direction. The same value as
Exif.XResolution
is designated

File.Accessed | Accessed | Last access datetime
File.Content | Content | File's contents filtered as plain text
File.Description | Description | Editable free text/notes
File.Format | Format | MIME type of the file or if a directory it should contain value "Folder"
File.IconPath | Icon Path | Editable file URI for a custom icon for the file
File.Keywords | Keywords | Editable array of keywords
File.LargeThumbnailPath | Large Thumbnail Path | Editable file URI for a larger thumbnail of the file suitable for previews
File.Link | Link | URI of link target
File.Modified | Modified | Last modified datetime
File.Name | Name | File name excluding path but including the file extension
File.Path | Path | Full file path of file excluding the filename
File.Permissions | Permissions | Permission string in unix format eg "-rw-r--r--"
File.Publisher | Publisher | Editable DC type for the name of the publisher of the file (EG dc:publisher field in RSS feed)
File.Rank | Rank | Editable file rank for grading favourites. Value should be in the range 1..10
File.Size | Size | Size of the file in bytes or if a directory number of items it contains
File.SmallThumbnailPath | Small Thumbnail Path | Editable file URI for a small thumbnail of the file suitable for use in icon views
ID3.Album | Album | Name of the album
ID3.AlbumSortOrder | Album Sort Order | String which should be used instead of the album name for sorting purposes
ID3.AudioCrypto | Audio Encryption | Frame indicates if the audio stream is encrypted, and by whom
ID3.AudioSeekPoint | Audio Seek Point | Fractional offset within the audio data, providing a starting point from which to find an appropriate point to start decoding
ID3.Band | Band | Additional information about the performers in the recording
ID3.Bitrate | Bitrate | Bitrate in kbps
ID3.BPM | BPM | BPM (beats per minute)
ID3.BufferSize | Buffer Size | Recommended buffer size
ID3.CDID | CD ID | Music CD identifier
ID3.ChannelMode | Channel mode | Channel mode
ID3.Channels | Channels | Number of channels in the audio (2 = stereo)
ID3.Comment | Comment | Comments on the track
ID3.Commercial | Commercial | Commercial frame
ID3.Composer | Composer | Composer
ID3.Conductor | Conductor | Conductor
ID3.ContentGroup | Content Group | Content group description
ID3.ContentType | Content Type | Type of music classification for the track as defined in ID3 spec
ID3.Copyright | Copyright | Copyright message
ID3.CryptoReg | Encryption Registration | Encryption method registration
ID3.Date | Date | Date
ID3.Duration | Duration | Duration of track in seconds
ID3.Duration.MMSS | Duration [MM:SS] | Duration of track as MM:SS
ID3.Emphasis | Emphasis | Emphasis
ID3.EncodedBy | Encoded By | Person or organisation that encoded the audio file. This field may contain a copyright message, if the audio file also is copyrighted by the encoder
ID3.EncoderSettings | Encoder Settings | Software
ID3.EncodingTime | Encoding Time | Encoding time
ID3.Equalization | Equalization | Equalization
ID3.Equalization2 | Equalization 2 | Equalisation curve predifine within the audio file
ID3.EventTiming | Event Timing | Event timing codes
ID3.FileOwner | File Owner | File owner
ID3.FileType | File Type | File type
ID3.Frames | Frames | Number of frames
ID3.GeneralObject | General Object | General encapsulated object
ID3.Genre | Genre | Type of music classification for the track as defined in ID3 spec
ID3.GroupingReg | Grouping Registration | Group identification registration
ID3.InitialKey | Initial Key | Initial key
ID3.InvolvedPeople | Involved People | Involved people list
ID3.InvolvedPeople2 | InvolvedPeople2 | Involved people list
ID3.ISRC | ISRC | ISRC (international standard recording code)
ID3.Language | Language | Language
ID3.LeadArtist | Lead Artist | Lead performer(s)
ID3.LinkedInfo | Linked Info | Linked information
ID3.Lyricist | Lyricist | Lyricist
ID3.MediaType | Media Type | Media type
ID3.MixArtist | Mix Artist | Interpreted, remixed, or otherwise modified by
ID3.Mood | Mood | Mood
ID3.MPEG.Layer | Layer | MPEG layer
ID3.MPEG.Lookup | MPEG Lookup | MPEG location lookup table
ID3.MPEG.Version | MPEG Version | MPEG version
ID3.MusicianCreditList | Musician Credit List | Musician credits list
ID3.NetRadioOwner | Net Radio Owner | Internet radio station owner
ID3.NetRadiostation | Net Radiostation | Internet radio station name
ID3.OriginalAlbum | Original Album | Original album
ID3.OriginalArtist | Original Artist | Original artist
ID3.OriginalFileName | Original File Name | Original filename
ID3.OriginalLyricist | Original Lyricist | Original lyricist
ID3.OriginalReleaseTime | Original Release Time | Original release time
ID3.OriginalYear | Original Year | Original release year
ID3.Ownership | Ownership | Ownership frame
ID3.PartInSet | Part of a Set | Part of a set the audio came from
ID3.PerformerSortOrder | Performer Sort Order | Performer sort order
ID3.Picture | Picture | Attached picture
ID3.PlayCounter | Play Counter | Number of times a file has been played
ID3.PlaylistDelay | Playlist Delay | Playlist delay
ID3.Popularimeter | Popularimeter | Rating of the audio file
ID3.PositionSync | Position Sync | Position synchronisation frame
ID3.Private | Private | Private frame
ID3.ProducedNotice | Produced Notice | Produced notice
ID3.Publisher | Publisher | Publisher
ID3.RecordingDates | Recording Dates | Recording dates
ID3.RecordingTime | Recording Time | Recording time
ID3.ReleaseTime | Release Time | Release time
ID3.Reverb | Reverb | Reverb
ID3.SampleRate | Sample Rate | Sample rate in Hz
ID3.SetSubtitle | Set Subtitle | Subtitle of the part of a set this track belongs to
ID3.Signature | Signature | Signature frame
ID3.Size | Size | Size of the audio file in bytes, excluding the ID3 tag
ID3.SongLength | Song length | Length of the song in milliseconds
ID3.Subtitle | Subtitle | Subtitle
ID3.Syncedlyrics | Syncedlyrics | Synchronized lyric
ID3.SyncedTempo | Synchronized Tempo | Synchronized tempo codes
ID3.TaggingTime | Tagging Time | Tagging time
ID3.TermsOfUse | Terms Of Use | Terms of use
ID3.Time | Time | Time
ID3.Title | Title | Title of the track
ID3.Titlesortorder | Titlesortorder | Title sort order
ID3.TrackNo | Track number | Position of track on the album
ID3.UniqueFileID | Unique File ID | Unique file identifier
ID3.UnsyncedLyrics | Unsynchronized Lyrics | Unsynchronized lyric
ID3.UserText | User Text | User defined text information
ID3.VolumeAdj | Volume Adjustment | Relative volume adjustment
ID3.VolumeAdj2 | Volume Adjustment 2 | Relative volume adjustment
ID3.WWWArtist | WWW Artist | Official artist
ID3.WWWAudioFile | WWW Audio File | Official audio file webpage
ID3.WWWAudioSource | WWW Audio Source | Official audio source webpage
ID3.WWWCommercialInfo | WWW Commercial Info | URL pointing at a webpage containing commercial information
ID3.WWWCopyright | WWW Copyright | URL pointing at a webpage that holds copyright
ID3.WWWPayment | WWW Payment | URL pointing at a webpage that will handle the process of paying for this file
ID3.WWWPublisher | WWW Publisher | URL pointing at the official webpage for the publisher
ID3.WWWRadioPage | WWW Radio Page | Official internet radio station homepage
ID3.WWWUser | WWW User | User defined URL link
ID3.Year | Year | Year
Image.Album | Album | Name of an album the image belongs to
Image.CameraMake | Camera Make | Make of camera used to take the image
Image.CameraModel | Camera Model | Model of camera used to take the image
Image.Comments | Comments | User definable free text
Image.Copyright | Copyright | Embedded copyright message
Image.Creator | Creator | Name of the author
Image.Date | Date | Datetime image was originally created
Image.Description | Description | Description of the image
Image.ExposureProgram | Exposure Program | The program used by the camera to set exposure when the picture is taken. EG Manual, Normal, Aperture priority etc
Image.ExposureTime | Exposure Time | Exposure time used to capture the photo in seconds
Image.Flash | Flash | Set to "1" if flash was fired
Image.Fnumber | F number | Diameter of the aperture relative to the effective focal length of the lens
Image.FocalLength | Focal Length | Focal length of lens in mm
Image.Height | Height | Height in pixels
Image.ISOSpeed | ISO Speed | ISO speed used to acquire the document contents. For example, 100, 200, 400, etc
Image.Keywords | Keywords | String of keywords
Image.MeteringMode | Metering Mode | Metering mode used to acquire the image (IE Unknown, Average, CenterWeightedAverage, Spot, MultiSpot, Pattern, Partial)
Image.Orientation | Orientation | Represents the orientation of the image wrt camera (IE "top,left" or "bottom,right")
Image.Software | Software | Software used to produce/enhance the image
Image.Title | Title | Title of image
Image.WhiteBalance | White Balance | White balance setting of the camera when the picture was taken (auto or manual)
Image.Width | Width | Width in pixels
IPTC.ActionAdvised | Action Advised | The type of action that this object provides to a previous object. '01' Object Kill, '02' Object Replace, '03' Object Append, '04' Object Reference
IPTC.ARMID | ARM Identifier | Identifies the Abstract Relationship Method (ARM)
IPTC.ARMVersion | ARM Version | Identifies the version of the Abstract Relationship Method (ARM)
IPTC.AudioDuration | Audio Duration | The running time of the audio data in the form HHMMSS
IPTC.AudioOutcue | Audio Outcue | The content at the end of the audio data
IPTC.AudioSamplingRate | Audio Sampling Rate | The sampling rate in Hz of the audio data
IPTC.AudioSamplingRes | Audio Sampling Resolution | The number of bits in each audio sample
IPTC.AudioType | Audio Type | The number of channels and type of audio (music, text, etc.) in the object
IPTC.Byline | By-line | Name of the creator of the object, e.g. writer, photographer or graphic artist
IPTC.BylineTitle | By-line Title | Title of the creator or creators of the object
IPTC.Caption | Caption/Abstract | A textual description of the data
IPTC.Category | Category | Identifies the subject of the object in the opinion of the provider (Deprecated)
IPTC.CharacterSet | Coded Character Set | Control functions used for the announcement, invocation or designation of coded character sets
IPTC.City | City | City of object origin
IPTC.ConfirmedDataSize | Confirmed Data Size | Total size of the object data
IPTC.Contact | Contact | The person or organization which can provide further background information on the object
IPTC.ContentLocCode | Content Location Code | Indicates the code of a country/geographical location referenced by the content of the object
IPTC.ContentLocName | Content Location Name | A full, publishable name of a country/geographical location referenced by the content of the object
IPTC.CopyrightNotice | Copyright Notice | Any necessary copyright notice
IPTC.CountryCode | Country Code | The code of the country/primary location where the object was created
IPTC.CountryName | Country Name | The name of the country/primary location where the object was created
IPTC.Credit | Credit | Identifies the provider of the object, not necessarily the owner/creator
IPTC.DateCreated | Date Created | The date the intellectual content of the object was created rather than the date of the creation of the physical representation
IPTC.DateSent | Date Sent | The day the service sent the material
IPTC.Destination | Destination | Routing information
IPTC.DigitalCreationDate | Digital Creation Date | The date the digital representation of the object was created
IPTC.DigitalCreationTime | Digital Creation Time | The time the digital representation of the object was created
IPTC.EditorialUpdate | Editorial Update | Indicates the type of update this object provides to a previous object. The link to the previous object is made using the ARM. '01' indicates an additional language
IPTC.EditStatus | Edit Status | Status of the object, according to the practice of the provider
IPTC.EnvelopeNum | Envelope Number | A number unique for the date in 1:70 and the service ID in 1:30
IPTC.EnvelopePriority | Envelope Priority | Specifies the envelope handling priority and not the editorial urgency. '1' for most urgent, '5' for normal, and '8' for least urgent. '9' is user-defined
IPTC.ExpirationDate | Expiration Date | Designates the latest date the provider intends the object to be used
IPTC.ExpirationTime | Expiration Time | Designates the latest time the provider intends the object to be used
IPTC.FileFormat | File Format | File format of the data described by this metadata
IPTC.FileVersion | File Version | Version of the file format
IPTC.FixtureID | Fixture Identifier | Identifies objects that recur often and predictably, enabling users to immediately find or recall such an object
IPTC.Headline | Headline | A publishable entry providing a synopsis of the contents of the object
IPTC.ImageOrientation | Image Orientation | The layout of the image area: 'P' for portrait, 'L' for landscape, and 'S' for square
IPTC.ImageType | Image Type | Indicates the data format of the image object
IPTC.Keywords | Keywords | Used to indicate specific information retrieval words
IPTC.LanguageID | Language Identifier | The major national language of the object, according to the 2-letter codes of ISO 639:1988
IPTC.MaxObjectSize | Maximum Object Size | The largest possible size of the object if the size is not known
IPTC.MaxSubfileSize | Max Subfile Size | The maximum size for a subfile dataset (8:10) containing a portion of the object data
IPTC.ModelVersion | Model Version | Version of IIM part 1
IPTC.ObjectAttribute | Object Attribute Reference | Defines the nature of the object independent of the subject
IPTC.ObjectCycle | Object Cycle | Where 'a' is morning, 'p' is evening, 'b' is both
IPTC.ObjectName | Object Name | A shorthand reference for the object
IPTC.ObjectSizeAnnounced | Object Size Announced | The total size of the object data if it is known
IPTC.ObjectType | Object Type Reference | Distinguishes between different types of objects within the IIM
IPTC.OriginatingProgram | Originating Program | The type of program used to originate the object
IPTC.OrigTransRef | Original Transmission Reference | A code representing the location of original transmission
IPTC.PreviewData | Preview Data | The object preview data
IPTC.PreviewFileFormat | Preview File Format | Binary value indicating the file format of the object preview data in dataset 2:202
IPTC.PreviewFileFormatVer | Preview File Format Version | The version of the preview file format specified in 2:200
IPTC.ProductID | Product ID | Allows a provider to identify subsets of its overall service
IPTC.ProgramVersion | Program Version | The version of the originating program
IPTC.Province | Province/State | The Province/State where the object originates
IPTC.RasterizedCaption | Rasterized Caption | Contains rasterized object description and is used where characters that have not been coded are required for the caption
IPTC.RecordVersion | Record Version | Identifies the version of the IIM, Part 2
IPTC.RefDate | Reference Date | The date of a prior envelope to which the current object refers
IPTC.RefNumber | Reference Number | The Envelope Number of a prior envelope to which the current object refers
IPTC.RefService | Reference Service | The Service Identifier of a prior envelope to which the current object refers
IPTC.ReleaseDate | Release Date | Designates the earliest date the provider intends the object to be used
IPTC.ReleaseTime | Release Time | Designates the earliest time the provider intends the object to be used
IPTC.ServiceID | Service Identifier | Identifies the provider and product
IPTC.SizeMode | Size Mode | Set to 0 if the size of the object is known and 1 if not known
IPTC.Source | Source | The original owner of the intellectual content of the object
IPTC.SpecialInstructions | Special Instructions | Other editorial instructions concerning the use of the object
IPTC.State | Province/State | The Province/State where the object originates
IPTC.Subfile | Subfile | The object data itself. Subfiles must be sequential so that the subfiles may be reassembled
IPTC.SubjectRef | Subject Reference | A structured definition of the subject matter. It must contain an IPR, an 8 digit Subject Reference Number and an optional Subject Name, Subject Matter Name, and Subject Detail Name each separated by a colon (:)
IPTC.Sublocation | Sub-location | The location within a city from which the object originates
IPTC.SupplCategory | Supplemental Category | Further refines the subject of the object (Deprecated)
IPTC.TimeCreated | Time Created | The time the intellectual content of the object was created rather than the date of the creation of the physical representation
IPTC.TimeSent | Time Sent | The time the service sent the material
IPTC.UNO | Unique Name of Object | An eternal, globally unique identification for the object, independent of provider and for any media form
IPTC.Urgency | Urgency | Specifies the editorial urgency of content and not necessarily the envelope handling priority. '1' is most urgent, '5' normal, and '8' least urgent
IPTC.WriterEditor | Writer/Editor | The name of the person involved in the writing, editing or correcting the object or caption/abstract

Non-existent metatags are expanded to empty strings.

#### Ranges

Ranges are a method of accessing a part of a string. The concept of ranges is based on python slices.

A range (start_index:end_index) starts at the start_index and finishes one character before the end_index.

Range syntax

- (start_index:end_index)

- (start_index) ≡ (start_index:)

- (start_index,length) ≡ (start_index:start_index+length)

If one of the indices is dropped, it is assumed that you want everything in that direction. I.e. (:3) means "every character from the beginning of the string up to character 3, non-inclusive." (3:) would, on the other hand, mean "every character from the string, starting at character 3 (inclusive) up to, and including, the last one." If index is negative, it is relative to the end of the string. Index -3 stands for "the third character from the end of the string".

Position of the first letter is '0'.

#### strftime() format controls

Placeholder | Replacement
--- | ---
%a | The abbreviated weekday name according to the current locale
%A | The abbreviated month name according to the current locale
%b | The abbreviated month name according to the current locale
%B | The full month name according to the current locale
%c | The preferred date and time representation for the current locale
%C | The century number (year/100) as a 2-digit integer
%d | The day of the month as a decimal number (range 01 to 31)
%e | Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space
%E | Modifier: use alternative format, see below
%F | Equivalent to %Y-%m-%d (the ISO 8601 date format)
%G | The ISO 8601 year with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %y, except that if the ISO week number belongs to the previous or next year, that year is used instead
%g | Like %G, but without century, i.e., with a 2-digit year (00-99)
%h | Equivalent to %b
%H | The hour as a decimal number using a 24-hour clock (range 00 to 23)
%I | The hour as a decimal number using a 12-hour clock (range 01 to 12)
%j | The day of the year as a decimal number (range 001 to 366)
%k | The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank (see also %H)
%l | The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank (see also %I)
%m | The month as a decimal number (range 01 to 12)
%M | The minute as a decimal number (range 00 to 59)
%O | Modifier: use alternative format, see below
%p | Either "AM" or "PM" according to the given time value, or the corresponding strings for the current locale. Noon is treated as "pm" and midnight as "am"
%P | Like %p but in lowercase: "am" or "pm" or a corresponding string for the current locale
%r | The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to "%I:%M:%S %p"
%R | The time in 24-hour notation (%H:%M). For a version including the seconds, see %T below
%s | The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC
%S | The second as a decimal number (range 00 to 61)
%T | The time in 24-hour notation (%H:%M:%S)
%u | The day of the week as a decimal, range 1 to 7, Monday being 1. See also %w
%U | The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W
%V | The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. See also %U and %W
%w | The day of the week as a decimal, range 0 to 6, Sunday being 0. See also %u
%W | The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01
%x | The preferred date representation for the current locale without the time
%X | The preferred time representation for the current locale without the date
%y | The year as a decimal number without a century (range 00 to 99)
%Y | The year as a decimal number including the century
%z | The time-zone as hour offset from GMT. Required to emit RFC822-conformant dates (using "%a, %d %b %Y %H:%M:%S %z")
%Z | The time zone or name or abbreviation
%+ | The date and time in date format
%% | A literal "%" character

Some conversion specifiers can be modified by preceding them by the E or O modifier to indicate that an alternative format should be used. If the alternative format or specification does not exist for the current locale, the behaviour will be as if the unmodified conversion specification were used. The Single Unix Specification mentions %Ec, %EC, %Ex, %EX, %Ey, %EY, %Od, %Oe, %OH, %OI, %Om, %OM, %OS, %Ou, %OU, %OV, %Ow, %OW, %Oy, where the effect of the O modifier is to use alternative numeric symbols (say, roman numerals), and that of the E modifier is to use a locale-dependent alternative representation.

### Using the Internal Viewer

The internal viewer allows viewing contents of files in text, unicode, binary, hex or graphical mode.

To start viewing files use F3 (default viewer - defined in Settings Options... ) or SHIFTF3 (internal viewer). The internal viewer uses MMAP whenever possible for the fastest file loading.

#### View Modes

The View Modes group contains the preferences that you can set to view images in image windows.

Character Encodings
Text Display Mode
Binary Display Mode
Hex dump Display Mode
Image Display Mode

  Use this drop-down list box to specify when to use scrollbars to scroll through an image. Select one of the following options:

Pick window size and zoom factor automatically

  Select this option to resize the image window to fit the image or to resize the image to fit the image window. If the image is small, &app; resizes the image window to fit the image. If the image is large, &app; resizes the image to fit the image window.

  Default: unselected.

#### To Scroll an Image

To scroll around an image that is larger than the image window or full screen window, you can use the following methods:

- Use the arrow keys on the keyboard.

- Drag the image in the opposite direction to the direction in which you want to scroll. For example, if you want to scroll down the image, drag the image upwards in the window.

- Use the scrollbars on the window.

#### Keyboard mappings

Shortcut | Mapping
--- | ---
Escape CTRLW | Closes the internal viewer window
W | Toggles line wrapping (applicable only in text display modes)
Input Modes:
A | Sets ASCII input mode. When in ASCII mode, you can also set the required character encoding from the "View|Character Encoding" submenu
Q | Sets ASCII input mode, with codepage 437 encoding (suitable for binary and hex mode viewing)
U | Sets UTF-8 input mode
Display modes:
1 | Sets display mode to text, with fixed width font
2 | Sets display mode to binary. Switching to Binary display mode will automatically set ASCII input mode (UTF-8 is not supported with binary display)
3 | Sets display mode to hex dump. Switching to hex display mode will automatically set ASCII input mode (UTF-8 is not supported with hex dump display)
4 | Tries to load the file as an image. Loading is done using GDK, so every GDK-supported format should work.
Zooming:
CTRL+ | Zooms in or increment the font size
CTRL- | Zooms out or decrement the font size
CTRL0 | Sets normal size
Image manipulation:
CTRLR | Rotates the image 90° (applicable only in IMAGE display mode)
CTRLSHIFTR | Rotates the image 270° (applicable only in IMAGE display mode)
Image manipulation:
CTRLS | Saves the current window size, input mode, and other settings as the default. Starting display mode is determined by the file's content, and is not saved as a user setting.

## Settings

To configure &app;, choose Settings Options... The Options dialog contains the following tabbed sections:

### General

#### General options

Shows &app; options dialog.

### Format

#### Format options

Shows &app; options dialog.

### Layout

#### Layout options

Shows &app; options dialog.

### Confirmation

#### Confirmation options

Shows &app; options dialog.

### Filters

#### Filters options

Shows &app; options dialog.

### Programs

#### Programs options

Shows &app; options dialog.

### Devices

#### Devices options

Shows &app; options dialog.

## Keyboard mappings

Some keyboard shortcuts may not work as expected under the Gnome environment. The reason for that is that Gnome uses some global shortcuts (i.e. ALTF7 moves the entire application window), which suppresses assigned keyboard mapping of &app;. Use the GNOME Keyboard Shortcuts preference tool to customize the default keyboard shortcuts to your requirements.

Shortcut | Mapping | User definable
--- | --- | ---
F1 | Help |
F2 | Refresh files in the active file list |
F3 | View files |
F4 | Edit files |
F5 | Copy files |
F6 | Rename or move files |
F7 | Create directory |
F8 | Delete files |
F9 | Search |
F10 | Quit |
ALT1 | Change left connection |
ALT2 | Change right connection |
ALTF3 | View with external viewer | yes
ALTF7 | Search |
ALTF8 | Open the history list for the command line |
SHIFTF2 | Compare directories |
SHIFTF3 | View with internal viewer | yes
SHIFTF4 | Edit a new file |
SHIFTF5 | Make a copy a file in the current directory. |
SHIFTF6 | Rename a file |
SHIFTF10 | Bring up the context menu for the selected files. |
CTRLF3 | Sort by name |
CTRLF4 | Sort by extension |
CTRLF5 | Sort by date/time |
CTRLF6 | Sort by size |
CTRLF7 | Unsorted |
CTRLSHIFTF5 | Create symbolic link | yes
= | Select files using a pattern |
NUM + | Select files using a pattern |
NUM - | Unselect files using a pattern |
NUM * | Invert selection |
NUM / | Restore selection |
CTRL= | Select all files |
CTRL- | Unselect all files |
ALTNUM + | Select all files with the same extension |
ALTNUM - | Unselect all files with the same extension |
BACKSPACE CTRLPageUp | Change to parent directory (cd ..) |
ENTER | Change directory or execute command line if not empty |
SHIFTENTER | Execute command line in the defined terminal and leaves the terminal window open |
CTRLPageDown | Change directory |
ALTLEFT | Go back to the last visited directory |
ALTRIGHT | Go forward to the next visited directory |
CTRL\ | Go to the root directory |
CTRL` | Go to the home directory |
INSERT | Select file or directory |
SPACE | Select file or directory (as INSERT). If SPACE is used on an unselected directory under the cursor, the contents in this directory are counted and the size is shown in the "full" view instead of the string DIR |
ALTENTER | Show properties for the selected file |
ALTSHIFTENTER | The contents of all directories in the current directory are counted. The sizes of the directories are then shown in the "full" view instead of the string DIR |
DELETE | Delete files |
CTRLC | Copy files to clipboard (not a global one yet) |
CTRLX | Cut files to clipboard (not a global one yet) |
CTRLV | Paste from clipboard to current dir (not a global one yet) |
CTRLSHIFTC | Copy selected file names to clipboard |
CTRLA | Select all files | yes
CTRLSHIFTA | Unselect all files | yes
CTRLD | Open favorite directories (bookmarks) | yes
CTRLM | Multi-Rename-Tool | yes
CTRLT | Multi-Rename-Tool | yes
TAB | Switch between left and right file list |
CTRLU | Switch between left and right file list |
CTRL. | Copy the current working directory from the inactive file list to the active one |
CTRLSHIFT. | Copy the current working directory from the active file list to the inactive one |
CTRLR | Refresh the active file list | yes
CTRLO | Options dialog | yes
CTRLSHIFTH | Toggle hidden files on/off |
CTRLSHIFT= | Set both panels equal |
CTRLG | FTP Quick Connect | yes
CTRLF | Connect to FTP server | yes
CTRLSHIFTF | Disconnect from FTP server | yes
CTRL5 | Create MD5 (128-bit) checksum | yes
ALTLetter(s) CTRLALTLetter(s) | Quick search for a file name (starting with specified letter) in the current directory |
Letter | Redirect to command line, cursor jumps to command line |
ESC | Clear the command line |
CTRLK | Delete to the end of line |
CTRLW | Delete the word to the left of the cursor |
CTRLT | Delete the word to the right of the cursor |
CTRLP | The full path of the current directory is added to the command line |
CTRLENTER | The file name under the cursor in the source directory is added to the end of the command line |
CTRLSHIFTENTER | The file name under the cursor including its path is added to the end of the command line |
CTRLDOWN ALTF8 | A list with the latest command lines (history list) is opened. Use the UP and DOWN cursor keys to select an entry. By pressing the LEFT or RIGHT key, you can edit the command line. This automatically closes the list |

## User actions

User actions allow user assigning a key or set of keys to trigger predefined &app; functions (actions). For example, `plugins.execute_python|sha1.sum` will compute SHA1 checksums for selected files.

User actions are supported since version 1.2.4

### Managing user actions

Key bindings reside in [key-bindings] section of &app; config file (

~/.gnome2/gnome-commander
). Currently there is no GUI for key configuration management.

Config file syntax:

`[<shift>][<control>][<alt>][<win>]key_name=action[|options]`

eg.

        <ctrl>m=file.advrename
        <ctrl>t=file.advrename
        <shift><ctrl>f5=file.create_symlink
        <ctrl>2=file.diff
        <win>f=edit.search

It's possible to assign one action to more than one key.

The shortcuts are read at start-up only, so you have to reload application to see the changes.

Entries containing invalid key or user action are reported in console during start-up and then ignored by &app;.

### List of user actions

User action | Description | Default key bindings
--- | --- | ---
bookmarks.add_current | Bookmark current directory |
bookmarks.edit | Open favourite directories (bookmarks) dialog | CTRLD
connections.close | Close connections |
connections.close_current | Disconnect from FTP server | CTRLSHIFTF
connections.ftp_connect | Connect to FTP server | CTRLF
connections.ftp_quick_connect | FTP Quick Connect | CTRLG
edit.copy | Copy files to clipboard (not a global one yet) |
edit.copy_filenames | Copy file names to clipboard | CTRLSHIFTC
edit.cut | Cut files to clipboard (not a global one yet) |
edit.delete | Delete files |
edit.filter | Use file selection filter | CTRLF12
edit.paste | Paste from clipboard to current dir (not a global one yet) |
edit.quick_search | Quick search |
edit.search | File search | ALTF7
file.advrename | Multi-Rename-Tool | CTRLM CTRLT
file.chmod | Show file access permissions |
file.chown | Show file ownership |
file.copy | Copy files |
file.create_symlink | Create symbolic link | CTRLSHIFTF5
file.delete | Delete files |
file.diff | Compare files (diff) |
file.edit | Edit files |
file.exit | Exit &app; |
file.external_view | View with external viewer | ALTF3
file.internal_view | View with internal viewer | SHIFTF3
file.mkdir | Create directory |
file.move | Move files |
file.properties | Show properties for the selected file |
file.rename | Rename files |
file.synchronize_directories | Synchronize directories (using meld) |
file.view | View files |
help.about | About &app; |
help.help | Help |
help.keyboard | Help on keayboard shortcuts |
help.problem | Report problem to Bugzilla |
help.web | Visit &app; home page |
mark.compare_directories | Compare directories |
mark.select_all | Select all files | CTRLA CTRL= CTRLNUM +
mark.toggle | Toggle selection for cursor |
mark.toggle_and_step | Select file or directory and move cursor downward |
mark.unselect_all | Unselect all files | CTRLSHIFTA CTRL- CTRLNUM -
no.action | Do nothing (use to block key bindings) |
options.edit | Options dialog | CTRLO
options.edit_mime_types | Edit MIME types |
plugins.configure | Configure plugins |
plugins.execute_python | Execute python plugin |
view.back | Go back to the last visited directory |
view.equal_panes | Set equal panes (50/50) |
view.first | Go forward to the first visited directory |
view.forward | Go forward to the next visited directory |
view.last | Go forward to the last visited directory |
view.refresh | Refresh the active file list | CTRLR
view.up | Go forward to the parent directory |

Action names are case insensitive.

### List of key symbols

Key names are case insensitive (<ctrl>a=<ctrl>A).

- a..z, 0..9

- ampersand, apostrophe, asciicircum, asciitilde, asterisk, at, backslash, bar, braceleft, braceright, bracketleft, bracketright, colon, comma, dollar, equal, exclam, greater, less, minus, numbersign, parenleft, parenright, percent, period, plus, question, quotedbl, quoteleft, quoteright, semicolon, slash, space, underscore

- f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, f11, f12, f13, f14, f15, f16, f17, f18, f19, f20, f21, f22, f23, f24, f25, f26, f27, f28, f29, f30, f31, f32, f33, f34, f35

- kp.0, kp.1, kp.2, kp.3, kp.4, kp.5, kp.6, kp.7, kp.8, kp.9, kp.add, kp.begin, kp.decimal, kp.delete, kp.divide, kp.down, kp.end, kp.enter, kp.equal, kp.f1, kp.f2, kp.f3, kp.f4, kp.home, kp.insert, kp.left, kp.multiply, kp.next, kp.page.down, kp.page.up, kp.prior, kp.right, kp.separator, kp.space, kp.subtract, kp.tab, kp.up ('kp' stands for keypad)

- caps.lock, num.lock, scroll.lock, shift.lock

- backspace, begin, break, cancel, clear, codeinput, delete, down, eisu.shift, eisu.toggle, end, escape, execute, find, first.virtual.screen, help, home, hyper.l, hyper.r, insert, last.virtual.screen, left, linefeed, menu, meta.l, meta.r, mode.switch, multiplecandidate, multi.key, next, next.virtual.screen, page.down, page.up, pause, previouscandidate, prev.virtual.screen, print, prior, redo, return, right, script.switch, select, singlecandidate, super.l, super.r, sys.req, tab, terminate.server, undo, up

The list is based on GDK key symbols taken from gdkkeysyms.h.

## Python plugins

Since version 1.2.4 &app; is capable of executing python plugins. Python plugin is a normal python application containing predefined entry function.

&app; comes with built-in plugins:

- `md5sum` - MD5 (128-bit) checksums of the selected files

- `sha1sum` - SHA-1 (160-bit) checksums of the selected files

### Working with plugins

To start - simply place your plugin in `~/.gnome-commander/plugins/` directory. If the plugin is meant to be accessed system widely, use alternate location: `$(libdir)/$(PACKAGE)/plugins/`.

Plugins will be added as new entries to the &app; context menus.

Keyboard shortcuts can be assigned to execute specific python plugins (eg. CTRL5 → `md5sum`).

#### Python plugins requirements

build

  python-devel ⩾ 2.4

run

  python ⩾ 2.4

  gnome-python2-gnomevfs

  pygtk (for GUI)

### Plugins API

The entry (start) point for plugin is always main() function:

        def main(main_wnd_xid, active_cwd, inactive_cwd, selected_files)

where parameters are:

main_wnd_xid | XID of &app; main toplevel window
active_cwd | full path of current dir of active pane
inactive_cwd | full path of current dir of inactive pane
selected_files | list of selected file uris in active pane

### Sample plugin: md5sum

        #!/usr/bin/env python

        try:
            import gnomevfs
        except ImportError:
            import gnome.vfs as gnomevfs

        import md5

        def main(main_wnd_xid, active_cwd, inactive_cwd, selected_files):

            for uri in selected_files:
                fname = gnomevfs.get_file_info(uri).name
                f = file.open(fname,'rb')
                file_content = f.read()
                f.close()
                md5sum = md5.new(file_content).hexdigest()
                print md5sum, fname

            return True

The latest version of md5sum code can be found in SVN &app; repository.

### Python resources

- Python documentation

- Python gnomevfs reference manual

- PyGTK: GTK+ for Python

- Creating a GUI using PyGTK and Glade

- Python code snippets

## Tips and tricks

Some very simple tips and tricks on using and getting the most out of &app;.

Handling archives

  &app; still lacks built in browsing of compressed archives. However the program can be configured so that working with archives becomes quite practical anyway. This is how you do it:

  - If you don't already have the program Fileroller, download it and install it.

  - Open the Options dialog and go to the Programs tab.

  - Add two favourite apps using the values shown here and here.

  You can now right click any file or folder and choose Create archive... to compress it and right click compressed files and choose Extract archive... to extract it.

Using removable media

  If you use removable devices such as CDs, floppies and cameras a lot you can make &app; automatically take care of mounting them by following this guide:

  - Open the Options dialog and go to the Devices tab.

  - Add the devices that you are using. This is how the program looks with a few added devices. In the last image the red circle shows the available devices, there is also a button, in the green circle, to press if we want to unmount the floppy, which happened to be mounted. The icons that are used for the devices in the example should be available in the $(prefix)/share/pixmaps/gnome-commander/device-icons folder on your computer.

  - There is also an option to skip mounting in the option device tab, this can be useful for making shortcuts to directories, or if you have some automounting feature that mounts it at its mountpoint when available, or if you use Supermount that does it on access basis.

Opening a full terminal

  Sometimes you want a quick way of opening a full terminal window with the current directory as the terminals working directory. Well, that is easy, just type sh, or maybe bash if you prefer, in the &app; command line and press SHIFTENTER - there you have it.

Using Nautilus icon theme

  This is outdated info since Nautilus and later Gnome versions no longer use these kind of themes.

  The default icon theme that comes with &app; lacks icons for a lot of file types and only looks good at icon size 16. There are other themes around though, that are more complete and looks better in bigger sizes. Unscalable Gorilla by Jimmac is one example and can be used in &app; by following these steps:

  - Download the theme.

  - Unpack the theme to where ever you want.

  - Start &app; open the Options dialog. In the Layout tab set the Theme icon directory to be the folder where you extracted Unscalable Gorilla. Also change Row height and Icon size to 20 or some other size that you like. When you're done also make sure that the Graphical mode is set to MIME icons.

  - When you now close the Options dialog the file listings should refresh and you should see Unscalable Gorilla being used.

## &app; installation

### Getting &app;

The very latest information about can be found on &app; website.

It's recommended to use the &app; package that is provided by your distribution. Refer to &app; for the list of distributions supporting &app; packages.

All current and historical releases can be found on the Gnome FTP server.

### Versioning

&app; is being developed in a stable and a testing branch, where the test releases fill the purpose of testing new ideas. Successful ones will then get backported to the stable branch. The version numbers (major, minor and micro) follows the quite usual standard of odd and even versioning, where odd minor versions stands for the unstable releases and the even numbered branch eventually gets the thoroughly tested new functions backported.

### Stable version

`svn checkout svn://svn.gnome.org/svn/gnome-commander/trunk`

### Development version

`svn checkout svn://svn.gnome.org/svn/gnome-commander/branches/gcmd-1-3`

### SVN builds

For those of you who feel really adventurous, or maybe want to hack on the freshest code, the latest development sourcecode can be downloaded directly from &app; SVN repository.

`svn checkout svn://svn.gnome.org/svn/gnome-commander/trunk`

(just remember to run `autogen.sh` before compiling).

Be aware that there can be serious bugs in code from SVN repository. This code is intended for hacking, development and testing purposes only.

### Compilation and installation

## Configuration files

This section gives an overview of the configuration files used by &app;:

~/.gnome-commander/connections

~/.gnome-commander/devices

~/.gnome-commander/fav-apps

~/.gnome2/gnome-commander

  Section | Key | Type | Value | Refer to
  --- | --- | --- | --- | ---
  [ftp] | anonymous_password |  |  |
  [options] | backup_filter |  |  |
  | btn_relief |  |  |
  | cmdline_history_length |  |  |
  | cmdline_visibility |  |  |
  | conbuttons_visibility |  |  |
  | counter_increment |  |  |
  | counter_precision |  |  |
  | counter_start |  |  |
  | date_disp_mode |  |  |
  | dir_cache_size |  |  |
  | document_icon_dir |  |  |
  | ext_disp_mode |  |  |
  | filter_type |  |  |
  | hidden_filter |  |  |
  | icon_scale_quality |  |  |
  | icon_size |  |  |
  | layout |  |  |
  | list_font |  |  |
  | list_orientation |  |  |
  | list_row_height |  |  |
  | main_win_pos_x |  |  |
  | main_win_pos_y |  |  |
  | perm_disp_mode |  |  |
  | rename-history-size |  |  |
  | right_mouse_button_mode |  |  |
  | show_block_device |  |  |
  | show_char_device |  |  |
  | show_directory |  |  |
  | show_fifo |  |  |
  | show_regular |  |  |
  | show_socket |  |  |
  | show_symbolic_link |  |  |
  | show_toolbar |  |  |
  | show_unknown |  |  |
  | size_disp_mode |  |  |
  | sort_column_left |  |  |
  | sort_column_right |  |  |
  | sort_direction_left |  |  |
  | sort_direction_right |  |  |
  | start_dir_left |  |  |
  | start_dir_right |  |  |
  | symlink_prefix | string | Empty value means 'use "link to %s" for symlink' (or translation if available), other values = use given string for symlink name. "%s" is crucial here - it is expanded to original filename. |
  | template-auto-update |  |  |
  | template-history-size |  |  |
  | theme_icon_dir |  |  |
  [sort] | case_sensitive |  |  |
  [confirm] | delete |  |  |
  [colors] | curs_bg |  |  |
  | curs_fg |  |  |
  | mode |  |  |
  | norm_bg |  |  |
  | norm_fg |  |  |
  | sel_bg |  |  |
  | sel_fg |  |  |
  | use_ls_colors |  |  |
  [programs] | buttonbar_visibility |  |  |
  | differ |  |  |
  | editor |  |  |
  | honor_expect_uris |  |  |
  | skip_mounting |  |  |
  | term |  |  |
  | toolbar_visibility |  |  |
  | use_internal_viewer |  |  |
  | viewer |  |  |
  [devices] | only_icon |  |  |
  [quick-connect] | host |  |  |
  | port |  |  |
  | user |  |  |
  [defaults] | backup_pattern |  |  |
  | last_pattern |  |  |
  [search-history] | case_sens |  |  |
  | height |  |  |
  | name_patternn |  |  |
  | recursive |  |  |
  | width |  |  |
  [advrename] | height |  |  |
  | pat_col_widthsn |  |  |
  | res_col_widthsn |  |  |
  | sep_value |  |  |
  | width |  |  |
  [local_bookmarks] | count |  |  |
  | namen |  |  |
  | pathn |  |  |
  [smb_bookmarks] | count |  |  |
  [plugins] | auto_loadn |  |  |
  | count |  |  |
  [template-history] | templaten |  |  |
  [rename-history-from] | fromn |  |  |
  [rename-history-to] | ton |  |  |
  [rename-history-csens] | csensn |  |  |
  [cmdline-history] | linen |  |  |
  [key-bindings] | [<shift>][<control>][<alt>][<win>]key_name | string | `action[|options]` |

~/.gnome2/gnome-commander-size

## Release overview

Version | Release date | What's new
--- | --- | ---

1.2.4

2007-06-09

Bug fixes:

- Fixed problem with opening dirs by intviewer

- Fixed problem with editing dirs by &app;

- Fixed problem #351952 (crash while doing a content search)

- Fixed problem #352253 (scrolling behaviour of the viewer)

- Fixed problem #360175 (crash while entering a dir with %)

- Fixed problem #371948 and #388970 (file path not escaped)

- Fixed problem #412162 (build with --enable-python=no)

- Build fixes

New features:

- Support for python plugins

- New python plugins:

  - `md5sum` Create MD5 (128-bit) checksum

  - `sha1sum` Create SHA-1 (160-bit) checksum

- Support for OLE and ODF metags in advanced file rename templates

- User defined shortcuts

- SMB authentication

- Displaying total size of files in selected subirs

- 'cd -' for changing to the previous working directory

- More intuitive usage of diff tool

- Directory synchronizing

- Creating directories 'mkdir -p' like

- Updated help docs

- New or updated translations: ar, bg, cs, dz, en_GB, fr, it, oc, pl, sl, sv

- New key bindings:

  - CTRL\ Go to the root directory

  - CTRL` Go to the home directory

  - CTRL5 Create MD5 (128-bit) checksum

  - CTRLSHIFTC Copy selected file names to clipboard

1.2.3

2006-12-11

Bug fixes:

- Fixed problem #384752 (wrong permissions for new dirs)

1.2.2

2006-12-11

Bug fixes:

- Fixed problem with symlink creation for multiple file selection

- Fixed problem with grouping of file size digits

- Fixed problem with SMB UNC handling

- Fixed problem #367744 (filename not correctly displayed)

- Fixed problem #374282 (searching with recursive symlinks)

- Fixed problem #377706 (selecting files with SHIFT+PGDN)

New features:

- Support for ID3 metags in advanced file rename templates

- Updated help docs

- New or updated translations: ar, en_GB, es, fi, it, pl, sv

- New key bindings:

  - CTRLSHIFT= Set both panels equal

1.2.1

2006-10-16

Bug fixes:

- Fixed problem with scrollkeeper database update

- Fix for crash when cmd dir indicator is empty

- Fixed problem with refreshing after chown or chmod

- Fixed problem #333898 (deprecated icon suffix in desktop file)

- Fixed problem #347561 (plugin directory set incorrectly)

- Fixed problem #347817 (incorrect use of Makefile linker flags)

New features:

- Support for archives (gz, bz2, zip, lha, rar, jar, 7-zip, zoo, deb, rpm) via FileRoller plugin

- New python-like indices for advanced file rename templates

- Support for Exif and IPTC metags in advanced file rename templates

- Fast access to advrename template placeholders

- In-place rename (SHIFT+F6)

- Revamped application menus

- "Find" feature for internal viewer

- New icon for internal viewer

- Updated help docs

- New or updated translations: ca, cs, de, el, en_GB, es, eu, fi, hu, it, ne, pl, ru, sv, vi

- New key bindings:

  - CTRLSHIFTH Toggle hidden files on/off

1.2.0

2006-05-12

Bug fixes:

- Fixed problem #171051 (crashes on search with non-existent path)

- Fixed problem with the lack of gnome menu entry

- Fixed a crash when viewing SMB connections

- Fixed problem #309877 (strange artifacts with horizontal scrolling)

- Fixed problem #332258 (left/right start directory parameter)

- Fixed problem #332261 (exec_prefix not properly parsed during configure/makefiles)

- Fixed problem #336649 (permission numbers presentation)

- Fixed problem with crashes when using broken or non-matching regex pattern in advrename

New features:

- Monitoring of mounted volumes

- Rewritten internal viewer

- External tools and Exif/IPTC tags viewer for internal viewer

- Zooming for internal viewer

- Text selection for internal viewer

- Revamped toolbar layout

- Options for controlling copy and move overwriting

- Copying selected full file paths with SHIFT+click on toolbar button

- Better handling the change of the column sorting key

- Initial doc framework

- New or updated translations: de, es, eu, hu, pl, ro, ru, sl, sv, vi

- New key bindings:

  - SHIFTF3 Internal viewer

  - ALTF3 External viewer

  - ALT+letters Quick search

  - CTRLSHIFTA Deselecting all files

1.1.7

2006-02-12

Bug fixes:

- Fixed crash when trying to copy the currently selected files

- Fixed filename escaping

- Fixed CTRL+ALT+letter bad responsiveness when typing too fast

- Fixed debian bug #288933 (amd64/gcc-4.0 compiling errors)

- Fixed problem #138933 (infinite recursion when drag'n'dropping a directory to itself)

- Fixed problem with the disconnect button not behaving correctly when connecting to ftp-servers and being in supermount mode

- Fixed update after renaming without FAM

New features:

- New &app; logo

- Added internal F3 viewer

- Copying selected filename(s) to clipboard

- Inserting selected file full path to the cmdline when pressing CTRL+SHIFT+ENTER

- Multi-Rename-Tool - new $g placeholder for grandparent dir

- Toolbar buttons (cut, copy and paste) are now sensitive to the current state

- Manage Bookmarks dialog is now accessible also via the bookmarks shortcut

- New or updated translations: el, en_CA, en_GB, eu, ga, hu, nb, ne, no, pa, pt_BR, rw, uk, zh_TW

- New key bindings:

  - CTRLM Multi-Rename-Tool

  - CTRLSHIFT. Copying the current working directory from the active file list to the inactive one

  - CTRL= Select all files

  - CTRL- Unselect all files

  - = Select files using a pattern

1.1.6

2004-01-20

Bug fixes:

- Fixed crash when navigating back in the history and then entering another dir

- Fixed ftp-quick-connect problems

- The quick-search function can now also be started by typing capital letters

- CTRL+ALT no longer needs to be used to activate quick-search when the cmdline is hidden

New features:

- Updated the cvs-plugin so that it can be used to diff and log files

- Use bold text instead of underlined in the dir-indicator when focused by the mouse cursor

- The cwd label is selectable now (the one left of the cmdline)

- Removed the 'Save Position' menu item. Size and position are now saved automatically instead

- Added button to the directory indicator to popup the directory history

- Added history to the select and unselect by pattern dialogs

- Sorting column and direction is now remembered

- New key bindings:

  - F2 Open the rename dialog

  - SHIFT+F10 Bring up the file context menu (the windows menu key also works)

  - CTRL. Copy the current working directory from the inactive file list to the active one

1.1.5

2004-01-12

Bug fixes:

- The ext column is now hidden when the extension is only showed together with the filename

- Fixed unnecessary redraws of the file list when dragging files over it

- Fixed problem with ftp-connections that didn't disappear from the connection toolbars when disconnected

- The program no longer tries to center itself on the desktop

- Fixed problems when renaming directories

New features:

- The dir indicator above each file list can now be used to navigate upwards in the directory structure

1.1.4

2003-11-24

Bug fixes:

- Fixed bug when selecting multiple files with shift+mouse button

- Stopped superfluous updates of the file list on machines with the imon kernel patch applied

- Cleaned up the file-popup menu

- Fixed "File not found"-bug when browsing to the parent dir when the parent dir contained spaces

- Fixed possible async error when cancelling a xfer operation

- Reworked the layout tab and removed the colors tab in the options dialog

- Improved plugin-system

1.1.3

2003-11-14

Bug fixes:

- Fixed a crash that happened when moving files on a machine with a snappy FAM installation. This lead to that &app; tried to remove the same file twice from a list

- Accessing files on mounted devices should now work better

- Devices without the device filename should not disappear anymore

- Fixed so that the feature where the terminal window stays open after a program has finished works more reliably

- Fixes bug where a new directory would appear many times in the same file list until reloaded

New features:

- The delete confirmation can now be disabled

- Better error messages when a mount fails

- Made the calculation of a directory's total size start automatically when the file prefs dialog is shown

- Added filter for backup files and added that and the filter for hidden files to the main menu for faster access

1.1.2

2003-11-07

Bug fixes:

- Much better handling of non UTF8 filenames

- Removed unsafe uri-creation

New features:

- Three ways to show with file extensions

1.1.1

2003-11-05

Bug fixes:

- Stopped showing the file extension in both the name column and the ext column

- Fixed crashes that happened when browsing directories

- Fixed update problems when copying and moving files

- The connection combo boxes should now show the correct connection as selected all the time

- Removed some bugs related to selecting files using the keyboard

- Fixed the edit mime-types feature

New features:

- Added a button to change the default MIME-app in the file properties dialog

1.1.0

2003-11-01

New features:

- SMB browsing

- Plugins

- Major rewrite of a lot of code

1.0.1

2003-06-27

Bug fixes:

- Improved file list update in non-fam mode

- Empty directories can now be entered on ftp servers

1.0 | 2003-06-05 | This is the "production stable" 1.0 release. Mainly small bugfixes from previous version.
0.9.12 | 2003-03-18 | Bugfixes
0.9.11 | 2003-03-13 | Added support for $p in advrename dialog. This will give you the parent directory. Fixed a bug where deleting a directory sometimes only emptied the directory but not delete it. Fixed so that the ".." directory is visible in ftp-sessions.
0.9.10 | 2003-03-24 | Fixed an imageloading bug when using themes other than the default one. New bookmark feature. New template feature in the advanced-rename dialog. See doc/advrename.txt in the tarball for details. Nicer file-properties dialog with rename support. Dragging files to the ".." directory is now possible. The toolbar and buttonbar can now be hidden.
0.9.9 | 2003-01-19 | Improved the advanced rename tool Added quick connect feature. Improved search dialog and fixed some bugs in it. Added default low-res mime icon theme. Made the file popup menu behave more normal.
0.9.8 | 2002-07-16 | New things in this release are autoscroll at DND, better quicksearch, mounting and unmounting, file lists refresh without FAM, last visited directory history and more.
0.9.7 | 2002-06-07 |
0.9.6 | 2002-04-04 | MIME support has been added and bugs have been fixed.
0.9.5 | 2002-03-27 | Added an embedded terminal and fixed some bugs.
0.9.4 | 2002-03-21 | Added FAM support, DnD and more.
0.9.2 | 2002-03-09 | Improved stability and less memory leaks. CVS is disabled until it actually works well.
0.91-pre1 | 2002-02-06 | Improved user interface and lots of other small hacks.
0.90-pre1 | 2001-08-02 | The first public version of &app;.

## Known Bugs and Limitations

You can report or view &app; bugs at the the gnome.org Bugzilla.

Though &app; is relatively free from bugs and is a quite mature program, no programs will ever be totally bugfree. New bugs can be introduced with new features, or through other programs and libraries it depends on, this goes especially for development and testing versions. Quality bugreporting is very important and can be a very good help for the developers to make a better program. Bug reporting is not an act of dissatisfaction, so you are very welcome to help us find, hunt down and kill the bugs. Testing of the new releases and bug reporting is the best way users without programming knowledge can help out in the development of a program, and those with programming knowledge are very welcome to suggest fixes and/or send patches to the developers, all in the spirit of free and open source software.

Given enough eyeballs, all bugs are shallow.

Linus law.

## About &app;

&app; was primarily written by the former maintainer - Marcus Bjurman, who where the one that initiated this project publicly in 2001 and developed it up to version 1.1.6 in January 2004. Currently &app; is being developed by Piotr Eljasiak (epiotr@use.pl) and Assaf Gordon (agordon88@gmail.com) with additional help of Magnus Stålnacke (jemamo@telia.com) and Micha (codejodler@gmx.ch).

To find more information about &app;, please visit the &app; homepage.

To report a bug or make a suggestion regarding this application or this manual, follow the directions in this document.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.