Net_Growl logo

Three months after first release candidate, I’m proud to announce

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.

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

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.

Growl icon

See Net_Growl::getDefaultGrowlIcon() function.

Downloads

Documentation

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

English

zip 285 Kb

n/a

chm 197 Kb

n/a
Complete Source Code

  • Recommended Download

Release Size (kb) Date

2.0.0

310

24-January-2010

  • Other Available Downloads

Release Size (kb) Date

2.0.0RC1

104

8-October-2009

2.0.0b2

16

7-August-2009

2.0.0b1

15

29-July-2009

Appendix A: Classes Source Code

Below you can find highlighted PHP5 source code (with GNU Source-highlight) of Net_Growl classes version 2.0.0

Appendix B: Examples

UDP usage
GNTP usage

Appendix C: Changelog

History of changes

Appendix D: License

BSD

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/

Appendix F: Links

All pages of this site, and user guide were generated with AsciiDoc 8.5.3, assisted by XSLT and dblatex (for PDFs).

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