/catimg

:squirrel: Insanely fast image printing in your terminal

Primary LanguageCMIT LicenseMIT

Catimg

Renders images in the terminal.

mewtwo

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.

Installation

Homebrew

brew install catimg

Arch Linux

yaourt -S catimg

Fedora 25 and later

dnf -y install catimg

Building

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).

Examples

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.

Contributing

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

License

MIT

Copyright (c) Eduardo San Martin Morote

Support on Beerpay

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

Beerpay Beerpay