Growl Plugin

The Growl Plugin for Indigo allows you to send growl messages via a plugin action in the Actions UI tab. Before you try to use this plugin you need to install Growl.

Note: Version 1.0.5 and later of this plugin supports both Growl 1.2 and 1.3. However, you must select the correct version in the plugin preferences because the Growl API is specific to the version being used.

Notification Types

The Growl Plugin creates 8 “notifications”, which show up in the Growl preference pane. You can customize each of these notification types as desired in Growl. You can also change the names (and remove them entirely if desired) via the plugin's preferences:

By leaving any of the notifications blank, you can remove that notification type. It won't show up in the action config dialog or in Growl as a notification type.

Notification Action

When you're ready to send a notification, you just add a “Notification” action and adjust it's options via the action config dialog:

There are 5 fields for each notify action described below

  1. Type - this specifies the notification type (see above to configure those)
  2. Title† - this is the title of the notification - typically shown at the top of the notification window
  3. Description† - this is the description of the notification, typically shown in the main content area of the notification
  4. Priority - that's the Growl-defined priority (not used by most Growl themes)
  5. Sticky - that indicates whether the notification will require the user to manually close it or if Growl will close it automatically after some period of time

† - the title and description fields may contain substitution markup. So, as you can see from the example above, we're substituting the value of variable ID 867446802 in the title and variable ID 264884531 in the description. See Substitutions for more information.

Scripting Support

As with all plugins, actions defined by this plugin may be executed by Python scripts. Here's the information you need to script the actions in this plugin.

Plugin ID: com.perceptiveautomation.indigoplugin.Airfoil

Action specific properties

Notify

Action id: notify

Properties for scripting:

type the string key of the notification type, must be one of: 'notification1', 'notification2', 'notification3', 'notification4', 'notification5', 'notification6', 'notification7', 'notification7' and must be enabled in the preferences (see preferences above)
title the title of the growl notification
descString the full text of the notification
priority the optional number priority for the notification: -2 (very low) through 2 (emergency) - defaults to 0 (normal priority)
sticky optional boolean that will cause the notification to stick (not automatically disappear) - defaults to False

Example:

growlPlugin = indigo.server.getPlugin("com.perceptiveautomation.indigoplugin.growl")
if growlPlugin.isEnabled():
	growlPlugin.executeAction("notify", props={'type':"notification1", 'title':"Growl Title", 'descString':"Description of Growl Notification", 'priority':0, 'sticky':False})

Support and Troubleshooting

For usage or troubleshooting tips discuss this plugin on our forum.

indigo_7_documentation/plugins/growl_1.txt · Last modified: 2017/01/18 17:30 by jay
 

© Perceptive Automation, LLC. · Privacy