Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
IMV(5)									IMV(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>
	   Set the background in imv. Can either be a 6-digit hexadecimal
	   colour code,	or checks for a	chequered background. Defaults to

       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.

       initial_pan = <pan_factor_x> <pan_factor_y>
	   Initial pan/focus position factor of	the opened images. A value of
	   50 represents the middle point of the image (50%). Defaults to 50

       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

       recursively = <true|false>
	   Load	input paths recursively. Defaults to false.

       scaling_mode = <none|shrink|full|crop>
	   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.  crop will scale and crop	the image to fill 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.

       suppress_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

       upscaling_method	= <linear|nearest_neighbour>
	   Use the specified method to upscale images. Defaults	to linear.

       The [aliases] section allows aliases to be added	for imv's build	in
       commands. For example, x	= close	would add a x command that simply
       executes	the close command. Any arguments provided to an	alias are
       appended	to the command configured by the alias.

       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. Multiple commands for a
       single key combination can be defined by	separating each	command	with a
       ;. Single and double quotes are honoured, as is escaping	with a
       backslash, to allow the proper quoting of shell commands.

       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 = goto 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.

       Many keys, such as _, and _ have	special	names. On X11, these can be
       easily found with the xev(1) command. For example, ! is called exclam,
       _ is called less, _ is called greater.

       A complete list of keysyms can also be found on most systems with the
       dumpkeys	-l command.


				  08/31/2020				IMV(5)


Want to link to this manual page? Use this URL:

home | help