Imgcat

Display images and gifs in your terminal emulator.

Features

• Animated GIF support
• Accept media through stdin
• Transparency

Installation

MacOS

brew install danielgatis/imgcat/imgcat

Linux

First, install snapcraft.

sudo snap install imgcat

Windows

First, install scoop.

scoop bucket add scoop-imgcat https://github.com/danielgatis/scoop-imgcat.git
scoop install scoop-imgcat/imgcat

Download binaries

Alternatively, you can download a pre-built binary here.

Build from source

First, install Go.

Next, fetch and build the binary.

go install github.com/danielgatis/imgcat@latest

or, if you use pre-1.17 Go version, use the go get command:

go get -u github.com/danielgatis/imgcat

Usage

Display a remote image

curl -s http://input.png | imgcat

Display a local image

imgcat path/to/image.png

Options

• -h, -help: Show help message
• -interpolation: Set interpolation method (default: lanczos)
  • nearest: Fastest resampling filter, no antialiasing.
  • lanczos: A high-quality resampling filter for photographic images yielding sharp results.
• -type: Image resize type. Options: fit, resize (default: fit)
• -cols: Number of terminal columns to use for rendering the image (default: terminal width)
• -rows: Number of terminal rows to use for rendering the image (default: terminal height)
• -top-offset: Offset from the top of the terminal to start rendering the image (default: 1)
• -silent: Hide exit message (default: false)

Requirements

Your terminal emulator must be support true color and use a monospaced font that includes the lower half block unicode character (▄ U+2584).

License

Copyright (c) 2020-present Daniel Gatis

Licensed under MIT License

Buy me a coffee

Liked some of my work? Buy me a coffee (or more likely a beer)