Skip to main content

An image viewer with vim-like keybindings.

Project description

vimiv banner

Build Status Codecov Updates Code style: black

website | docs | install | screenshots | changelog | contributing

vimiv screencast

:information_source: This Qt port is the future of vimiv. New features will only be implemented here and there are already many improvements compared to the deprecated gtk version. The old version is only recommended if you require a more stable software. In case there is anything you miss here, please open an issue. Check the roadmap for more details.

Vimiv is an image viewer with vim-like keybindings. It is written in python3 using the Qt5 toolkit and is free software, licensed under the GPL.


  • Basic image operations and navigation
  • ranger-like library to browse your images
  • Thumbnail mode: navigable grid of image previews
  • Command mode with tab-completion
  • Search with pattern matching
  • Simple mark and tag system
  • Customization of keybindings, settings and style via configuration files, base-16 support, ...


To learn how to get vimiv running on various platforms, please check out the installation guide.


Much more details on vimiv are available on the website. Here are some hints to get you started:

  • The installation guide includes instructions on how to get vimiv running on various platforms.
  • Getting started starts with the basic concepts and keybindings to later show some more advanced features.
  • Commands gives a complete overview and description of all commands.
  • Keybindings lists the default keybindings and describes how to configure them.
  • Settings describes the available settings and how to change them.
  • Style explains how to configure the look and colorscheme of vimiv.
  • Plugins illustrates vimiv's python plugin system: a great way to extend the functionality beyond the defaults and to start delving into the source code.


You want to contribute to vimiv? Great! :tada:

Every little help counts and is appreciated! Feel free to read the contributing guidelines for some useful tips and tricks.

There are many ways to contribute, including:

Need help? Feel free to contact me directly or, even better, open an issue on github.


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vimiv-0.7.0.tar.gz (210.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page