Quicksilver Plugin for Plazes

From rukapedia
Revision as of 12:06, 5 August 2007 by Peter (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The Quicksilver Plugin for Plazes reproduces some of the functionality of the Mac Plazer: you can use it to check in and out of Plazes using Quicksilver (if you have a Mac and you don't use Quicksilver, it's worth your time to take a look).

The plug-in does not reproduce the "see my friends status" functions of the Plazer -- it's only an "update my status" tool.

I owe a debt to Tijs Teulings who created the Quicksilver Plugin for Jaiku.

How to Install

  1. Download the AppleScript
  2. Make a folder called Actions in the folder ~/Library/Application Support/Quicksilver (if one doesn't already exist)
  3. Copy the AppleScript you downloaded (Plazes.scpt) into this Actions folder.
  4. Restart Quicksilver.
  5. Ensure your Plazes username and password are on your OS X Keychain using the name http://plazes.com.

How to Use

  1. Open Quicksilver (using whatever your key combination for doing so is)
  2. Hit . (period) to open text mode.
  3. Type your Plazes status message.
  4. Hit TAB.
  5. Start typing the word "Plazes".
  6. When you see Plazes appear as the action, hit ENTER.
  7. If you've been Plazed, you'll hear a voice say "Plazed".
  8. If you're visited a brand new Plaze, your browser will open to allow you to enter details.

How to Check Out

If you've Plazed yourself using Quicksilver and you want to "check out" -- tells Plazes you're no longer there -- then use the status message checkout and proceed as above.

Screencast

This short video demonstrates the use of the plug-in in Quicksilver.

Gory Technical Details

When you enter your status message this way, here's what happens:

  1. The AppleScript looks up the MAC address of the router you're using to connect to the the Internet.
  2. Using this MAC address, the script uses cURL to connect to the Plazes API and retrieve the Plaze(s) attached previously, if any, to this MAC address.
  3. If one or more Plazes are returned...
    1. The script takes the first suggestion (yes, this could be smarter, but it's not) and grabs its Plazes ID.
    2. The script sends your status message using the Plazes API.
    3. The script says "Plazed" (it actually says "Playzd" because that sounds better).
  4. If no Plazes are returned...
    1. The script opens your default browser and lets you create a new Plaze.

Download

Download the Applescript