GNTP

This is a Python library for working with the

Growl Notification
Transport Protocol 

It should work as a dropin replacement for the older Python bindings

Installation

You can install with pip

::

$ pip install gntp

then test the module

::

$ python -m gntp.notifier

Simple Usage

::

# GNTP uses the standard Python logging
import logging
logging.basicConfig(level=logging.INFO)

import gntp.notifier
Simple "fire and forget" notification
gntp.notifier.mini("Here's a quick message")
More complete example
growl = gntp.notifier.GrowlNotifier(
    applicationName = "My Application Name",
    notifications = ["New Updates","New Messages"],
    defaultNotifications = ["New Messages"],
    # hostname = "computer.example.com", # Defaults to localhost
    # password = "abc123" # Defaults to a blank password
)
growl.register()
Send one message
growl.notify(
    noteType = "New Messages",
    title = "You have a new message",
    description = "A longer message description",
    icon = "http://example.com/icon.png",
    sticky = False,
    priority = 1,
)
Try to send a different type of message
This one may fail since it is not in our list
of defaultNotifications
growl.notify(
    noteType = "New Updates",
    title = "There is a new update to download",
    description = "A longer message description",
    icon = "http://example.com/icon.png",
    sticky = False,
    priority = -1,
)

URL based images do not work in the OSX version of

growl 

::

image = open('/path/to/image.png', 'rb').read()
growl.notify(
    noteType = "New Messages",
    title = "You have a new message",
    description = "This time we embed the image",
    icon = image,
)

.. note:: With Growl 2 and above user can choose to pass notification to system wide notifications center. In this case

icon

Bugs

GitHub issue tracker 

Changelog

v1.0.3 

v1.0.2 

v1.0.1 

v1.0 

v0.9 

v0.8 

v0.7 

0.6