Metadata-Version: 2.1
Name: iv
Version: 1.0.5
Summary: Flexible terminal image viewer for iTerm2
Home-page: https://github.com/russss/iv
Author: Russ Garrett
Author-email: russ@garrett.co.uk
License: MIT
Keywords: image iterm2 cli terminal
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.4
Description-Content-Type: text/markdown
Requires-Dist: pillow (>=6)
Requires-Dist: imgcat
Requires-Dist: click (>=7)

# iv: Terminal Image Viewer for iTerm2
[![PyPI version](https://badge.fury.io/py/iv.svg)](https://badge.fury.io/py/iv)

`iv` is a utility for viewing images in the terminal using iTerm2's [image display capability](https://www.iterm2.com/documentation-images.html). 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:

![iv displaying a single image](https://github.com/russss/iv/raw/master/images/single.png)

When displaying multiple images, `iv` will produce a "contact sheet"
of images with filenames. These images are decoded and resized in
parallel:

![iv displaying multiple images](https://github.com/russss/iv/raw/master/images/multi.png)

## Installation

`iv` can be installed using pip:

	$ pip3 install iv

If `iv` can't find any suitable TrueType fonts on your system it'll use
an ugly default bitmap font. To get some nicer fonts on Linux, install
the Open Sans or msttcorefonts collections (`fonts-open-sans` or
`ttf-mscorefonts-installer` packages on Debian-like distributions).

## Usage
```
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.
```
## Limitations

iTerm2 may refuse to display extremely large images, and replace them with a
retro "broken image" icon. You can always right-click and "Open image"
to view the image with an external viewer.


