Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Python
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
development
images
Alfred-Flik.zip
LICENSE
README.md

README.md

What is "AlfredFlik"?

"AlfredFlik" is an Alfred extension built using Python, that finds similar movies using Rovi's Metadata and Search API and then allow you to text them to a phone number using Twilio's API.

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

Say, you're a fan of Arnold and you watched Terminator last week with your friend. You can't get enough of the action and you wanna watch more movies along the same lines. You can now use Alfred-Flik - a handy extension that lets you specify a movie name and the name/phone number of the person you'd like to text the list of movies to. Alfred-Flik then queries Rovi's Metadata and Search API, pulls up a list of similar movies. It also finds the ratings of these movies via Rotten Tomatoes. Finally it sends it as an SMS to the phone number you provide using Twilio.

Requirements

  1. Alfred + Alfred Powerpack
  2. Rovi API Key
  3. Twilio API Key
  4. Growl
  5. 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 movie followed by the name of the movie you want to search by and then the name/phone number of the person you'd like to text the results to (You can change the keyword by editing the info.plist file)

    Using the phone number

    Alfred Launch Bar

    Using the address book described in call_twilio.py file

    Alfred Launch Bar

  4. A text message is sent to your friend

    Alfred Text Message

  5. Also, you get a Growl notification confirming that the text was sent and the list of the movies that were sent.

    Alfred Growl Notification

Examples

<pre>movie terminator john</pre>
<pre>movie "safety not guaranteed" +1417123456</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 "rovi_auth.py" and type in your type in your Rovi API key & Shared Secret. Get your Rovi (Metadata and Search) API Key here

    Type your Rovi API Key

  5. Open the file "call_twilio.py" and type in your Twilio account id and toke id. Get your Twilio account & token id here

    Type your Twilio API Key

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

    Twilio's Python module

    easy_install twilio

    SimpleJSON

    easy_install simplejson
  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-flik.git
  2. All the Rovi search related action takes place in the file 'rovi_search_.py'

  3. All the Rovi auth related action takes place in the file 'rovi_auth.py'

  4. All the Twilio related action takes place in the file "call_twilio.py"

  5. Tweak away!

About

Something went wrong with that request. Please try again.