GNTP (Growl)


GNTP is a specification for sending and receiving notifications between computers. The most well known server implementations are Growl for Mac and Growl for Windows.

To use GNTP notifications, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  - name: NOTIFER_NAME
    platform: gntp

GNTP will attempt to connect to a local server running on port 23053 if no hostname is provided.

Configuration Variables

name

(string)(Optional)Setting the optional parameter name allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME.

Default value: notify

app_name

(string)(Optional)The application name that will be displayed on every notification and will be registered with the server.

Default value: HomeAssistant

app_icon

(string)(Optional)The icon that will be displayed on every notification. You can provide an HTTP URL or a file:// URL. File URLs only work if Home Assistant and the GNTP server are running on the same machine. If no app_icon is set a local copy of the Home Assistant logo will be used. If you choose to use an HTTP URL please make the maximum image size 150 px by 150 px as Growl for Mac will sometimes timeout when registering.

hostname

(string)(Optional)The hostname or IP address of the GNTP server to contact.

Default value: localhost

password

(string)(Optional)The password to authenticate to the GNTP server with.

port

(integer)(Optional)The port that the GNTP server runs on. The specification states that servers should not allow users to use any port other than 23053 but port is provided here just in case.

Default value: 23053

To use notifications, please see the getting started with automation page.