Flexible terminal image viewer for iTerm2
iv: Terminal Image Viewer for iTerm2
iv is a utility for viewing images in the terminal using iTerm2's image display capability. It's useful for dealing with images on a remote server, for example with large image processing tasks.
When displaying single images,
iv will resize them to speed up
transfer over an SSH connection:
When displaying multiple images,
iv will produce a "contact sheet"
of images with filenames:
iv can be installed using pip:
$ pip3 install iv
Usage: iv [OPTIONS] FILENAME... Display images within an iTerm2 terminal. iv will resize images to reduce the time taken to display them over SSH connections, and it will combine multiple images into a single image, with filenames. Usage: iv ./file.jpg # Display a single file, resizing as appropriate. iv *.jpg # Display a number of files combined into a single image, with filenames. The IV_SIZE environment variable can be used to set the output image size instead of the -s/--size option. Options: --version Show the version and exit. -s, --size INTEGER Maximum output image width in pixels. --help Show this message and exit.
iTerm2 has some image resizing logic which means that increasing the displayed width may actually decrease the size of the image. This seems to be partly dependent on terminal dimensions.
iTerm2 may refuse to display extremely large images, and replace them with an extremely retro "broken image" icon.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size iv-1.0-py3-none-any.whl (3.8 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size iv-1.0.tar.gz (3.5 kB)||File type Source||Python version None||Upload date||Hashes View|