https://github.com/errornointernet/vimiv-qt
Updated fork of karlch's vimiv-qt
https://github.com/errornointernet/vimiv-qt
Last synced: 9 days ago
JSON representation
Updated fork of karlch's vimiv-qt
- Host: GitHub
- URL: https://github.com/errornointernet/vimiv-qt
- Owner: ErrorNoInternet
- License: gpl-3.0
- Created: 2026-04-07T00:06:06.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-10T16:35:17.000Z (24 days ago)
- Last Synced: 2026-05-10T18:28:29.460Z (24 days ago)
- Language: Python
- Size: 12.9 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.rst
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Authors: AUTHORS
Awesome Lists containing this project
README
[](https://github.com/ErrorNoInternet/vimiv-qt/actions)
[](https://codecov.io/github/ErrorNoInternet/vimiv-qt)
[](https://github.com/ambv/black)
[original website](https://karlch.github.io/vimiv-qt/) |
[docs](https://karlch.github.io/vimiv-qt/documentation/index.html) |
[install](https://karlch.github.io/vimiv-qt/documentation/install.html) |
[screenshots](https://karlch.github.io/vimiv-qt/screenshots.html) |
[changelog](https://karlch.github.io/vimiv-qt/changelog.html) |
[contributing](https://karlch.github.io/vimiv-qt/documentation/contributing.html)
---
> :information_source: This is an updated fork of [karlch's vimiv-qt](https://github.com/karlch/vimiv-qt) that
> includes cherry-picked PRs custom features/fixes. Use at your own discretion.
---
Vimiv is an image viewer with vim-like keybindings. It is written in python3
using the Qt toolkit and is free software, licensed under the GPL.
### Features
* Basic image operations and navigation
* [ranger](https://github.com/ranger/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](https://github.com/karlch/base16-vimiv), ...
### Install
To learn how to get vimiv running on various platforms, please check out the
[installation guide](https://karlch.github.io/vimiv-qt/documentation/install.html).
### Documentation
Much more details on vimiv are available on the
[website](https://karlch.github.io/vimiv-qt/). Here are some hints to get you started:
* [The installation guide](https://karlch.github.io/vimiv-qt/documentation/install.html)
includes instructions on how to get vimiv running on various platforms.
* [Getting started](https://karlch.github.io/vimiv-qt/documentation/getting\_started.html)
starts with the basic concepts and keybindings to later show some more advanced
features.
* [Commands](https://karlch.github.io/vimiv-qt/documentation/commands.html)
gives a complete overview and description of all commands.
* [Keybindings](https://karlch.github.io/vimiv-qt/documentation/configuration/keybindings.html)
lists the default keybindings and describes how to configure them.
* [Settings](https://karlch.github.io/vimiv-qt/documentation/configuration/settings.html)
describes the available settings and how to change them.
* [Style](https://karlch.github.io/vimiv-qt/documentation/configuration/style.html)
explains how to configure the look and colorscheme of vimiv.
* [Plugins](https://karlch.github.io/vimiv-qt/documentation/configuration/plugins.html)
illustrates vimiv's python plugin system: a great way to extend the functionality
beyond the defaults and to start delving into the source code.
### Contributing
You want to contribute to vimiv? Great! :tada:
Every little help counts and is appreciated! Feel free to read the
[contributing guidelines](https://karlch.github.io/vimiv-qt/documentation/contributing.html)
for some useful tips and tricks.
There are many ways to contribute, including:
* [giving feedback and requesting new features](https://karlch.github.io/vimiv-qt/documentation/contributing.html#feedback-and-feature-requests)
* [reporting bugs](https://karlch.github.io/vimiv-qt/documentation/contributing.html#reporting-bugs)
* [writing code](https://karlch.github.io/vimiv-qt/documentation/contributing.html#writing-code)
* [extending the documentation](https://karlch.github.io/vimiv-qt/documentation/contributing.html#writing-documentation)
* spreading the word in an article, blog, reddit post, ...
Need help? Feel free to open an
[issue on GitHub](https://github.com/ErrorNoInternet/vimiv-qt/issues/).
### License
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 .