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 <https://github.com/bentglasstube/Net-Snarl/issues> 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, "<alan@eatabrick.org>" 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.