Scroll to navigation

IMVR(5)   IMVR(5)

NAME

imv - imv configuration file

DESCRIPTION

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.

OPTIONS

The [options] section accepts the following settings:

background = <hex-code|checks>

Set the background in imv. Can either be a 6-digit hexadecimal colour code, or checks for a chequered background. Defaults to 000000

fullscreen = <true|false>

Start imv fullscreen. Defaults to false.

width = <width>

Initial width of the imv window. Defaults to 1280.

height = <height>

Initial height of the imv window. Defaults to 720.

list_files_at_exit = <true|false>

Print open files to stdout at exit, each on a separate line. Defaults to false.

loop_input = <true|false>

Return to first image after viewing the last one. Defaults to true.

overlay = <true|false>

Start with the overlay visible. Defaults to false.

overlay_font = <typeface:size>

Use the specified font in the overlay. Defaults to Monospace:24.

overlay_text = <text>

Use the given text as the overlay’s text. The provided text is shell expanded, so the output of commands can be used: $(ls) as can environment variables, including the ones accessible to imv’s exec command.

recursively = <true|false>

Load input paths recursively. Defaults to false.

scaling_mode = <none|shrink|full>

Set scaling mode to use. none will show each image at its actual size. shrink will scale down the image to fit inside the window. full will both scale up and scale down the image to fit perfectly inside the window. Defaults to full.

slideshow_duration = <duration>

Start imv in slideshow mode, and set the amount of time to show each image for in seconds. Defaults to 0, i.e. no slideshow.

stay_fullscreen_on_focus_loss = <true|false>

Stay full screen even when imv loses focus. Defaults to false.

suppess_default_binds = <true|false>

Disable imv’s built-in binds so they don’t conflict with custom ones. Defaults to false.

title_text = <text>

Use the given text as the window’s title. The provided text is shell expanded, so the output of commands can be used: $(ls) as can environment variables, including the ones accessible to imv’s exec command.

upscaling_method = <linear|nearest_neighbour>

Use the specified method to upscale images. Defaults to linear.

ALIASES

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.

BINDS

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

The Application / Compose / Context Menu / Alt Gr key.

AudioMute

The mute volume key.

AudioNext

The next track media key.

AudioPlay

The play media key.

AudioPrev

The previous track media key.

AudioStop

The stop media key.

Backspace

The backspace key.

BrightnessDown

The brightness down key.

BrightnessUp

The brightness up key.

Cancel

The cancel key.

Clear

The clear key.

Delete

The delete key.

Down

The down arrow key.

Eject

The eject key.

End

The end key.

Escape

The Esc / escape key.

Equals

The = key.

F<1-24>

The F keys.

Home

The home key.

Keypad <00|000|0-9>

The numeric keypad number keys.

Keypad Backspace

The numeric keypad backspace key.

Keypad Clear

The numeric keypad clear key.

Keypad Enter

The numeric keypad enter key.

Keypad -

The numeric keypad subtract key.

Keypad +

The numeric keypad add key.

Left

The left arrow key.

LeftSquareBracket

The [ key.

Mute

The mute key.

PageDown

The page down key.

PageUp

The page down key.

Pause

The pause key.

Return

The return / enter key.

Right

The right arrow key.

RightSquareBracket

The ] key.

Space

The space bar.

Up

The up arrow key.

VolumeDown

The volume down key.

VolumeUp

The volume up key.

SEE ALSO

imvr(1)
05/07/2018