Previous | Advanced – Options Explained | Next
--- | --- | ---

# Advanced Options

This section describes the options presented under the Advanced Tab of the preferences dialog.

## Full Screen

Location

  Selects the location and position of the full screen window. 'Determined by window manager' will leave the window placement up to the window manager. 'Active screen' places the window on the same screen as the Geeqie main window. 'Active monitor' does the same, but limits the full screen window size to the monitor containing the main window. The remaining choices are dependent on the multiple monitor configuration.

Stay above other windows

  Enable this to have Geeqie ask the window manager to keep the full screen window above other windows. Note that the window manager may ignore the request. This option is not relevant when the full screen location is determined by the window manager.

Smooth image flip

  This option delays the image change in full screen until the next image is entirely decoded into memory, the result is a smoother transition between images.

Disable screen saver

  This option will execute xscreensaver-command --deactivate once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.

## Overlay Screen Display

Always show image overlay at startup

  Enable this to have the image overlay info displayed by default

Image overlay template

  Overlay info is customizable through this template

  Overlay info format string syntax is: `%tag[:max_length][:extra]%`

  Tag | Replaced by
  --- | ---
  name | Filename of the picture
  collection | Name of the collection
  number | Current number of image in the list
  total | Total number of images
  date | File date
  size | File size
  width | Image width
  height | Image height
  res | Image resolution
  keywords | Image keywords from metadata
  comment | Image comment from metadata

  To access exif data use the exif name, for example: `%Exif.Photo.DateTimeOriginal%` to get the date of the original shot

  Pre-formatted exif data is also available:

  Tag | Replaced by exif data
  --- | ---
  formatted.Camera | Camera and sofware name
  formatted.DateTime | Image Date
  formatted.ShutterSpeed | Shutter speed in seconds (ie. 1/60s)
  formatted.Aperture | Aperture (ie. f5.6)
  formatted.ExposureBias | Exposure bias (ie. +0.3)
  formatted.ISOSpeedRating | ISO sensitivity (ie. 100)
  formatted.FocalLength | Focal length
  formatted.FocalLength35mmFilm | Focal length 35mm
  formatted.SubjectDistance | Subject distance
  formatted.Flash | Flash
  formatted.Resolution | Resolution
  formatted.ColorProfile | Color profile

  You can limit the length of displayed data using :number notation: `%formatted.Camera:20%` will truncate the displayed data to 20 characters and will add 3 dots at the end to denote the truncation.

  If two or more variables are connected with the |-sign, it prints available variables with a separator:
  `%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%`
  could show:
  "1/20s - 400 - 80 mm"
  or
  "1/200 - 80 mm" if there's no ISO information in the Exif data.

  If a line is empty, it is removed. This allows to add lines that totally disappear when no data is available.

  Extra string uses special character '*' to mark the position of the data. If no '*' is present, then extra string is just appended to data. Any "\n" is replaced by a newline on display. Pango mark up is accepted in left and right parts. If data is empty, nothing will be displayed.

  Examples:

  `%name:<i>*</i>\n%`
    name is displayed in italics ended with a newline
  `%size:\n%`
    size is displayed with a newline at end
  `%formatted.ISOSpeedRating:ISO *%`
    ie. "ISO 100"
  `Collection <b>*</b>\n`
    display collection name in bold prefixed by "Collection " and a newline is appended
Help button

  Show syntax help

Defaults button

  Restore default image overlay template

## Delete

Confirm file delete

  Prompts for confirmation before deleting files.

Enable Delete key

  Disable this to disassociate the delete file function from the Delete key. This option does not effect the Ctrl + D key sequence. May be useful in combination with “confirm file delete”, above, disabled so that accidentally hitting a single key will not result in deleted files.

Safe Delete

  Moves deleted files to a temporary folder, for easy retrieval of deleted files. Files in the temporary folder are retained until the maximum size is reached, at which point deleting additional files will result in the removal of the oldest files to reclaim the space needed for the new files.

  Note: Files moved to the Safe Delete folder are prefixed with a six digit number in the format: `nnnnnn_FILENAME`
  This is used by the delete feature to distinguish which files to remove first when clearing space for new files.
  The digit counter increments with each deleted file.

Folder

  The location of the folder used by the Safe Delete feature.

Maximum size

  The size to use for the Safe Delete folder, in megabytes. Note that setting this value to 0 (zero) will disable any limit.

Clear button

  Removes all files contained in the Safe Delete folder.

View button

  Changes the Geeqie main window to display the contents of the Safe Delete folder.

## Behavior

Rectangular selection in icon view

  Enable this to change the selection method used when selecting multiple items in an icon view.

Descend folders in tree view

  This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.

  Note: Disable this if Geeqie wakes up auto mounted network shares, or takes too long to initially display the folder view.

Show date in directories list view

  Enable this to display directory modification date along its name in the list view

In place renaming

  When renaming a single file, this will allow the rename entry to appear directly over the original filename.

Show "Copy path" menu item

  Enable this option to show a "Copy path" menu item in applicable menus.

  This allows to copy path to files or directories to the clipboard, names are enclosed with double quotes and separated by space.

Open recent list maximum size

  This is the number of entries saved in the recent open file list.

Drag'n drop icon size

  This is the width and height of the icon generated from image and displayed when doing drap'n drop actions. High resolution screens may require to increase this number.

## Navigation

Progressive keyboard scrolling

  This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.

Mouse wheel scrolls image

  The default is for the mouse wheel to change the image, and to scroll the image when Shift is used in combination with the wheel. Enabling this swaps the behavior so that operating the wheel will scroll the image, and holding down Shift will change the image.

Home button path

  This defines the path to use for the "Home" button in the main window. By default or when this field is empty, this is the user's directory.

Use current

  Pressing this button will set the Home button path to the current open directory.

## Miscellaneous

Store metadata and cache files in source image's directory

  When enabled, Geeqie attempts to store metadata such as keywords closer to the source image. The resulting location is the source image's folder, in a sub folder with the name ".metadata". When the image source folder cannot be written, Geeqie falls back to saving the medata in "$HOME/.geeqie/metadata".

Store keywords and comments as XMP tags in images files

  When enabled, Geeqie attempts to store keywords and comments as XMP tags in the image file itself. Obviously, this will modify the concerned files.

Custom similarity threshold

  This setting is used by the compare method “similarity (custom)”, located in the Find Duplicates window.

## Image loading and caching

Offscreen cache size

  Geeqie only renders the visible portion of an image. To reduce rendering the same area frequently when panning an image, some memory is used to retain the recently rendered image data. This value controls the maximum amount of memory to use.

  Note: This setting controls the amount of memory for each image window.

Decoded image cache size

  This is the cache size in megabytes used by Geeqie to store decoded images.

Image read buffer size

  Number of bytes read by Geeqie in one pass, this is for fine tuning, do not modify if you don't know what it does.

Image idle loop read count

  This is for fine tuning, do not modify if you don't know what it does.

## Color profiles

Here one can defined color profiles to use.

Type

  Either input color profile or screen color profile.

Menu name

  Name of the menu entry corresponding to the color profile.

File

  Path to the color profile file.

## Debugging

Debug level

  This defines the verbosity of debug info sent to console and log window (0 disables the debug output).

Previous | Contents | Next
--- | --- | ---