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

Usage: growlnotify [-hs] [-i ext] [-I filepath] [--image filepath] [-p priority] [title] Options: -h,--help Display this help -n,--name Set the name of the application that sends the notification [Default: growlnotify] -s Make the notification sticky -a,--appIcon Specify an application name to take the icon from -i,--icon Specify a file type or extension to look up for the notification icon -I,--iconpath Specify a file whose icon will be the notification icon --image Specify an image file to be used for the notification icon -p,--priority Specify an int or named key (default is 0) 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: -t,--title Does nothing. Any text following will be treated as the title because that's the default argument behaviour -m,--message Sets the message to the following instead of using stdin

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