iv is a Wayland application that can display images. Fractional scaling is properly supported (you can't run without it), along with true HDR output if you have the proper setup. iv does not use any UI toolkits (such as GTK or Qt) to interact with the Wayland compositor. Vulkan 1.4 is required.
A lot of care has been taken to make the pictures look the way they should. This may sound silly, but some image viewers are not able to do this. See https://wolf.nereid.pl/posts/image-viewer/#interlude-1 for more details.
To get HDR working in iv, you may need to install https://github.com/Zamundaaa/VK_hdr_layer and set the ENABLE_HDR_WSI=1 environment variable. If a working HDR pipeline is not available, HDR images will be tone mapped to SDR.
Most image viewers do not handle gamma correction properly. For example, here's a screenshot of a specially crafted image scaled down to 50% in iv on the left and another program on the right. The rectangles on both sides should have the same color, which they do in iv. See http://www.ericbrasseur.org/gamma.html for a detailed explanation of this problem.
A more practical example is shown below, where the legibility of scaled-down text depends strongly on the proper handling of the gamma correction. The image on the left is displayed with iv, and the image on the right is displayed with another program that does not handle gamma the right way.
Images that are zoomed in are displayed using nearest neighbor filtering. This works fine for integer zoom levels (200%, 300%, etc.), but would produce ugly results in other cases where the pixels inevitably don't have the same size, as shown in the screenshot below from another program.
This is not a problem in iv, where close-ups of images are properly filtered so that each pixel is the same size. Since this results in sub-pixel detail, the displayed image may appear blurry.
To load an image in iv you can:
- Pass it as a command-line parameter,
- Drag and drop the image on the viewer window,
- Copy and paste the image.
When you open a single image, its directory will be scanned for other images so that you can switch between them. Providing multiple images with the above actions only allows switching between them.
You can pan the image by holding down the right mouse button. Zoom is done with the mouse wheel. The left mouse button is used to draw a selection rectangle and to change or cancel it.
Keybindings:
1sets the zoom level to 100%.2sets the zoom level to 200%.3sets the zoom level to 400%.4sets the zoom level to 800%.Fmakes the image fit in the window (will only scale down).Ctrl+Fmakes the image fill the window (will also scale up).Shift+Fresizes the window to fit the image.F11enables fullscreen mode.Escapeexits the application.←and→switch between images.Ctrl+Ccopies the selected region to clipboard (or whole image if no selection).Ctrl+Xcuts the selected region to clipboard (fills with black).Ctrl+Vpastes an image from the clipboard.Ctrl+Ssaves the image to a file.Htoggles between SDR and HDR mode.
- Load vector images (SVG, PDF).
- Animation support.




