imv/README.md

imv - X11/Wayland Image Viewer

imv is a command line image viewer intended for use with tiling window managers.

Features

• Wayland Support
• Support for over 30 different image file formats including:
  • Photoshop PSD files
  • Animated GIFS
  • Various RAW formats

Usage

Opening images

imv image1.png another_image.jpeg yet_another.TIFF

Opening images via stdin

find . "*.png" | imv -i

Autoscale images to fit the window

imv -s *.gif

Open an image fullscreen (and scale to fit screen)

imv -fs image.jpeg

Viewing images in a random order

find . "*.png" | shuf | imv -i

Image picker

imv can be used to select images in a pipeline by using the 'p' hotkey to print the current image's path to stdout.

Picking a wallpaper

custom-set-wallpaper-script "$(find ./wallpaper -type f -name '*.jpg' | imv - | tail -n1)"

Deleting unwanted images

find -type f -name '*.jpg' | imv - | xargs rm -v

Choosing pictures to email

find ./holiday_pics -type f -name '*.jpg' | imv - | xargs cp -t ~/outbox

Installation

imv depends on FontConfig, SDL2, SDL_TTF, and FreeImage.

$ make
# make install

Contact

There's an official irc channel for imv discussion and development on Freenode: #imv.

License

imv is published under the GPLv2 license.