iv

iv

iv is a command-line image viewer using terminal graphics (Sixel, iTerm, Kitty).

Installing | Building | Using | Releases

Overview

iv is a command-line image viewer using terminal graphics.

Uses Sixel, iTerm Inline Images, or Kitty graphics protocols where available. See Are We Sixel Yet? for a list of terminals known to work with this package.

Installing

iv can be installed via Release, via Homebrew, via AUR, via Scoop or via Go:

Installing via Release

1. Download a release for your platform
2. Extract the iv or iv.exe file from the .tar.bz2 or .zip file
3. Move the extracted executable to somewhere on your $PATH (Linux/macOS) or %PATH% (Windows)

Installing via Homebrew (macOS and Linux)

Install iv from the kenshaw/iv tap in the usual way with the brew command:

# install
$ brew install kenshaw/iv/iv

Installing via AUR (Arch Linux)

Install iv from the Arch Linux AUR in the usual way with the yay command:

# install
$ yay -S iv-cli

Alternately, build and install using makepkg:

# clone package repo and make/install package
$ git clone https://aur.archlinux.org/iv-cli.git && cd iv-cli
$ makepkg -si
==> Making package: iv-cli 0.4.4-1 (Sat 11 Nov 2023 02:28:28 PM WIB)
==> Checking runtime dependencies...
==> Checking buildtime dependencies...
==> Retrieving sources...
...

Installing via Scoop (Windows)

Install iv using Scoop:

# Optional: Needed to run a remote script the first time
> Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# install scoop if not already installed
> irm get.scoop.sh | iex

# install iv with scoop
> scoop install iv

Installing via Go

Install iv in the usual Go fashion:

# install latest iv version
$ go install github.com/kenshaw/iv@latest

Using

$ iv /path/to/image_or_directory

# all command line options
$ iv --help