😺 Displays images in your terminal using 256-color mode
JavaScript
Latest commit 9b2b6f1 Oct 22, 2015 @wavebeem Merge pull request #2 from mweitzel/patch-1
fix module name in example
Permalink
Failed to load latest commit information.
src Adds no padding option Jan 19, 2015
.gitignore Ignore npm debug log Oct 16, 2014
LICENSE Code cleanup and option parsing Oct 17, 2014
README.md fix module name in example Oct 21, 2015
package.json Adds no padding option Jan 19, 2015

README.md

img-cat

Displays images in your terminal using 256-color mode. Can display PNG, GIF, and JPEG images. Requires a 256-color terminal. GNU Screen does not support 256-color mode out of the box, so search for how to enable that if you're having issues.

Installation

npm install -g img-cat

Usage

usage: img-cat [options] [--] [images]
  -h, --help, -?       display this help text
  -v, --version        display version string
  --copyright          display copyright information

Tips

You can store the output of img-cat to a file and then simply cat it later to view it.

Example:

img-cat cool.png > cool.ansi
cat cool.ansi

And then you can add cat cool.ansi to your ~/.bashrc or ~/.zshrc to have it print out when you open a terminal.

Library

img-cat can also be used as a library.

Example:

var imgcat = require("img-cat");
imgcat.fromFile("/path/to/my/file.png")
    .then(function(x) { console.log(x); });