IMVR(5) | IMVR(5) |
imv - imv configuration file
imv can be customised with this configuration file, changing its default behaviour, key bindings, and appearance.
The imv configuration file is an ini-style file, with multiple key = value settings, separated into several '[section]'s.
The [options] section accepts the following settings:
background = <hex-code|checks>
fullscreen = <true|false>
width = <width>
height = <height>
list_files_at_exit = <true|false>
loop_input = <true|false>
overlay = <true|false>
overlay_font = <typeface:size>
overlay_text = <text>
recursively = <true|false>
scaling_mode = <none|shrink|full>
slideshow_duration = <duration>
stay_fullscreen_on_focus_loss = <true|false>
suppess_default_binds = <true|false>
title_text = <text>
upscaling_method = <linear|nearest_neighbour>
The [aliases] section allows imv’s commands to be aliases. For example: q = quit would add a q command that simply executes the quit command. And next = select_rel 1 would add a next command to imv.
The [binds] section allows custom key bindings to be added to imv.
Binds are in the format key combination = command. A key combination can consist of multiple keys in succession.
Single keys such as q are just that: q = quit will bind the q key to the quit command.
Modifier keys can be specified by prefixing them: Ctrl+q, Meta+f, Shift+g. If multiple modifier keys are desired, they are specified in the order Ctrl+Meta+Shift. When a key’s name is more than a single character, or a modifier is used it must be wrapped in < and >, for example: <Ctrl+q>.
Multiple keys in succession can be specified by listing them in order: gg = select_abs 0 will bind two presses of the g key to jump to the first image, and <Ctrl+a>p = exec echo hi will bind the key sequence of Ctrl+a followed by p to executing the shell command echo hi.
N.B. Special characters such as ! are not named directly, and are accessed by their regular key, combined with the shift modifier: Shift+1.
Some keys, such as <, and > have special names, to avoid conflits with the bind syntax, or the config file format. Other keys with no character associated with them, such as the Return key or the arrow keys also have special names. These are as follows:
Application
AudioMute
AudioNext
AudioPlay
AudioPrev
AudioStop
Backspace
BrightnessDown
BrightnessUp
Cancel
Clear
Delete
Down
Eject
End
Escape
Equals
F<1-24>
Home
Keypad <00|000|0-9>
Keypad Backspace
Keypad Clear
Keypad Enter
Keypad -
Keypad +
Left
LeftSquareBracket
Mute
PageDown
PageUp
Pause
Return
Right
RightSquareBracket
Space
Up
VolumeDown
VolumeUp
05/07/2018 |