Desktop::Notify (3pm)

Version 0.03

    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();

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 \*(C`libnotify\*(C', in an object-oriented Perl interface. It is not, however, an interface to \*(C`libnotify\*(C' itself, but a separate implementation of the specification using Net::DBus.

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

app_name

The application name to use for notifications. Default is \*(C`basename($0)\*(C'

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. 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. 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.

Stephen Cavilia, \*(C`<sac at atomicradi.us>\*(C'

Net::DBus

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

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

Please report any bugs or feature requests to \*(C`bug-desktop-notify at rt.cpan.org\*(C', 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.

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

perldoc Desktop::Notify

You can also look for information at:

• AnnoCPAN: Annotated \s-1CPAN\s0 documentation <http://annocpan.org/dist/Desktop-Notify>

• \s-1CPAN\s0 Ratings <http://cpanratings.perl.org/d/Desktop-Notify>

• \s-1RT:\s0 \s-1CPAN\s0's request tracker <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Desktop-Notify>

• Search \s-1CPAN\s0 <http://search.cpan.org/dist/Desktop-Notify>

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.