Welcome to Keystone

Safari users: ever wanted to quickly search Wikipedia, or use a search engine besides Google? Then Keystone is what you've been looking for!

Keystone adds custom keyword searches to Safari. Type simple queries such as "wiki Mac OS X" directly into the address bar, and Keystone will translate them into searches—in this case, opening the Mac OS X page on Wikipedia.

Installation

  1. First, make sure you are using Safari 4 or 5 on Mac OS X v10.5 or later.
  2. Make sure you have a recent version of SIMBL installed. If you recently upgraded Mac OS X, you probably want to get the latest version.
  3. Install Keystone.bundle, either by running the "Install Keystone for Me" script, or by copying it yourself to ~/Library/Application Support/SIMBL/Plugins (creating that folder if necessary).
  4. Relaunch Safari.

Usage

Keystone comes with a couple of default shortcuts, including "wiki" for Wikipedia, "define" to search Dictionary.com, and a default (catch-all) shortcut to search using Google on unknown queries. But adding your own completion shortcuts is easy.

First, navigate to a page with a search box, and click inside it, as if you were going to search for something.

Next, choose "Add Keystone Search Completion…" from the Bookmarks menu. Keystone will perform a search, then inspect the URL to figure out how to generalize it to a shortcut.

Fill in the required information for the new shortcut. The most important one is the "keyword" field, which specifies what sort of query will use this shortcut. (Note that you can have more than one completion for the same keyword. In this case, the one with the title that is alphabetically first will appear first in the list of possible completions.)

That's it! You can now use your new shortcut in searches. Just type your queries into the location bar, using the keyword you specified.

To switch between Keystone's completions and Safari's completions, press the up arrow key.

If you ever want to edit or delete a shortcut, you can do so from Keystone's preference pane, found in the standard Safari preferences window.

Finally, if you ever want to add a shortcut that isn't based on a search, you can hold the Option key and select "Add Manual Keystone Shortcut…" from the Bookmarks menu.

Notes

It says Keystone isn't compatible with my version of Safari.
If you're using an up-to-date version of Safari, it's likely Keystone hasn't been tested on this version. Check for an update in the Keystone preference pane or e-mail the address below.
If you're still using Safari 3, upgrade to Safari 4.
Does Keystone work with WebKit nightlies?
Yes.

Uninstall

If you want to uninstall Keystone (for whatever reason), just delete the Keystone.bundle file from ~/Library/Application Support/SIMBL/Plugins. (You can get to that folder by choosing "Go to Folder" from the Go menu in the Finder, and entering ~/Library/Application Support/SIMBL/Plugins/.) Then quit and reopen Safari.

Contact

keystone@belkadan.com: Bugs, requests, questions? E-mail me!
belkadan.com: Get more great programs from Belkadan Software!