Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Pipe data anywhere
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


wsio -- web stream input/output tool

Dependencies: Ruby (dev version to compile extensions) and Rubygems

Install: sudo gem install wsio

Usage: wsio [options] [user[:pass]@][hostname][path]
  -l  Listen to stream and print to STDOUT
  -s  Use HTTPS
  -k  Ignore SSL verification (like curl)
By default, wsio listens to STDIN and does an HTTP POST for each line.

This tool is similar to netcat in that it's intended to be used with STDIN and
STDOUT, making it perfect for command pipelining. However, instead of direct
point to point TCP/UDP connections, it uses HTTP. Coupled with a server that
provides realtime pubsub over HTTP and you have one of the most magical tools
ever. Here's a toy log aggregation example:

Run this on one or several machines:

  tail -f /var/log/something | wsio somehost/log

Run this on your central aggregator:

  wsio -l somehost/log > /var/log/aggregate

Run this on your *laptop behind NAT* to watch the logs:

  wsio -l somehost/log

Obviously there is a server-side component to this. It's not that complicated
and there are some servers that already implement streams this way. 

For example, Twitter's Stream API:

  wsio -l <user>:<pass>

However, wsio was made with a particular server-side component in mind. If you
are interested in this, please email me. 
Something went wrong with that request. Please try again.