A toolbox in Java to send notifications (Growl, Snarl, Notification Center, notify-send, etc)
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
etc
send-notification-cli [maven-release-plugin] prepare for next development iteration Oct 28, 2018
send-notification [maven-release-plugin] prepare for next development iteration Oct 28, 2018
.editorconfig
.gitignore Build a windows box to test notifiers using Vagrant Dec 6, 2014
.travis.yml
CHANGELOG.md
LICENSE
README.md
azure-pipelines.yml
pom.xml

README.md

send-notification

A toolbox in Java to send notifications.

Usage

Add dependency with your favorite build tool.

Example with Maven:

    <dependencies>
     [...]
        <dependency>
            <groupId>fr.jcgay.send-notification</groupId>
            <artifactId>send-notification</artifactId>
            <version>0.15.0</version>
        </dependency>
     [...]
    </dependencies>

Get a notifier:

    Notifier notifier = new SendNotification()
        .setApplication(application)
        .initNotifier();

The application is not mandatory, you'll get a default one if it's not set.

Then send notification:

    try {
        notifier.send(notification);
    } finally {
        notifier.close;
    }

CLI

Download bundle, extract it, add the bin directory to your $PATH.
For OS X users, you can use a brew formula here.

> send-notification -h

Usage: <main class> [options] notifier(s)
  Options:
    -h, --help
       show help
       Default: false
  * -i, --icon
       notification icon
    -l, --level
       notification level (INFO, WARNING, ERROR)
  * -m, --message
       notification message
    -s, --subtitle
       notification subtitle
  * -t, --title
       notification title
    -v, --version
       show version
       Default: false

(*) are mandatory parameters.

Example:

send-notification notifysend -m "Build success !" -t "maven-notifier" -i "success.png"

Available notifiers

Go to Wiki to read full configuration guide for each notifier.

Notifier Screenshot
Growl, for Windows and OS X. Growl
Snarl, for Windows Snarl
terminal-notifier, OS X terminal-notifier
notification center OS X (since Mavericks) notification-center
notify-send for Linux notify-send
SystemTray since Java 6 System Tray
Pushbullet pushbullet
Kdialog for KDE Kdialog
notifu for Windows notifu
AnyBar for OS X and Linux anybar
Toaster for Windows 8 toaster
Notify since Java 6 Notify
BurntToast for Windows 10 BurntToast
Slack Slack

Build status

Build Status Coverage Status Quality Gate

Release

mvn -B release:prepare release:perform