Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/easymodo/qimgv
Image viewer. Fast, easy to use. Optional video support.
https://github.com/easymodo/qimgv
c-plus-plus cross-platform image-viewer libmpv linux qt qt5 qt6 video webm webm-support windows
Last synced: 28 days ago
JSON representation
Image viewer. Fast, easy to use. Optional video support.
- Host: GitHub
- URL: https://github.com/easymodo/qimgv
- Owner: easymodo
- License: gpl-3.0
- Created: 2014-08-18T08:17:13.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-09-03T22:09:14.000Z (2 months ago)
- Last Synced: 2024-09-29T07:23:04.278Z (about 1 month ago)
- Topics: c-plus-plus, cross-platform, image-viewer, libmpv, linux, qt, qt5, qt6, video, webm, webm-support, windows
- Language: C++
- Homepage:
- Size: 5.53 MB
- Stars: 2,367
- Watchers: 44
- Forks: 167
- Open Issues: 238
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-qt - easymodo/qimgv: Qt5 image viewer with optional video support
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/easymodo/qimgv - Cross-platform image viewer (Jump To / Media)
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/easymodo/qimgv - Cross-platform image viewer (Jump To / Media)
- awesome_qt - qimgv - Simple image viewer with optional video Support (Image Viewers)
- awesome-mpv - qimgv - Cross-platform, based on C++/QT. (Other)
- awesome-starred - easymodo/qimgv - Image viewer. Fast, easy to use. Optional video support. (windows)
README
## :exclamation: Updates may be slow due to war in Ukraine :sunflower: :sunflower: :sunflower:
qimgv | Current version: 1.0.2
=====
Image viewer. Fast, easy to use. Optional video support.
## Screenshots
Main window & panel | Folder view | Settings window
:-------------------------:|:-------------------------:|:-------------------------:|
[](qimgv/distrib/screenshots/qimgv0.9_1.jpg?raw=true) | [](qimgv/distrib/screenshots/qimgv0.9_2.jpg?raw=true) | [](qimgv/distrib/screenshots/qimgv_3.jpg?raw=true)
## Key features:
- Simple UI
- Fast
- Easy to use
- Fully configurable, including themes, shortcuts
- High quality scaling
- Basic image editing: Crop, Rotate and Resize
- Ability to quickly copy / move images to different folders
- Experimental video playback via libmpv
- Folder view mode
- Ability to run shell scripts
## Default control scheme:
| 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 (alt. method) | Hold right mouse button & 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 EXIF panel | I |
| Crop image | X |
| Resize image | R |
| Rotate left | Ctrl+L |
| Rotate Right | Ctrl+R |
| Open containing directory | Ctrl+D |
| Slideshow mode | ~ |
| Shuffle mode | Ctrl+~ |
| Quick copy | C |
| Quick move | M |
| Move to trash | Delete |
| Delete file | Shift+Delete |
| Save | Ctrl+S |
| Save As | Ctrl+Shift+S |
| Folder view | Enter / Backspace |
| Open | Ctrl+O |
| Print / Export PDF | Ctrl+P |
| Settings | P |
| Exit application | Esc / Ctrl+Q / Alt+X / MiddleClick |
... and more.
Note: you can configure every shortcut by going to __Settings > Controls__
# User interface
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. You can also bring up a context menu via right click.
## Using quick copy / quick move panels
Bring up the panel with C or M shortcut. You will see 9 destination directories, click on the folder icon to change them.
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.
## Running scripts
You can run custom 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 (`$1` will be image path):
```
#!/bin/bash
gimp "$1"
```
_Note: The script file must be an executable. Also, "shebang" (`#!/bin/bash`) needs to be present._
When you've created your script go to __Settings > Controls > Add__, then select it and assign a shortcut like for any regular action.
## HiDPI (Linux / MacOS only)
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` is not supported.
qimgv should also obey the global scale factor set in KDE's systemsettings.
## High quality scaling
qimgv supports nicer scaling filters when compiled with `opencv` support (ON by default, but might vary depending on your linux distribution). Filter options are available in __Settings > Scaling__. `Bicubic` or `bilinear+sharpen` is recommended.
# Additional image formats
qimgv can open some extra formats via third-party image plugins. All of them are included with windows package.
| Format | Plugin |
| ------- | ------------- |
| JPEG-XL | [github.com/novomesk/qt-jpegxl-image-plugin](https://github.com/novomesk/qt-jpegxl-image-plugin) |
| AVIF | [github.com/novomesk/qt-avif-image-plugin](https://github.com/novomesk/qt-avif-image-plugin) |
| APNG | [github.com/Skycoder42/QtApng](https://github.com/Skycoder42/QtApng) |
| HEIF / HEIC | [github.com/jakar/qt-heif-image-plugin](https://github.com/jakar/qt-heif-image-plugin) |
| RAW | [https://gitlab.com/mardy/qtraw](https://gitlab.com/mardy/qtraw) |
# Installation
## Windows builds
[Grab the latest release here](https://github.com/easymodo/qimgv/releases)
Windows builds are portable (everything is contained within install folder). Installer additionally sets up file associations.
_NOTE: `-video` variants include mpv for video support_
## GNU+Linux
### Arch Linux / Manjaro / etc.
AUR package:
```
qimgv-git
```
### Ubuntu / Linux Mint / Pop!\_OS / etc.
```
sudo apt install qimgv
```
### Fedora
```
sudo dnf install qimgv
```
### OpenSUSE
```
zypper install qimgv
```
### Gentoo
```
emerge qimgv
```
### Void linux
```
xbps-install -S qimgv
```
### Alpine Linux
```
apk add qimgv
```
## BSD
### FreeBSD
```
pkg install qimgv
```
This list may be incomplete.
## Compiling from source
See [Compiling qimgv from source](https://github.com/easymodo/qimgv/wiki/Compiling-qimgv-from-source) on the wiki
# Donate
If you wish to give me a few bucks, please consider donating to the Ukrainian Army instead:
[https://savelife.in.ua/en/donate-en/#donate-army-card-once](https://savelife.in.ua/en/donate-en/#donate-army-card-once)
[https://u24.gov.ua/](https://u24.gov.ua/)
This directly increases the chances of me being able to work on this in future