A pipe to browser utility
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.gitignore initial Jan 18, 2014
.npmignore ansi disabled by default Apr 16, 2014
LICENSE Initial commit Jan 18, 2014
README.md Update README.md Mar 24, 2015
index.js display help on --help not just --usage Sep 21, 2014
package.json 1.1.8 Sep 21, 2014
test.html ansi disabled by default Apr 16, 2014
test.js small change Jul 7, 2014
usage.js fix usage foramtting bug Sep 21, 2014



Pipe to the browser utility, Very useful for log tail fun :)

node-bcat features auto scrolling (with enable/disable), ansi to html coloring (--ansi) and behavior and color customization.

This module uses RC to manage its configuration, so in addition to command line arguments you may save your favorite configuration in .bcatrc.


> npm install -g bcat

> cat somefile | bcat

// redirect error stream also
> node index.js 2>&1 | bcat

Want to see something moving too?


setInterval(function () {
}, 1000)


> node test.js | bcat



 --port                   set a port for this bcat execution
 --contentType            content type header, must be lower case      [default: "text/html"]
 --backgroundColor        (only in text/html)                          [default: "#000000"]
 --foregroundColor        (only in text/html)                          [default: "#ffffff"]
 --tabLength              length of a tab in spaces                    [default: 4]
 --tabReplace             tab replacement                              [default: "    "
 --disableTabReplace      disable tab replacement                      [default: false]
 --newlineReplace         new line replacement                         [default: "<br />"
 --disableNewlineReplace  disable new line replacement                 [default: false]
 --ansi                   show colorful ansi (implies text/html)       [default: true]
 --ansiOptions            override replacement of ansi black color
 --scrollDownInterval     interval to execute javascript scroll down   [default: 1000 (ms)]
 --serverTimeout          http://nodejs.org/api/http.html#http_server_timeout  [default: 0 (no timeout)]
  • An available port between 8080 - 8181 will be automatically picked if --port is not specified
  • ansi feature is on by default

be a good cat


scat - pipes javascript into your browser

hcat - pipes html into your browser

bpipe - bidirectional piping between unix and the browser

browser-run - The easiest way of running code in a browser environment

Inspired by a ruby bcat implementation