- Clone the repository from GitHub
- Open the project in Xcode
- Select the “Quicksilver Distribution” target at the top of the window and build
Everything you build should end up in
Build and Run
If using “Build and Run” with the Release configuration, you might end up with an unresponsive app. This is likely to happen under the following conditions:
- Quicksilver is configured to hide its Dock icon
- You’re building for the the first time (or after doing a Clean All)
If the “Stop” button in Xcode is grayed out, that’s a clue that something went wrong. Use Activity Monitor to quit the Quicksilver process then “Build and Run” again. It should work for this and all subsequent builds until you start fresh again.
You’re better off using the Debug configuration when doing “Build and Run”, as it knows not to relaunch the app.
You can also install Quicksilver via Macports, a package management system for OS X. You'll need to install the Xcode package and Macports itself, but then you can build and install Quicksilver from source just by running
sudo port install quicksilver
You can use this as a sanity check to be sure that your environment is able to build Quicksilver. You can also inspect what Macports is doing by adding a
-d debug flag to the command or by running
port edit quicksilver to view the Portfile (Macports configuration file).
For all the non-coding QS users out there, here's a further breakdown of building the latest QS.
- Install Xcode from the Mac App Store.
- Make sure there's no other Quicksilver apps on the system by zipping older versions and deleting the apps the zips originated from, then emptying the Trash.
- See http://qsapp.com/wiki/Github#Adding_the_Quicksilver_Remote_Repository for info about downloading the latest QS build project.
- Open the Quicksilver.xcodeproj with XCode.
- Using the Scheme drop-down at the top of the window, choose 'Quicksilver Distribution' within 'Targets' and click ‘Build’ (or hit ⌘B).
- Quit QS.
- In Xcode, click 'Run' in the toolbar.
A ‘Product -> Clean’ (or ⇧⌘K) should be performed if you're experiencing crashes or problems. Also try deleting the folder
/tmp/QS before building again.
If the build still crashes regularly, move all of these paths before trying a new build:
- ~/Library/Application Support/Quicksilver/Plugins
then move them back one at a time before trying again. When a replaced folder causes a crash, repeat the process for the contained folders, and so on.
If QS seems stable, and to get the full benefits of the app:
- In the “Edit Scheme…” menu item on the Product menu, change the Build Configuration to “Release”
- Build as before.
- Copy the app in
- Run as a normal app from
This process will overwrite any QS app you (shouldn't) have in /Applications.