Net_Growl logo

2012-03-07: Net_Growl 2.5.2 Released

Release highlights:

  • Prevent bad icon display with new default version v2 (encoding changed)

Read the CHANGELOG for a full list of all additions, changes and bug fixes. Changes are documented in the updated User Guide. See the Installation page for downloads and installation instructions.

Laurent Laville

1. Introduction

Until now there were many UDP PHP implementations, but none for the new Growl Notification Transport Protocol (GNTP) - v1.0

I’ve decided to enlarge work begun by Bertrand Mansion with the PEAR::Net_Growl package (v 0.7.0).

While you can find some old compatible PHP4 versions (0.8.0b1, 0.9.0b1, 0.9.0b2), I’ve decided, with final stable version 2.0.0, to drop support of PHP4.

I’m focus now on a unique PHP5 library that includes all features of GNTP 1.0

2. Overview

Net_Growl provides :

Ability to use both protocol UDP and GNTP

UDP is limited to some features :

  • Application and notification icons are not provided by PHP scripts.

  • Callbacks are not supported.

GNTP is better than UDP :

  • Application and notification icons may be provided by PHP scripts.

  • Callbacks may be supported. (not yet with Net_Growl beta1)

  • Different Hash and Encryption backend : MD5, SHA1 (for version 0.9.0b1) plus SHA256 and SHA512 (for version 2.0.0b1)

Ability to log messages sent and received to Growl

Log framework used with version 0.9.0b1 is PEAR::Log package. While versions since 2.0.0b1 uses no particular log framework (basic text file I/O).

Ability to auto register before sending notification

Both versions may send notifications without to call the Net_Growl::register() function. Net_Growl will do it for you at first notification.

Ability to display default Growl Logo

If Application and Notification icons are invalid or not reachable, Net_Growl display the default Growl Logo.

Mac Growl icon

See Net_Growl::getDefaultGrowlIcon() function.

Since version 2.5.0, you may also display previous claw icon

Growl icon

With Net_Growl::getDefaultGrowlIcon(false, "1")

3. Download

The Net_Growl manual is available in a selection of formats. Pick a format from the table below to start downloading.

Language Single HTML file Many HTML files HTML Help file PDF file EPUB file

English

netgrowl-book.html.zip 264Kb

netgrowl-book.chunked.zip 189Kb

netgrowl-book.chm.zip 196Kb

netgrowl-book.pdf 306Kb

netgrowl-book.epub.zip 166Kb

4. Appendix A: Classes Source Code

Below you can find highlighted PHP source code (with Pygments) of Net_Growl classes version 2.5.2

5. Appendix B: Examples

UDP usage
GNTP usage

6. Appendix C: Changelog

History of changes

7. Appendix D: License

Released under the BSD license, you are free to do whatever you want, even in a commercial environment. You are also encouraged to contribute.

8. Appendix E: Credits

I would like to thanks here specially two guys without who this PHP version won’t be born.

Bertrand Mansion

Original author of PEAR::Net_Growl, that gave me hope to use one day the package on Windows platform.

http://www.mamasam.com/
Brian Dunnington

Author of Growl for Windows, that make the dream a reality for all Windows users. He also help me a lot to finalize the authorization part and encryption messages.

http://www.growlforwindows.com/gfw/

And of course, a special thanks to

Growl Team

http://growl.info/ without who, this adventure wouldn’t be true.

http://growl.info/

9. Appendix F: Links

All pages of this site, and user guide were generated with AsciiDoc 8.6.6, assisted by FOP 1.0 (for PDFs). Automated build process uses Phing 2.4.9

Convert the HTML Help source (.hhp and .html) files to HTML Help (.chm) files using the Microsoft HTML Help Compiler.