Skip to content
A simple command to render image to terminal. Written in Go.
Go Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
docs/images
test/artifacts
.gitignore
LICENSE
Makefile
README.md
call_external_api.go
color.go
color_test.go
go.mod
image.go
image_test.go
input_helper.go
main.go
resampling.go
resampling_test.go
terminal.go

README.md

imgcat

Introduce

A simple utily to render an image to terminal. Support load image from local disk and from image url.

Features:

  • Ouput image 2 pixel per glyph.
  • Can fetch image from url.
  • Auto analize your terminal size and scale output image base on it.

Screenshots

Simple cat an image local

Simple cat an image remote

Install

If you have go installed in your system.

go get -u github.com/stephentt-me/imgcat

Make sure $GOPATH/bin is in your $PATH.

Or download binary here and put it into your $PATH.

Usage

"Cat" image from file

imgcat foo.jpg

"Curl" image from url

imgcat <url>

Development

To build from source, after clone this repo, run:

make build

Run unitest:

make test

License

MIT

You can’t perform that action at this time.