Growl Subversion Access

Growl developer documentation

Requirements

In order to build Growl, you will need Xcode 2.4 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 Subversion.

Getting the source

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

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 Subversion, open the Terminal application, located in the /Applications/Utilities folder, and run the following commands:

export LC_ALL="en_US.UTF-8"

svn co svn://src.growl.info/growl/trunk growl

If you get a message telling you that the command svn cannot be found in your path, please read the Subversion 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, build the "Growl" target. and then do the same with the "Growl.framework" 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. Growl.framework creates a Growl framework for other applications to use. 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 ones are Growl.prefPane and Growl.framework.

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 Notification Server,' 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.

Growl should now be working. But before you do anything else, you should install the Growl framework in order to build other applications that depend on it, such as GrowlTunes. Go back to the Growl build directory and find the Growl.framework folder. Copy it to one of the following locations:

• ~/Library/Frameworks/
• /Library/Frameworks/

If you installed the Growl preference for all users, it's probably a good idea to use the second location so that other users will be able to access GrowlAppBridge. If you installed the preference for yourself, then the first location will work just fine.