Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Node.js server and client page to show geo-tagged Tweets live on a map
Branch: master
Pull request Compare This branch is even with chrismatthieu:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

This is a small project I put together to experiment with the Twitter Streaming API. It pulls in all the Tweets in (approximately) the continental United States and displays them in real time on a map.


A demo is running at Please feel free to contact me if the demo goes down!

Getting it to Work for You

You can run this on your own if you have Node.js installed.

  1. Clone the repository
  2. Install the dependencies:

    npm install
  3. Run the server using your Twitter application credentials:

    TWITTER_KEY=consumer_key TWITTER_SECRET=consumer_secret TWITTER_TOKEN=access_token TWITTER_TOKEN_SECRET=access_token_secret ./bin/twimap.js

    You'll need to register for an application at to receive the relevant credentials.

By default the server binds to port 8080, so you can check it out at http://localhost:8080.

Note that, to conserve bandwidth, the application will stop streaming from Twitter if it detects that no clients are connected.

Something went wrong with that request. Please try again.