:shipit: Insanely fast image printing in your terminal
Clone or download
tianxiaogu and posva Upgrade to stb_image v2.19 (#41)
* Upgrade to stb_image v2.19

* Merge patch of #24

* Enable gif

* Fix crashes on multi-frames gif

* Fix memory leak of delays
Latest commit ffa86ff Sep 30, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
completion Add simple zsh completion script (#28) Jul 27, 2017
man Typo in man pages Apr 18, 2017
src Upgrade to stb_image v2.19 (#41) Sep 30, 2018
test-images Add ico file to test Apr 18, 2017
.gitattributes added gitattributes Dec 29, 2014
.gitignore Ignore more files Aug 20, 2015
CMakeLists.txt Fix #21 Jul 27, 2017
LICENSE Update LICENSE Jan 31, 2017
README.md Update License notice in readme Jul 27, 2017
catimg Use Bash from $PATH Sep 17, 2015
catimg-ext-colors.png added png file. Needed by the script Oct 16, 2014
catimg.spec Add zsh completion (#29) Jul 28, 2017



Renders images in the terminal.


catimg is a little program written in C with no dependencies that prints images in terminal. It supports JPEG, PNG and GIF formats. This program was originally a script that did the same by using ImageMagick convert.



brew install catimg

Arch Linux

yaourt -S catimg

Fedora 25 and later

dnf -y install catimg


cmake .
make install

Script Dependencies

In order to use the script you need:

  • ImageMagick 6.6.0-4 2012-08-17 Q16 (Not tested with earlier versions)
  • shell with 256 colors support ( change the #!/usr/bin/env bash by yours). In OS X you just have to update the bash version using Homebrew (or any other method).


pikachu gif

High Resolution vs Low Resolution

By using unicode characters catimg will try to display pictures in higher resolution. You can force the resolution with the -r option.

cats catslow

Differences between Script and C version

Script version is way more accurate concerning colors but considerably slower.


I'm open to any contributions that helps catimg! If you find bugs, please create an issue or do a pull request 😄.



Copyright (c) Eduardo San Martin Morote

Support on Beerpay

Hey dude! Help me out for a couple of 🍻!

Beerpay Beerpay