Indexman:
 GROWLNOTIFY(1)            BSD General Commands Manual           GROWLNOTIFY(1)

NAME
     growlnotify -- send a notification to Growl

SYNOPSIS
     growlnotify [-hsv] [-i ext] [-I filepath] [--image filepath] [-a appname]
                 [-p priority] [-H host] [-u] [-P password] [--port port]
                 [-n name] [-m message] [-t] [title]

DESCRIPTION
     growlnotify posts a distributed notification to Growl.

     The options are as follows:

     -h, --help  Displays this help and exit.

     -n, --name name
                 Sets the application name to register the notification under.
                 By default 'growlnotify' is used.

     title       The title of the notification.

     -t, --title
                 Does nothing.  This is included to make the syntax compatible
                 with gnotify, another Growl example written in a different
                 programming language.

     -m, --message message
                 Uses message instead of stdin as the notification message
                 (also called description).  If message is '-', stdin is still
                 used.

     -a, --appIcon name
                 Sets the notification's application icon to the icon for the
                 given application name. If you don't specify a notification
                 icon, this will be used instead of it; if you specify both,
                 the application icon may be used as a badge (that is, dis-
                 played in a corner of the notification icon, superimposed on
                 top of it), or the display may show both separately.

                 Icons are not supported by all displays, so this may be
                 ignored.

     -i, --icon ext
                 Sets the notification icon to the default icon for the given
                 extension or HFS-encoded file type. For example, -i mp3 and
                 -i 'MP3 ' (note the space in the second example) will both
                 use the icon for MP3 files.

                 Icons are not supported by all displays, so this may be
                 ignored.

     -I, --iconpath path
                 Sets the notification icon to the given file's icon (the icon
                 you would see in the Finder if you were looking at the file).

                 Icons are not supported by all displays, so this may be
                 ignored.

     --image path
                 Sets the notification icon to contents of the given image
                 file. As of Mac OS X 10.3, this file must be in PNG, JPEG,
                 TIFF, PICT, PDF, JPEG 2000, Adobe Photoshop, BMP, .ico, or
                 .icns format. If the image data is in a format Growl doesn't
                 recognize, the notification will still go through, and the
                 icon will be ignored.

                 Icons are not supported by all displays, so this may be
                 ignored anyway.

     -p, --priority priority
                 Sets the priority for the notification to an int or named key
                 (default is 0).

                 Priority is not supported by all displays, so this may be
                 ignored.

     -s, --sticky
                 Causes the notification to stick around until clicked.

                 Sticky notifications are not supported by all displays, so
                 this may be ignored.

     -d, --identifier
                 Sets the identifier for the notification. The identifier is
                 used for coalescing, which means multiple notifications with
                 the same identifer will use a single bubble, the latest noti-
                 fication taking precedence.

                 Coalescing is not supported by all displays, so this may be
                 ignored.

     -w, --wait  Causes growlnotify to wait until the notification is dis-
                 missed (either by clicking or timing out) before it returns.

     -H, --host  Sends the notification to a remote host instead of the local
                 computer.  This option requires the remote host being set up
                 to accept remote notifications.  The argument is the host to
                 send the notification to.

     -P, --password
                 Sets the password to be used for the remote notification.
                 This is necessary if the remote host requires a password for
                 remote notifications.

     -u, --udp   Sends the remote notification with UDP instead of Distributed
                 Objects.

     --port      Sets the port number to use for UDP notifications.

     growlnotify displays a notification using Growl. If -m isn't specified or
     is set to '-', the message is read from stdin.  If you don't redirect
     stdin (e.g. with the shell's | or < operators), growlnotify will be read-
     ing from the terminal, and you will need to send EOF (normally, ctrl-D)
     on an empty line to end the message.

     If -p is used then priority can be an int between -2 and 2 or can be a
     named key in the following list: Very Low, Moderate, Normal, High, Emer-
     gency.

EXAMPLES
           % growlnotify --help

     Displays this help file.

           % growlnotify --appIcon Xcode Build complete
           growlnotify has finished building
           ^D

     Displays a notification telling you that growlnotify has finished build-
     ing.

           growlnotify --appIcon Xcode Build complete -m 'growlnotify has
           finished building'

     The same as the previous one but suitable for embedding in a script (such
     as a Shell Script phase).

SEE ALSO
     stdin(4)

HISTORY
     First appeared as an example for Growl 0.5.

Darwin                           July 9, 2007                           Darwin
Bwana Created by Bruji