Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Convert ansi escaped text streams to html.
CoffeeScript JavaScript
Branch: master


latest commit 3ec27721f0
@rburns authored
Failed to load latest commit information.
src Update
.gitignore Initial commit
.npmignore Initial commit
.travis.yml better travis ci config?
LICENSE corrects author in license file badges
gruntFile.js use tap reporter for tests
package.json bump version to 0.3.0

Ansi to Html

This is a port of the ansi to html converter from bcat to Javascript.

It has a few additions:

  • The API has been altered to accept options in the constructor, and input in toHtml().
  • ANSI codes for setting the foreground or background color to default are handled
  • the 'erase in line' escape code (\x1b[K) is dropped from the output.


npm install ansi-to-html


var Convert = require('ansi-to-html');
var convert = new Convert();


    <span style="color:#000">black<span style="color:#AAA">white</span></span>


Options can be be passed to the constructor to customize behaviour.

fg CSS color values The default foreground color used when reset color codes are encountered.

bg CSS color values The default background color used when reset color codes are encountered.

newline true or false Convert newline characters to <br/>.

escapeXML true or false Generate HTML/XML entities.

stream true or false save style state across invocations of toHtml().


Once you have the git repository cloned, install the dependencies:

cd ansi-to-html
npm install

If you don't have it already, install the grunt command-line tool:

npm install -g grunt-cli

Build and test


All the time

grunt watch

Or separately

grunt coffee
grunt simplemocha  # or npm test
Something went wrong with that request. Please try again.