muluc/birdwatch

Tweet stream analysis and visualization with real-time updates.

#BirdWatch
BirdWatch is a reactive web application for visualizing a stream of live tweets. It started out as a playground for trying out different ways of solving the same problem. There is a server-side application which subscribes to the Twitter Streaming API and then allows a client-side single-page application to perform a live search, meaning that a search on historic tweets up until now will be performed and then updated as new tweets matching the same search are retrieved.

Implementations

On the server side, there are currently two different implementations:

1. Play Framework (Scala) application with communication over Server-Sent Events and multiple clients: AngularJS, ReactJS and ClojureScript/Om. Note that the ClojureScript/Om client is not actively maintained as the Clojure development has moved to the application below. Read more

2. Clojure application communicating with the client over Websockets. The client side application is written in ClojureScript using Om for rendering. Read more

Installation

Installation instructions can be found with the respective implementations.

Further Reading

There are a couple of blog posts covering this application. The best starting point for the Play application is the BirdWatch Explained article covering both the server side and the initial client using AngularJS. The BirdWatch: AngularJS vs. ReactJS article covers the ReactJS client. This article builds on the previous one. Then there is the BirdWatch with ClojureScript and Om explained article. This one may still be useful as it covers how to build a ClojureScript client using Server-Sent Events.

A series of articles about the all-Clojure version is currently in the works. Check out matthiasnehlsen.com and subscribe to the newsletter if you want to stay up to date.

License

Copyright © 2014 Matthias Nehlsen. Distributed under the GNU GENERAL PUBLIC LICENSE, Version 3. See separate LICENSE file.