Extras

growlnotify

About
growlnotify is a command-line tool to post Growl notifications. You can control all aspects of the notification (within any boundaries set up in the Growl pane of System Preferences). It can be very useful in shell scripts.

Installing
In your shell, cd to the directory on the Growl disk image containing growlnotify, and type ./install.sh. That script will install growlnotify to /usr/local/bin and the manpage to /usr/local/man.

Building from sources
Running 'make' will build growlnotify into your build folder if you want to test it before installation.

Running 'make install' will install growlnotify into /usr/local/bin and install the manpage into /usr/local/man. It will also do a build first if necessary.

The Makefile uses xcodebuild internally, with the Deployment buildstyle.

Usage

Display a notification using the title given on the command-line and the message given in the standard input.

Priority can be one of the following named keys: Very Low, Moderate, Normal, High, Emergency. It can also be an int between -2 and 2.

To be compatible with gNotify the following switches are accepted:

The manpage provides more information on the usage of growlnotify. Just type 'man 1 growlnotify' after installing growlnotify.

GrowlMail

About GrowlMail
GrowlMail is a plug-in for Apple Mail that posts a Growl notification every time new mail arrives containing the text of the message.

Example notification for a new mail.

Installing GrowlMail
Quit Mail Open the GrowlMail package that you will find in the Extras folder of your download. Restart Mail.

Using GrowlMail
You will find the preferences in a new tab of the normal Mail preferences (see image). You can disable GrowlMail, or disable notifications for mails marked as junk by Mail. If desired you can enable or disable notifications for specific email-accounts.

GrowlSafari

About GrowlSafari
GrowlSafari is an application that adds Growl support to Safari.

Installing GrowlSafari
Use the GrowlSafari Installer package in the Extras folder on the Growl disk image. You should quit Safari before installing, but you do not need to restart your machine.

Using GrowlSafari
GrowlSafari notifies about finished downloads and new entries in feeds you've subscribed to in Safari. It has no preferences of its own; you can turn off some or all of its notifications in the Applications tab of Growl's preference pane in System Preferences.

HardwareGrowler

About
HardwareGrowler is an application that sends Growl notifications when devices are connected or disconnected from your Mac.

Supported device types

• FireWire devices
• USB devices
• Bluetooth devices
• File-system volumes
• Network interfaces
• Power sources

Installation:
Copy HardwareGrowler (from here on, we will call it “HwG”) from the disk image to either /Applications or /Applications/Utilities (the exact location doesn't matter; putting it in Utilities would put it more out of the way).

Open up HwG. You'll notice that the application resides in the Dock, but the application doesn't provide very many menu items. The only one of any significance is HwG → Preferences. The only option available is to have HwG show connected devices when it opens. Make your choice, then quit HwG.

Disabling the Dock icon:
Because HwG doesn't really have any user-interaction features, you may prefer to disable the Dock icon. You can use Peter Hosey's Configure Application Dock Tile to safely and easily do this.

Setting HwG to open on login:
The following steps are for 10.4 (Tiger) users, but the general idea behind them should be 100% sound for any version. Open up Systems Preferences and select the Accounts pane. Then click the "Login Items" tab and drag the HwG icon into the list. That's it, you're done!

FAQs:
Q: Does HardwareGrowler affect anything on my computer?
A: No. All it does is monitor what devices and power sources are attached to your computer and notify you if anything changes.

Q: What are "SmokeStacks" and "VolumeNotifier"?
A: They are products similar to HardwareGrowler in that they provide Growl notifications for hardware changes, but they have fallen out of production since we introduced HwG. If you want any features that they had that we haven't included in HardwareGrowler, you should contact us with your request.

GrowlTunes

Installing GrowlTunes
Place GrowlTunes in your Applications folder by dragging and dropping it from the Growl disk image. GrowlTunes comes on the Growl disk image, in the Extras folder.

Using GrowlTunes
Once you have installed GrowlTunes, double click it. This will put the headphones in the menubar at the top of your screen. From here you can control GrowlTunes.

For users of iTunes 4.7 and later, that is all you have to do to get GrowlTunes working. Note: GrowlTunes does not poll for its information with iTunes 4.7 and later.

For iTunes 4.6 and below, the most important part of using GrowlTunes is the polling button at the bottom of the menu. This allows you to turn on and off polling of iTunes (asking it what song is currently being played).

Once you get GrowlTunes to start polling, you should see a bubble like the image below. You will see one of these each time the track changes in iTunes.

Requirements
Mac OS X 10.3 or higher
iTunes
Growl

Artwork
Starting with Growl 0.6, GrowlTunes can get artwork from Amazon.com. (Growl 0.5 came with a version that did not have this capability.) If GrowlTunes does not see artwork in the current track playing, and it also does not see that the album artwork was previously downloaded, it will download the track. GrowlTunes does not write this information to the track, but instead to files on disk. GrowlTunes will place the downloaded artwork in your home directory, in Library/Images/Music.