DS-Desktop-Notify

A lightweight library that you can embed in your Java-powered desktop apps to display floating notifications on the desktop.

Under development, this library allows to show small and stylish notifications on the Desktop. As the developer, all you need is to add this tiny .jar to your classpath and invoke a single static method to create and display a new notification. Something as simple as the following:

DesktopNotify.showDesktopMessage(
    "This is a notification",
    "With DS Desktop Notify, displaying notifications on the screen is quick and easy!",
    DesktopNotify.SUCCESS);

You can customize your notification to make it show what you want. You can customize its looks with a title, a message, an icon (or use a default one) and even the fonts and colors, picking one of the provided themes or creating one of your own. Behavior can also be customized with a given time before the notification expires (it can be infinite too, so only a click will make it go away), and an action event on click. You don't need to worry about the bounds nor where you should break lines (as in JOptionPane), because all of this is automatically measured before showing your notification.

You can also read the wiki for more instructions on how to use this library.

So, no matter what your application is about, if you need to show pop-up notifications on the Desktop in any moment, you can use this library to deal with that.

Features

• Lightweight and easy to use.
• Create and show your notification with a single code line!
• The notifications can be closed by mouse clicking, or have an specific time on screen.
• They can wait on queue if there's no room to show them all.
• Action events for each notification.
• Notifications can be posted from external processes via command line.
• They won't mess with the taskbar in Windows PCs!
• It leaves no traces: the service thread automatically stops when there are no more notifications to show. It is also started again when new notifications arrive.

Requirements

• Windows XP/Vista/7/8/10, Linux, Mac-OS X
• Java Runtime Environment 6 or higher
• Translucent windows support in AWT/Swing is recommended for best results (Java 7 or higher is needed for this).

Being developed

• Notification engine rewrite for a future 1.0 release.
• Transitions and more customizable options for the notification area.
• Image thumbnails and multiple actions per notification.
• Performance improvements and better refresh rate adaptability.

Do you want to use this in a production environment?

It has come to my attention that there's been some enterprise and educational projects that have included DS Desktop Notify as one of their dependencies. This is why I have deployed an official javadoc.

If you are interested in using DS Desktop Notify and need some help/guidance with it, want to request a feature you need or submit a bug, you can send an e-mail to the.drag.shot@gmail.com with a subject starting with [Desktop Notify], or open an issue here on GitHub.