# OverlayScreen Display

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

## 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[:max_length][:extra]%

## Overlay Screen Display templates

Tag | Replaced by
name | Filename of the picture
path | Full path, including 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
rating | Image rating
<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:

            %keywords%
            %Exif.Photo.DateTimeOriginal%
            %lua/jpeg_comment.lua/:12%
            %lua//return(os.date())%

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.

    %formatted.Camera:20%

If two or more variables are connected with the `|` character, the variables are displayed with a separator. For example::

`%formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%`

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.

Examples:

## Overlay Screen Display template examples

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.

Help

- Show syntax help

Defaults

- Restore default image overlay template