Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Octocat-spinner-32-eaf2f5

Cannot retrieve contributors at this time

file 102 lines (61 sloc) 5.609 kb

What is "Show me the Klout"?

"Show me the Klout" is an Alfred extension built using Python, that provides a quick way to know if someone is worth following on Twitter by providing critical information like their Klout score, what's their follow vs following ratio, when did they join Twitter, number of followers, number of followings - all with a hit of a keystroke through the power of Alfred. It displays this info via a Growl notification.

What is Alfred?

Alfred is an award-winning productivity application for Mac OS X, which aims to save you time in searching your local computer and the web. Whether it's maps, Amazon, eBay, Wikipedia, you can feed your web addiction quicker than ever.

The real power of Alfred lies in it's powerpack that allows you to create your very own Terminal shell scripts, AppleScripts, workflows, search filters and file groups to extend Alfred.

Summary

So, you met someone new at an event or found some one interesting on the inter-webs. What's the first thing you do? Find them on Twitter. Analyze if they're worth following. How do you do that? Every time, I meet some one new, there are somethings I wanna know about them to judge if they're worth following -

  1. What's their Klout score?
  2. When did they join Twitter? (It's true. I'll totally judge you on when you joined Twitter - if you were an early adopter or not. I know, am weird :)
  3. What's their Follow vs Following ratio? (This is important to me. A ratio of less than 1 tells me, you're either not active on Twitter or are a spammer. Either way, probably not worth a follow.)
  4. Number of Followers
  5. Number of Followings

I don't know why I do that. I just do and I do it enough to encourage me to come up with a simpler and faster process than look up people's profiles each time on Twitter.com or a Twitter client. "Show me the Klout" does just that, with just a keystroke. So, you know quickly if this person is worth a follow.

Requirements

  1. Alfred + Alfred Powerpack
  2. Klout v2 API Key - Make sure you get the API key for v2
  3. Twitter API Key
  4. Tweepy - A Python library for accessing the Twitter API
  5. Growl
  6. Nice and shiny Mac - Of course you have one!

How to Use

  1. Make sure Alfred is running.
  2. Just hit your Alfred keyboard shortcut. In my case I have it configured it as CMD + SPACE. (The default is probably ALT + SPACE)

    Alfred Launch Bar

  3. Type the keyword ks followed by a Twitter handle (You can change the keyword by editing the info.plist file)

    Alfred Launch Bar

  4. You get a Growl notification with all the info you'd ever need to judge someone's Twitter follow worth. Enjoy!

    Alfred Growl Notification

Examples

<pre>ks barackobama</pre>
<pre>ks scobleizer</pre>

Installation

  1. Download the extension here

  2. Double click on the .alfredextension file you just download. The extension will install and open up the preferences window in Alfred.

  3. Right click on the extension on the left side bar in Alfred (Extension tab) and click on "Show in Finder". The source files for the extension will open up in Finder.

  4. Open the file "get_klout_score.py" and type in your Klout API key. Get your Klout API Key here

    Type your Klout API Key

  5. Open the file "twitter_auth.py" and type in your Twitter API key. Get your Twitter API Key here

    Type your Twitter API Key

  6. Install Tweepy. Open Terminal and type the following (If you run into permission issues, try with sudo) -

    easy_install tweepy
  7. You're done. Just give Alfred a whirl now. Refer How to Use above.

Development

Be sure to follow the configuration steps above and use this step-by-step guide to tweak to your heart's content.

  1. Grab the latest source

    git clone git://github.com/mashery/alfred-show-me-the-klout.git
  2. Install Tweepy. Open Terminal and type the following (If you run into permission issues, try with sudo) -

    easy_install tweepy
  3. All the Klout related action takes place in the file 'get_klout_score.py'

  4. All the Twitter related action takes place in the file "get_twitter_details.py"

  5. Tweak away!

Problems?

  • Make sure Tweepy module is installed. You can check that by running the following in a Python shell/prompt. Refer Installation for details.

        python 
        help('modules')
    

About

Something went wrong with that request. Please try again.