Extras

Table of Contents

HardwareGrowler

About

Screenshot of HardwareGrowler.

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

HardwareGrowler 1.3+ is available in the Mac App Store. Click here to view and purchase HardwareGrowler.

Supported device types

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

FAQs:

Does HardwareGrowler affect anything on my computer?

No. All it does is monitor what devices and power sources are attached to your computer and notify you if anything changes.

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

GrowlTunes 1.2.2 is available in the Growl 1.2.2 download in the Extras folder, located on the downloads page.

Once you have installed GrowlTunes, double click it. This will put the headphones shown here 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.

Screenshot of GrowlTunes.

Requirements

  • Mac OS X 10.5 or later
  • iTunes 4.7 or later
  • 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.

growlnotify

About

growlnotify 1.3, for use with Growl 1.3, is available at our general downloads section. GrowlNotify 1.2.2, for Growl 1.2.2, is available in the Growl 1.2.2 download, in the Extras folder.

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.

Please do not use growlnotify in applications. We provide a Software Development Kit for that purpose. Please see the developer page for more information.

Installing

The Installer package for growlnotify is in the growlnotify folder in the Extras folder on the Growl disk image. Simply open the Installer package and follow the on-screen instructions.

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 Release configuration.

Usage

Usage: growlnotify [-hsvuwc] [-i ext] [-I filepath] [--image filepath]
                               [-a appname] [-p priority] [-H host] [-P password]
                               [--port port] [-n name] [-A method] [--progress value]
                               [--html] [-m message] [-t] [title]
            Options:
                -h,--help       Display this help
                -v,--version    Display version number
                -n,--name       Set the name of the application that sends the notification
                                [Default: growlnotify]
                -s,--sticky     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
                -m,--message    Sets the message to be used instead of using stdin
                                Passing - as the argument means read from stdin
                -p,--priority   Specify an int or named key (default is 0)
                -d,--identifier Specify a notification identifier (used for coalescing)
                -H,--host       Specify a hostname to which to send a remote notification.
                -P,--password   Password used for remote notifications.
                -u,--udp        Use UDP instead of DO to send a remote notification.
                   --port       Port number for UDP notifications.
                -A,--auth       Specify digest algorithm for UDP authentication.
                                Either MD5 [Default], SHA256 or NONE.
                -c,--crypt      Encrypt UDP notifications.
                -w,--wait       Wait until the notification has been dismissed.
                   --progress   Set a progress value for this notification.
            
            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 switch is accepted:
                -t,--title      Does nothing. Any text following will be treated as the
                                title because that's the default argument behaviour

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