imv

Rename multiple files using a text editor

TLDR

View multiple images

$ imv [path/to/image1.ext path/to/image2.ext ...]

View in fullscreen mode

$ imv -f [path/to/image.ext]

View images [r]ecursively from a path

$ imv -r --slideshow [path/to/path]

Open multiple images via stdin

$ find . -type f -name "[*.svg]" | imv

Make a slideshow from a directory showing each image for 10 seconds

$ imv -t 10 [path/to/directory]

View multiple images from the web

$ curl -Osw '%{filename_effective}\n' '[http://www.example.com/[1-10].jpg]' | imv

-f
    Fullscreen mode.

-g
    Set the initial window geometry (e.g., 800x600).

-n
    Disable image interpolation.

-r
    Rotate images by a specified number of degrees.

-s
    Start in slideshow mode.

-t
    Disable transparency.

-v
    Verbose output.

-z
    Zoom images to fit window.

-m
    Start in thumbnail mode.

-h
    Display help message.

-V
    Show version information.

DESCRIPTION

imv is a command-line image viewer heavily inspired by vim.
It allows users to navigate through images in a directory, zoom, pan, rotate, and perform other basic image manipulations using keybindings similar to those found in vim.
It's designed for speed and efficiency, making it well-suited for viewing large sets of images quickly.
imv supports various image formats including PNG, JPEG, GIF, and WebP, and utilizes libraries like SDL2 for rendering.
Users can configure keybindings and other settings through a configuration file, offering a high degree of customization. It allows scripting using shell commands to perform complex operations. It is a lightweight and efficient tool for users who prefer a keyboard-driven image viewing experience.

CAVEATS

imv relies on SDL2 and other libraries for image decoding and rendering. Ensure these dependencies are installed on your system for imv to function correctly. Keybindings are case-sensitive.

CONFIGURATION

imv can be configured using a configuration file, typically located at ~/.imv/config. This file allows users to customize keybindings, default settings, and other aspects of the viewer. See the imv documentation for more information.

KEYBINDINGS

imv uses vim like keybindings to perform functions on the image. For example, scrolling with j and k. zoom with + and -.

HISTORY

imv was created as a lightweight and efficient image viewer with vim-like keybindings for users who prefer a keyboard-centric interface. Its development focuses on speed, customization, and minimal dependencies. It is actively maintained and has gained popularity among Linux users seeking an alternative to traditional GUI image viewers.

imv