Metadata-Version: 2.1
Name: iv
Version: 1.0.3
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
Description: # 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 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. You can always right-click and "Open image"
        to view the image with an external viewer.
        
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
