Awesome Open Source
Awesome Open Source


A real-time 3D visualization of Tweets from around the world.

This web app attaches to the Twitter API stream/filter and runs rudimentary sentiment analysis on Tweets with geo data. Tweets are published via PubNub Websockets and plotted to a 3D globe.

Inspired by the Web GL Globe Chrome Experiment and the PubNub Real-Time WebGL Visualization.

Screenshot Video Capture | Running Demo (Availability of this server may fluctuate)

Installing and Running

Install Node.js.

Clone GitHub repo:

Create a Twitter app and PubNub account:

Create a config.json file using config.sample.json as a template. Fill in your Twitter App API and PubNub keys.

Optionally, install the Compass Ruby Gem.

gem install compass

If you do not want Compass support, comment out this line in app.js

// app.use(require('node-compass')({mode: 'compress'}));

Install node module dependencies:

npm install

Run application:

npm start

Go to http://localhost:3000 in your browser.


This application is ready to run on a free Cloud Foundry, OpenShift or Heroku account.


You can deploy to Heroku via Git with the Heroku toolbelt.

Before deploying to Heroku, set your environment config vars to mirror config.json, and set NODE_ENV to "production."


Tip: Managing the Twitter stream is more appropriately accomplished with a worker or background job. See this gist for setting up a Twitter / PubNub worker on Heroku.


You can deploy to OpenShift with rhc, by adding your own keys to the following command:

rhc app create twglobe nodejs-0.10 \
  --from-code= \
  NODE_ENV=production \

Cloud Foundry

You can deploy to a Cloud Foundry instance with the cf command line tool.

Edit out the line for Compass support (see above) in app.js.

Copy manifest.sample.yml to manifest.yml, edit the application name, and then insert your Twitter and PubNub API keys.

Run cf push to deploy and start the app on Cloud Foundry.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (68,034
webgl (386

Find Open Source By Browsing 7,000 Topics Across 59 Categories