Introducing TweetScope

In November, I launched, a little site to display the #afterhours hashtag used by many Portlanders to discuss their late-night activities on Twitter. The concept of pairing design with Twitter search results appealed to me and I soon spawned other sites tracking bacon, electric blankets, those damn kids these days with that noise they call music, and CyborgCamp.


I've recently cleaned up and improved the code that powers these sites and am releasing it as an open-source project: TweetScope. It's all written in Ruby using the Sinatra web framework, both of which make me happy.

Setting up your own site with TweetScope is pretty simple.

  1. Grab a copy of the source from GitHub: git clone git://
  2. Create a new site: rake site:create
  3. Edit your new site's config.yml file to tell it what to search for and set other options.
  4. Test things out by running ruby tweetscope.rb and visiting http://localhost:4567 in your browser.
  5. Edit the CSS and template files to customize your site's design and structure.

The TweetScope distribution is optimized for easy deployment to Heroku (free, as of this writing), and I've written up a little deployment guide for their platform.

If you end up setting up your own sites, I'd love to know about it. Enjoy!

One Comment (comment feed)

  1. March 11, 2009; 4:36 pm Permalink

    Nice! I put a quick ‘Scope at

Post a Comment

Use Textile to format comments.