mkhl / run-script.hgs

A Quick Search Box plugin for running scripts.

This URL has Read+Write access

name age
history
message
file .gitignore Wed May 13 13:47:21 -0700 2009 Initial import. [mkhl]
file Info.plist Tue Jun 23 03:18:05 -0700 2009 Add a simple action to run AppleScript text obj... [mkhl]
file LICENSE Wed May 13 13:47:21 -0700 2009 Initial import. [mkhl]
file README.markdown Thu Sep 24 14:05:31 -0700 2009 Rename README again. [mkhl]
file RunScript.applescript Tue Jun 23 03:18:05 -0700 2009 Add a simple action to run AppleScript text obj... [mkhl]
directory RunScript.xcodeproj/ Wed May 13 13:47:21 -0700 2009 Initial import. [mkhl]
README.markdown

RunScript Plugin for Google QSB

A Google Quick Search Box plugin to add actions for running scripts.

Download the plugin: http://github.com/mkhl/run-script.hgs/downloads

Usage

  • Hit you QSB keyboard shortcut.
  • Type the shell command you want to run. [Hint: To get a text object, type an initial space.]
  • Tab into the text object.
  • Choose the “Run Shell Script” action to run your script in the background, or the “Run in Terminal” action to run it inside a new Terminal.app window.
  • Hit enter to run the script.

Installation

After extracting the plugin, you will find a bundle called RunScript.hgs. Copy this bundle to ~/Library/Application Support/Google/Quick Search Box/PlugIns, then restart QSB.

If you built the plugin from source (described below), you will find the RunScript.hgs bundle in your build directory.

Building

Building this plugin requires that you set up two source trees in Xcode. You will have to have the QuickSearchBox source tree downloaded to your machine. Instructions on getting the QSB source tree can be found here: http://code.google.com/p/qsb-mac/source/checkout

To set up the source trees in Xcode:

  1. Go to "Xcode>Preferences" and click on the "Source Trees" icon.
  2. Click on the "Plus" button on the left hand side of the window.
  3. Set the "Setting Name" of your new tree to QSBBUILDROOT
  4. Set the "Display Name" to QSBBUILDROOT
  5. Set the path to the debug build directory for QSB. For me the path looks like this ~/src/QuickSearchBox/QSB/build/Debug. If you use a common build directory or some other customized build location, you will have to set it here.
  6. Click on the "Plus" button again
  7. Set the "Setting Name" of your new tree to QSBSRCROOT
  8. Set the "Display Name" to QSBSRCROOT
  9. Set the path to the root directory for QSB. For me the path looks like this ~/src/QuickSearchBox.

The plugin should now build cleanly.

You should only have to add the source trees to Xcode the first time you build a QSB plugin.

If you are developing plugins, please join our mailing list: http://groups.google.com/group/qsb-mac-dev