Acatiris (pronounced a cat iris, an anagram of ASCII art), is an ASCII art middleware for Express. You can use Acatiris at the end of your application's middleware stack to convert all the images in your HTML into ASCII, or as a controller to create an ASCII art endpoint.
Install with npm:
$ npm install acatiris
Acatiris needs the jp2a and Imagemagick CLI tools installed and available on the system's $PATH in order to run.
For example:
- on OS X you can install the dependencies with Homebrew by running:
$ brew install jp2a imagemagick - on Ubuntu/Debian you can install the dependencies with
apt-get:$ sudo apt-get install jp2a libmagick++-dev
To convert the images in your application's HTML into ASCII, put Acatiris at the end of your middleware stack:
// Import Acatiris.
var acatiris = require('acatiris');
// Create a sample endpoint.
app.get('/', function(req, res, next){
res.body = 'hit me up <a href="https://twitter.com/lsvx">@lsvx</a><img src="http://upload.wikimedia.org/wikipedia/commons/6/6a/JavaScript-logo.png"/>';
next();
});
app.use(acatiris);
/*
Will output:
hit me up @lsvx
..................................................
..................................................
..................................................
..................................................
..................................................
..................................................
..................................................
..................................................
..................................................
..................................................
..................................................
......................,llll.......;cooooc;........
......................lKKKK'....l0KKKKKKKK0o......
......................lKKKK'...oKKK0o::lOKkl'.....
......................lKKKK'...OKKKk.....'........
......................lKKKK'...lKKKKOo:'..........
......................lKKKK'....:OKKKKKK0dc'......
......................lKKKK'......,cxOKKKKK0d.....
......................lKKKK'..........':dKKKKx....
...............'c'....oKKKK'...,ld'......xKKKK....
.............:OKK0dcco0KKKx...kKKK0xlcclxKKKKd....
..............lOKKKKKKKK0o.....ckKKKKKKKKKKOc.....
................,cloooc;..........;cloool:'.......
..................................................
..................................................
*/To add an ASCII art endpoint to your application, simply include Acatiris like you would and controller:
// Import Acatiris.
var acatiris = require('acatiris');
app.use('/ascii', acatiris.endpoint);Now, a requests to lsvx.com/ascii/<url>, such as http://lsvx.com/ascii/http://o-dub.com/images/rapcat.jpg will generate something sweet.
MIT