README.md

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

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)