Send desktop notifications on Windows, Linux, MacOS.

Fund package maintenance!

Installs: 4 034 181

Dependents: 38

Suggesters: 1

Security: 0

Stars: 1 261

Watchers: 47

Forks: 83

Open Issues: 0

v2.5.2 2023-05-24 18:53 UTC

This package is auto-updated.

Last update: 2023-05-31 14:32:00 UTC


JoliNotif demo

Total Downloads Latest Stable Version Latest Unstable Version

About JoliNotif

JoliNotif is a cross-platform PHP library to display desktop notifications. It works on Linux, Windows or MacOS.

Requires PHP >= 7.4 (support for PHP 5 was available in version 1.x, for PHP 7.0 and 7.1 in version < 2.1.0, for PHP 7.2 and 7.3 in version < 2.4.0).

Note This library can not be used in a web context (FPM or equivalent). Use it in your CLI scripts or in a CRON


Use Composer to install JoliNotif in your project:

composer require "jolicode/jolinotif"


Use the NotifierFactory to create the correct Notifier (adapted to your OS), then use it to send your notification:

include __DIR__.'/vendor/autoload.php';

use Joli\JoliNotif\Notification;
use Joli\JoliNotif\NotifierFactory;

// Create a Notifier
$notifier = NotifierFactory::create();

// Create your notification
$notification =
    (new Notification())
    ->setTitle('Notification title')
    ->setBody('This is the body of your notification')
    ->addOption('subtitle', 'This is a subtitle') // Only works on macOS (AppleScriptNotifier)
    ->addOption('sound', 'Frog') // Only works on macOS (AppleScriptNotifier)

// Send it

A shell executable is also provided to use JoliNotif from CLI:

jolinotif --title "Hello" --body "World"

Further documentation

Discover more by reading the docs:

You can see the current and past versions using one of the following:

And finally some meta documentation:



JoliNotif is licensed under the MIT License - see the LICENSE file for details.