Window Options

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

11.3.1. State

Remember window positions

This will maintain windows size and position between Geeqie sessions.

Use saved window positions also for new windows

A new window opened by menu File ▸ New Window ( Ctrl+N ) will use the saved window positions also.

Remember tool state

Maintains the selection set by View ▸ File and Folders ▸ Float File List ( L )

11.3.2. Size

Fit window to image when tools are hidden/floating

The main window will be resized to accommodate each image's size and proportions when the image pane is the only one visible within the window.

Limit size when auto-sizing window

This will restrict the maximum size a window can grow to automatically fit an image. The value represents the percentage of the desktop size in width and height.

11.3.3. Full Screen


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.

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.

11.3.4. Overlay Screen Display

The contents of the Overlay Screen Display is defined by the Image Overlay Template. This template is easily customised to display a wide range of data.

The format of each entry is:


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 XMP metadata
imagecomment JPEG image comment
<meta_tag> The Exif, XMP, or IPTC tag from metadata
lua/<lua_script>/ The output of a Lua script file
lua//<lua_command> The output of a Lua command

As an aide, in addition to standard metadata tags, Geeqie provides a number of pre-formatted tags .

Examples of usage are:


Refer to Lua Extensions for further information.

The length of displayed data can be limited by using the :max_length parameter. The following example 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 | character, the variables are displayed with a separator. For example::

could show:
"1/20s - 400 - 80 mm"
Or, if there is no ISO information in the Exif data:
"1/200 - 80 mm"

If there is no data for a requested tag, the line is not displayed.

The :extra parameter may be used to format the output by prepending and appending a text string to the displayed item.

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


Template Example display
%name: <i>*</i>\n% filename001.jpg
%size:\n% 123456
%formatted.ISOSpeedRating:ISO *% ISO 100
%collection:Collection: <b>*</b> \n% Collection: my_new_collection

Font , Text , Background
The font used for the Overlay Screen Display, as well as the font colour and background colour, may be set via these buttons. Colour transparency can also be set.

Show syntax help


Restore default image overlay template