DOWNLOAD
Download growlnotify command line script
NAME
growlnotify -- Send a Growl notification to a local or remote host
SYNOPSIS
growlnotify [/t:title] [/id:id] [/s:sticky] [/p:priority] [/i:icon]
[/a:application] [/ai:appicon] [/r:types] [/n:type]
[/cu:callbackurl]
[/host:host] [/port:port]
[/pass:password] [/enc:algorithm] [/hash:algorithm]
[/silent:suppressoutput]
messagetext
DESCRIPTION
Only messagetext is required. All other switches will use default values.
/t:title The notification title.
Use \n to specify a line break. Use \\n for a literal '\n'.
Default: "growlnotify"
/id:id The notification id.
Default: ""
/s:sticky Indicates if the notification should be sticky.
Valid values: true|false
Default: false
/p:priority The notification priority.
Valid values: -2|-1|0|1|2
Default: 0
/i:icon The icon to show for the notification.
Must be a valid file type (png, jpg, gif, ico).
Can be any of the following:
- absolute url (http://domain/image.png)
- absolute file path (c:\temp\image.png)
- relative file path (.\folder\image.png) (relative file paths
must start with a dot (.) and are relative to growlnotify's
location
Note: Icons specified as urls will be passed as urls (links). Icons
specified as local files (either absolute or relative) will be
sent as binary data.
Default: no icon
/a:application The name of the application sending the notification.
The application must already be registered unless the
/r switch is included. The default 'growlnotify'
application does not need to be explicitly registered.
Default: growlnotify
/ai:appicon The icon of the application being registered.
Only applicable if the /r switch is also passed.
Must be a valid file type (png, jpg, gif, ico).
Can be any of the following:
- absolute url (http://domain/image.png)
- absolute file path (c:\temp\image.png)
- relative file path (.\folder\image.png) (relative file paths
must start with a dot (.) and are relative to growlnotify's
location
Note: Icons specified as urls will be passed as urls (links). Icons
specified as local files (either absolute or relative) will be
sent as binary data.
Default: no icon
/r:types Register the application first.
'types' is a comma-separated list of the notification types to register.
Default: application not automatically registered
Examples:
/r:"Some Notification"
/r:"Notification One","Notification Two","Notification Three"
/n:type The notification name/type.
Default: "General Notification"
/cu:callbackurl A callback url (will be opened if the notification is clicked).
Default: no callback
/host:host The host address to send the notification to.
If any value other than 'localhost' or '127.0.0.1' is provided, the
host is considered a remote host and the /pass switch must also be provided.
Default: localhost
/port:port The port to send the notification to.
Default: 23053
/pass:password The password required to send notifications.
A password is required to send a request to a remote host. If /host
is specified and is any value other than 'localhost' or '127.0.0.1',
then /pass is also required.
Default: no password
/enc:algorithm The encryption algorithm to use.
Valid values: NONE|DES|3DES|AES
If a value other than NONE is provided, the
/pass and /hash switches must also be included.
Default: NONE
/hash:algorithm The hashing algorithm to use.
Valid values: MD5|SHA1|SHA256|SHA512
This value is only used if the /pass switch is also
set.
Default: MD5
/silent:nooutput When run from the command line, indicates if response output
should be suppressed or not.
Valid values: true|false
Default: false
messagetext The notification's text - Required
Use \n to specify a line break. Use \\n for a literal '\n'.
EXAMPLES
Example using all switches:
growlnotify /t:"my notification" /id:12345 /s:true /p:2 /i:"c:\apple.png" /a:"growlnotify example" /ai:"c:\myapp.png" /r:"Example Notification","Another Type of Notification" /n:"Example Notification" /cu:"http://www.google.com" /host:localhost /port:23053 /pass:"secret" /enc:DES /hash:SHA256 /silent:true "this is the notification text\n\nit includes some line breaks"
NOTES
There are two ways to use growlnotify.
1. growlnotify.com - Can be used from the console or included in batch scripts. Writes
success/failure messages to the console when the notification is
sent. Equivalent to using just 'growlnotify' with no extension.
2. growlnotify.exe - Can be used with tools like AutoHotkey or launched from other GUI
applications. Will not spawn a console window, so notifications can
be sent silently. No success or failure report is available. Must
explicitly include the .exe extension in order for Windows to
recognize which version to use.
DEPENDENCIES
growlnotify is included with Growl for Windows. If you want to run growlnotify on a machine
that does not have Growl for Windows installed, please note that growlnotify requires the
Microsoft .NET Framework (v2.0 or higher).
