imclab / alfred-flik

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)

   

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

   

   Using the address book described in call_twilio.py file

   

4. A text message is sent to your friend

   

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

   

Examples

<pre>movie terminator john</pre>
<pre>movie "safety not guaranteed" [phone]</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

   

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

   

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

• No warranty expressed or implied. Software is as is.
• MIT License
• Lovingly created by Mashery Dev