Skip to content

Latest commit

 

History

History
51 lines (28 loc) · 1.36 KB

README.md

File metadata and controls

51 lines (28 loc) · 1.36 KB

icat - image cat

Outputs an image on a 256-color or 24-bit color enabled terminal with UTF-8 locale, such as gnome-terminal, konsole or rxvt-unicode (urxvt).

Building

Build requirements: icat depends on imlib2.

On Ubuntu, apt-get install libimlib2-dev

On Darwin (Mac OS X), brew install imlib2

Note that for Darwin (Mac OS X), you will need to install XQuartz first, the version of the X.Org X Window System (X11) that runs on OS X.

To compile:

make

Running

Run icat with a local file:

icat sample.png

or with multiple files:

icat img1.jpg img2.jpg > newfile.txt

or, if - is used as as file name, it reads from standard input:

curl -sL https://raw.github.com/atextor/icat/master/sample.png | icat -

The above commands results the following output in 256-color terminal, see sample.256-color.txt for the actual output:

Output of sample.png

For terminals that support 24-bit color (such as Konsole and Yakuake, see this document for more information about terminals and their color support), this can be enabled using:

icat -m 24bit sample.png

Author

icat was written by Andreas Textor textor.andreas@googlemail.com. The sample icon is from the Nuvola icon theme by David Vignoni.