Qt5 image viewer. Fast, configurable, easy to use. Optional video support.
-
Simple UI
-
Fast
-
Easy to use
-
Fully configurable, including shortcuts
-
Basic image editing: Crop, Rotate and Resize
-
Ability to quickly copy / move images to different folders
-
Experimental video playback via libmpv
-
Ability to run shell scripts
-
A nice dark theme, should look identical on every OS / DE
| Action | Shortcut |
|---|---|
| Next image | Right arrow / MouseWheel |
| Previous image | Left arrow / MouseWheel |
| Goto first image | Home |
| Goto last image | End |
| Zoom in | Ctrl+MouseWheel / Crtl+Up |
| Zoom out | Ctrl+MouseWheel / Crtl+Down |
| Zoom | Hold right mouse btn & move up / down |
| Fit mode: window | 1 |
| Fit mode: width | 2 |
| Fit mode: 1:1 (no scaling) | 3 |
| Switch fit modes | Space |
| Toggle fullscreen mode | DoubleClick / F / F11 |
| Exit fullscreen mode | Esc |
| Show image info | I |
| Crop image | X |
| Resize image | R |
| Rotate left | Ctrl+L |
| Rotate Right | Ctrl+R |
| Quick copy | C |
| Quick move | M |
| Move to trash | Delete |
| Delete file | Shift+Delete |
| Save | Ctrl+S |
| Save As | Ctrl+Shift+S |
| Open | Ctrl+O |
| Settings | Ctrl+P |
| Exit application | Esc / Ctrl+Q / Alt+X / MiddleClick |
... and more.
Note: you can configure every shortcut by going to Settings > Controls
The idea is to have a uncluttered, simple and easy to use UI. You can see ui elements only when you need them.
There is a pull-down panel with thumbnails, as well as folder view (accessible by pressing Return).
You can also bring up a context menu by right-clicking an image.
Bring up the panel with C or M shortcut. You will see 9 destination directories, click them to set them up.
With panel visible, use 1 - 9 keys to copy/move current image to corresponding directory.
When you are done press C or M again to hide the panel.
Starting with v0.7 you can run scripts on a current image.
Open Settings > Scripts. Press Add. Here you can choose between a shell command and a shell script.
Example of a command:
convert %file% %file%_.pdf
Example of a shell script file:
#!/bin/bash
gimp "$1"
Note: The $1 argument will be a full file path. Also, the script file must be an executable.
When you've created your script go to Settings > Controls > Add, then select it and assign a shortcut like for any regular action.
If qimgv appears too small / too big on your display, you can override the scale factor. Example:
QT_SCALE_FACTOR="1.5" qimgv /path/to/image.png
You can put it in qimgv.desktop file to make it permanent. Using values less than 1.0 may break some things.
qimgv should also obey the global scale factor set in kde's systemsettings.
APNG is supported via third-party qt plugin. (Included in windows qimgv package)
If you are linux user, install the latest QtApng by Skycoder42.
Viewing raw is supported via qtraw plugin. It is not included in windows release at the time.
Arch Linux / Manjaro / etc.:
AUR package:
qimgv-git
Ubuntu / Linux Mint / Pop!_OS / etc.
sudo add-apt-repository ppa:easymodo/qimgv
sudo apt install qimgv
Gentoo:
emerge qimgv
OpenSUSE:
zypper install qimgv
Void linux:
xbps-install -S qimgv
If your favorite distro is not included refer to [Manual install] section at the end of this document.
Windows builds are portable (everything is contained within install folder).
Installer additionally sets up file associations.
__Install dependencies ( git, cmake, qt >= 5.9, exiv2, mpv )
Ubuntu & derivatives:
sudo apt install build-essential git cmake qt5-default libmpv-dev
Optional: libkf5windowsystem-dev
Fedora:
Enable RPMFusion https://rpmfusion.org/Configuration.
sudo dnf install git cmake make qt5 qt5-devel gcc-c++ qt5-devel mpv mpv-libs-devel
Optional: kf5-kwindowsystem
// fedora exiv2 package?
__Configure & install
Get sources
git clone https://github.com/easymodo/qimgv.git
cd qimgv && mkdir -p build && cd build
Configure
cmake ../ -DCMAKE_INSTALL_PREFIX=/usr/
Build
make -j`nproc --ignore=1`
Install
sudo make install
If you get errors like "/usr/lib64 exists in filesystem" during install:
add -DCMAKE_INSTALL_LIBDIR:PATH=/usr/lib to cmake command.
| Option | Default value | Description |
|---|---|---|
| VIDEO_SUPPORT | ON | Enables video playback via mpv |
| EXIV2 | ON | Support reading exif tags via exiv2 |
| KDE_SUPPORT | OFF | Use some features from kde, like background blur |
Usage example:
cmake ../ -DKDE_SUPPORT=ON -DCMAKE_INSTALL_PREFIX=/usr/