+------------+ | twStreamer | +------------+ Because we don't (yet) support Web Sockets on the Twitter Streaming API (http://apiwiki.twitter.com/Streaming-API-Documentation), the only method available to connect to the Streaming API from Javascript is to rely on a Flash intermediary. This library provides a very small SWF (2K when compiled), that will connect to the Streaming API and then call back out to JavaScript with the JSON status object once it is received. This library is only, currently, suitable for proof of concept scenarios. +-----------------+ | Getting Started | +-----------------+ This library depends on both jQuery 1.4.2 (http://jquery.com/) and jQuery SWF Object (http://jquery.thewikies.com/swfobject/). With those, the twstreamer.js and TwStreamFlash.swf files in the same directory, and the JS scripts included via script tags, it is as simple as // set up the connection jQuery.twstreamer .init() .credentials(USERNAME, PASSWORD) .connect( function(tweet) { // callback function // receive tweet console.log(tweet); }, 'track', // api method (track, follow, etc.) 'twitter', // api query 'betastream.twitter.com' // the host to connect to (optional) ); // good housekeeping, once the connection can be closed jQuery.twstreamer.disconnect(); At this time, the Streaming API still uses basic auth, so the call to credentials(USERNAME, PASSWORD) requires basic auth credentials to connect. Once the credentials have been supplied connect(handler, method, query, host) will actually initiate the connect and begin to proxy Tweets. The "handler" needs to take a single jQuery parsed JSON object as an argument -- that is the actual Tweet. The host to connect to is optional, but at this time, stream.twitter.com, the default Streaming API endpoint, does not serve a crossdomain.xml file. Only the betastream.twitter.com does. +--------------+ | Contributors | +--------------+ Raffi Krikorian <raffi@twitter.com> Russell D'Sa <dsa@twitter.com> Premasagar Rose <p@premasagar.com>