General format description¶

The Swayimg configuration file is a text-based INI file used to override the default settings.

The basic element contained in the INI file is the key or property. Every key has a name and a value, delimited by an equals sign (=). The name appears to the left of the equals sign, and the value to the right. The value can contain any character. Names and values are case sensitive.

The number sign (#) at the beginning of the line indicates a comment. Empty lines and comments are ignored.

Properties¶

scale: initial image scale:

optimal: 100% or less to fit to window (default);
fit: fit to window;
real: real size (100%);

fullscreen: start in full screen mode, yes or [no];

background: background for transparent images:

none: transparent;
grid: show grid as background (default);
#XXXXXX: hexadecimal RGB color.

window: window background:

none: transparent (default);
#XXXXXX: hexadecimal RGB color.

info: show image meta information: format, size, EXIF, and current scale, yes or [no];

font: font name used for printing image meta info, default is monospace;

font-size: font size (in pt) used to render image info text, default is 14;

font-color: color used to render text, RGB hex format, default is #cccccc;

order: order of the image list:

none: unsorted;
alpha: sorted alphabetically (default);
random: randomize list.

loop: looping file list mode, [yes] or no;

recursive: read directories recursively, yes or [no];

all: always open all files in the same directory, yes or [no];

slideshow: slideshow image duration in seconds, default is 3;

app_id: set a constant window class/app_id. Setting this may break the window layout;

sway: enable or disable integration with sway WM (window position management), [yes] or no.