swayimgrc − Swayimg configuration file
|
$XDG_CONFIG_HOME/swayimg/config |
||
|
$HOME/.config/swayimg/config |
||
|
$XDG_CONFIG_DIRS/swayimg/config |
||
|
/etc/xdg/swayimg/config |
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.
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.
antialiasing:
enable/disable anti-aliasing, yes or [no];
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;
exec: set a command to be executed when the
corresponding key is pressed, use % for image path, default
is ’echo %’;
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.
The key bindings are described in the "keys" section. Each line associates a key with some action. The key name can be obtained with the xkbcli tool: ‘xkbcli interactive-wayland‘.
Valid action are: none, first_file, last_file, prev_dir, next_dir, prev_file, next_file, prev_frame, next_frame, animation, slideshow, fullscreen, step_left, step_right, step_up, step_down, zoom_in, zoom_out, zoom_optimal, zoom_fit, zoom_real, zoom_reset, rotate_left, rotate_right, flip_vertical, flip_horizontal, antialiasing, reload, info, exec, quit.
# comment
scale = fit
fullscreen = no
background = none
window = #112233
info = yes
font = monospace 14
font-color = #b4b3b2
sway = no
[keys]
q = quit
swayimg(1)
For suggestions, comments, bug reports etc. visit the project homepage.