Desktop::Notify(3pm)					User Contributed Perl Documentation				      Desktop::Notify(3pm)

NAME

       Desktop::Notify - Communicate with the Desktop Notifications framework

VERSION

       Version 0.03

SYNOPSIS

	   use Desktop::Notify;

	   # Open a connection to the notification daemon
	   my $notify = Desktop::Notify->new();

	   # Create a notification to display
	   my $notification = $notify->create(summary => 'Desktop::Notify',
					      body => 'Hello, world!',
					      timeout => 5000);

	   # Display the notification
	   $notification->show();

	   # Close the notification later
	   $notification->close();

DESCRIPTION

       This module provides a Perl interface to the Desktop Notifications framework.

       The framework allows applications to display pop-up notifications on an X desktop.  This is implemented with two components: a daemon that
       displays the notifications, and a client library used by applications to send notifications to the daemon.  These components communicate
       through the DBus message bus protocol.

       More information is available from <http://trac.galago-project.org/wiki/DesktopNotifications>

       This module serves the same purpose as "libnotify", in an object-oriented Perl interface.  It is not, however, an interface to "libnotify"
       itself, but a separate implementation of the specification using Net::DBus.

METHODS

   new %opts
       Connect to the notification daemon. %opts can include the following options:

       app_name
	   The application name to use for notifications. Default is "basename($0)"

       bus The Net::DBus mesage bus to use. Default is to call Net::DBus->session, which is usually where notification-daemon can be reached.

       service
	   The DBus service name of the daemon. Default is org.freedesktop.Notifications.

       objpath
	   The path to the notifications DBus object. Default is /org/freedesktop/Notifications.

       objiface
	   The DBus interface to access the notifications object as. Default is org.freedesktop.Notifications.

   create %params
       Creates a new notification object that can be displayed later. This will return a Desktop::Notify::Notification object; see that module for
       information about using it.

   close_callback $coderef
       Sets a user-specified function to be called whenever a notification is closed.  It will be called with one argument, which is the
       Notification object that was just closed.

AUTHOR

       Stephen Cavilia, "<sac at atomicradi.us>"

SEE ALSO

       Net::DBus

       <http://www.galago-project.org/specs/notification/index.php>

       <http://www.galago-project.org/downloads.php>

BUGS

       Please report any bugs or feature requests to "bug-desktop-notify at rt.cpan.org", or through the web interface at
       <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Desktop-Notify>.  I will be notified, and then you'll automatically be notified of progress
       on your bug as I make changes.

SUPPORT

       You can find documentation for this module with the perldoc command.

	   perldoc Desktop::Notify

       You can also look for information at:

       o   AnnoCPAN: Annotated CPAN documentation

	   <http://annocpan.org/dist/Desktop-Notify>

       o   CPAN Ratings

	   <http://cpanratings.perl.org/d/Desktop-Notify>

       o   RT: CPAN's request tracker

	   <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Desktop-Notify>

       o   Search CPAN

	   <http://search.cpan.org/dist/Desktop-Notify>

ACKNOWLEDGEMENTS

COPYRIGHT &; LICENSE
       Copyright 2007 Stephen Cavilia, all rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.10.1							    2009-12-24						      Desktop::Notify(3pm)