Growl Mercurial Access

Growl developer documentation

Requirements

In order to build Growl, you will need Xcode 2.5 or above (this version requirement may be increased at any time), a free download from the Apple Developer Connection. This also means that you need to be using 10.4 to build Growl as well.

In order to get the latest source code, you will need a working installation of Mercurial.

Getting the source

You will need to grab the Growl source tarball or the source tree from Mercurial.

To get the source tarball, click here, and skip the rest of this section once you have decompressed this tarball.

If you choose to use the current source tree from Mercurial, open the Terminal application, located in the /Applications/Utilities folder, and run the following commands:

export LC_ALL="en_US.UTF-8"

hg clone https://bitbucket.org/boredzo/growl/

If you get a message telling you that the command hg cannot be found in your path, please read the Mercurial installation page.

Compiling and Installing Growl

You should now have a folder called growl in your home directory. In it you will find an Xcode project file, Growl.xcodeproj.

Open Growl.xcodeproj and build the "Growl" target. If you are not sure of how to do this, please refer to the Xcode Documentation.

The Growl target compiles the actual Growl application binary and packages it with the preference pane. When you're done (this can take several minutes depending on the speed of your computer), there should be a new build folder in the same directory as the Xcode projects. In it you will find several files, but the important one is Growl.prefPane.

To install Growl, double click on Growl.prefPane. You will see a confirmation window asking you if you want to install the preference for yourself or for all users.

Either option will work, but you might need administrative privileges on the computer if you choose to use the latter one. Keep in mind that to remove the preference later, you can delete the Growl.prefPane file in ~/Library/PreferencePanes or /Library/PreferencePanes (depending on where you installed it). Deleting the preference pane will uninstall Growl.

The preference pane should now be open, allowing you to 'Start Growl,' which launches the Growl daemon, and 'Start at Login.' If you plan on using Growl a lot, it's probably a good idea to have the notification server start when you log in.

Congratulations! You've now built and installed Growl from source.