vimiv - Man Page

an image viewer with vim-like keybindings


vimiv [-bBfFhlLrRsSv] [--start-from-desktop] [--slideshow] [--slideshow-delay SLIDESHOW-DELAY] [-g, --geometry GEOMETRY] [--temp-basedir] [--config FILE] [--debug] [FILE] ...


Vimiv is an image viewer with vim-like keybindings. It is written in python3 using the Gtk3 toolkit. Some of the features are:

The complete documentation is not included in this manpage but is available at:


-b,  --bar

display the statusbar

-f,  --fullscreen

start in fullscreen

-h,  --help

display a simple help text

-l,  --library

display the library

-r,  --recursive

search the directory recursively for images

-s,  --shuffle

shuffle the filelist

-v,  --version

show version information and exit


start using the desktop_start_dir as path


start in slideshow mode

--slideshow-delay SLIDESHOW_DELAY

set the slideshow delay

-g,  --geometry GEOMETRY

set the starting geometry


use a temporary basedir

--config FILE

use FILE as local configuration file instead of $XDG_CONFIG_HOME/vimiv/vimivrc and ~/.vimiv/vimivrc.


run in debug mode

All capitals negate the setting, so e.g. -B means do not display the statusbar. For the long version prepend no-, e.g. --no-bar.


Probably. Please contact me under <karlch at protonmail dot com> or, even better, open an issue on the github homepage.

See Also


Thanks to

James Campos, author of Pim ⟨⟩ upon which vimiv is built.

Bert Muennich, author of sxiv ⟨⟩ which inspired many of the features of vimiv.

Anyone who has contributed or reported bugs.




Referenced By


May 2017 Linux