NAME Net::Snarl - Snarl network protocol SYNOPSIS use Net::Snarl; # connect to localhost and register Net::Snarl application my $snarl = Net::Snarl->register('Net::Snarl'); $snarl->add_class('Test'); # add Test notification class $snarl->notify('Test', 'Hello', 'World', 5); # show hello world for 5 seconds DESCRIPTION A simple interface to send Snarl notifications across the network. Snarl must be running on the target machine. INTERFACE register($application, $host, $port) Connects to Snarl and register an application. Host defaults to localhost and port defaults to $Net::Snarl::SNARL_PORT. add_class($class, $title) Registers a notification class with your application. Title is the optional friendly name for the class. notify($class, $title, $text, $timeout, $icon) Displays a notification of the specified class. Timeout defaults to 0 (sticky) and icon defaults to nothing. BUGS Please report and bugs or feature requests on GitHub TODO Later versions of Snarl report interactions with the notifications back to the socket. Currently these are stored in a private queue. Eventually, I will expose an interface for triggering callbacks on these events but that will most likely require threading so I'm a little reluctant to implement it. AUTHOR Alan Berndt, "" LICENSE AND COPYRIGHT Copyright 2013 Alan Berndt. This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See http://dev.perl.org/licenses/ for more information.