Skip to content
A pipe to browser utility
Ruby Shell
Latest commit 128cce0 Sep 10, 2011 @rtomayko 0.6.2 release
Failed to load latest commit information.
contrib bman(1) contrib script opens man page in browser w/ basic formatting Aug 22, 2010
lib 0.6.2 release Sep 10, 2011
man Add documentation for --command option. Sep 30, 2010
.gitignore 0.4.0 release Jun 23, 2010
CONTRIBUTING CONTRIBUTING suggests sending pull requests Feb 21, 2011
README README example w/ -t should be -T, closes #5 Jul 11, 2010
RELEASING notes on releasing Feb 21, 2011
Rakefile pages rake task builds website Jun 27, 2010
bcat.gemspec 0.6.2 release Sep 11, 2011


    git clone git://
    gem install bcat

bcat is a pipe to browser utility for use at the shell and within editors like
Vim or Emacs. It reads from standard input, or one or more files, and streams
output to a browser window:

    $ echo "hi mom" |bcat
    $ echo "hi mom" |bcat -T 'Important Message'
    $ echo "hi mom" |bcat -b chrome

Plain text is converted to simple preformatted HTML with rudimentary support for
ANSI/VT100 escape sequences (color, background, bold, underline, etc.)

You can also pipe HTML into bcat, in which case input is written through to the
browser unmodified:

    $ echo "<h1>hi mom</h1>" |bcat
    $ echo "*hi mom*" |markdown |bcat

Output is displayed progressively as it's being read, making bcat especially
useful with build tools or even commands like tail(1) that generate output over
longer periods of time:

    $ make all  |bcat
    $ rake test |bcat
    $ tail -f /var/log/syslog |bcat
    $ (while printf .; do sleep 1; done) |bcat

See the bcat(1) EXAMPLES section for more on using bcat from the shell or within
editors like Vim:

bcat was inspired by TextMate's HTML output capabilities and a desire to have
them at the shell and also within editors like Vim or Emacs. See:

Only a small portion of TextMate's HTML output features are currently supported,
although more will be added in the future (like hyperlinking file:line
references and injecting CSS/JavaScript).

See the INSTALLING, COPYING, and CONTRIBUTING files for more information on
those things.

Copyright (c) 2010 by Ryan Tomayko <>
Something went wrong with that request. Please try again.