imgcat icon indicating copy to clipboard operation
imgcat copied to clipboard

Display images and gifs in your terminal.

Imgcat

Go Report Card License MIT Go Doc Release

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

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)

Buy Me A Coffee