Get Growl notifications from OctoPrint
Python JavaScript CSS
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Growl plugin for OctoPrint

Growl plugin: Settings dialog with discovered local Growl instances

Growl plugin: Example notification

The Growl plugin for OctoPrint allows to send notifications about certain printing events to a Growl instance on your local network. Right now it sends notifications for the following events:

  • Printjob started
  • Printjob done
  • File uploaded (optional)
  • Timelapse done (optional)

Please note that it's a work in progress.


Install the plugin like you would install any regular Python package from source:

pip install

Make sure you use the same Python environment that you installed OctoPrint under, otherwise the plugin won't be able to satisfy its dependencies.

Restart OctoPrint. octoprint.log should show you that the plugin was successfully found and loaded:

2014-09-18 17:49:21,500 - octoprint.plugin.core - INFO - Loading plugins from ... and installed plugin packages...
2014-09-18 17:49:21,611 - octoprint.plugin.core - INFO - Found 2 plugin(s): Growl (0.1.0), Discovery (0.1)


You'll have to configure the host your Growl service is running on (which is probably not the same machine that your OctoPrint installation is running on), the port it is listening on and - if you secured your growl instance against notifications from the network with a password - also the password needed to connect to it.

You can do all this via the settings dialog under "Plugins > Growl". If you have your OctoPrint installation's bundled discovery plugin also configured with pybonjour support you'll also be able to see all the Growl instances on your local network that OctoPrint was able to discover there.

By default only the notifications for "Printjob started" and "Printjob done" are enabled. If you also want to get notification about the other events, you'll have to tell Growl. OctoPrint will send them all, but your local Growl instance needs to be told to also display them. You can do this in the configuration of your Growl service. For example, this is how it looks in Growl for Windows:

Growl Plugin: Example of granular notification configuration in Growl for Windows