An image viewer with vim-like keybindings.
Clone or download
Latest commit c16dbc9 Mar 18, 2018
Permalink
Failed to load latest commit information.
c-lib
config
icons
man Fix links to website Nov 17, 2017
scripts
tests
vimiv Catch UnicodeEncodeError in is_image check Mar 18, 2018
.coveragerc
.gitignore
.landscape.yaml
.noserc
.pycodestyle
.pydocstylerc
.pylintrc
.spelling_dict.txt
LICENSE
Makefile
contributing.md
readme.md
setup.py
vimiv.appdata.xml
vimiv.desktop
vimiv.py Start vimiv via ./vimiv.py Mar 30, 2017

readme.md

vimiv banner

License badge Coverage Code Health Version badge

Version 0.9.2 (unreleased)

Releases | Website | Documentation | Changelog

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

  • Thumbnail mode
  • Simple library browser
  • Basic image editing
  • Command line with tab completion

For much more information please check out the documentation. If you are new to vimiv, this is a good place to get started. For a quick overview check out the keybinding cheatsheet.

Screenshots

Open image and library

Library

Thumbnail mode

Thumbnail

Installation

Install the dependencies listed below first. To use the development version clone this repository, for the latest stable check out the releases page. To install a simple # make install should suffice. To remove vimiv the standard # make uninstall works. You may need to update your icon cache after installation.

For Arch Linux users the latest release is available from [community] and there is the AUR package vimiv-git for the development branch.

Fedora Linux users can install stable releases from the official repositories using the provided package managers.

Dependencies

  • python3
  • python-gobject
  • gtk3
  • python-setuptools (for installation)
  • python-dev (on debian-based systems for installation)
  • libgexiv2 (optional for EXIF support; needed for saving without deleting EXIF tags and for the autorotate command)

Thanks to

  • James Campos, author of Pim which was the starting point for vimiv
  • Bert Muennich, author of sxiv which inspired many of the features of vimiv.
  • Anyone who has contributed or reported bugs