PHPackages                             f1ll0y/php-os-gui-notify - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. f1ll0y/php-os-gui-notify

ActiveLibrary[Mail & Notifications](/categories/mail)

f1ll0y/php-os-gui-notify
========================

Send desktop os notifications on Windows, Linux, MacOS.

3.0.0(2y ago)05MITPHPPHP >=8.1

Since Feb 1Pushed 2y agoCompare

[ Source](https://github.com/F1ll0y/php-os-gui-notify)[ Packagist](https://packagist.org/packages/f1ll0y/php-os-gui-notify)[ RSS](/packages/f1ll0y-php-os-gui-notify/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

About JoliNotif
===============

[](#about-jolinotif)

forked from [jolicode/JoliNotif](https://github.com/jolicode/JoliNotif)

 [![JoliNotif demo](doc/images/demo.gif)](doc/images/demo.gif)

 [![Total Downloads](https://camo.githubusercontent.com/1d5c54888511a40909705009bc639eae009cef8668b148f5b3cd7b1322cb8ae1/68747470733a2f2f706f7365722e707567782e6f72672f6a6f6c69636f64652f6a6f6c696e6f7469662f646f776e6c6f616473)](https://packagist.org/packages/jolicode/jolinotif) [![Latest Stable Version](https://camo.githubusercontent.com/f01b4d8e3980a20356bbf7e91cce343b041d534de631c73115bcdfc8f0c999c0/68747470733a2f2f706f7365722e707567782e6f72672f6a6f6c69636f64652f6a6f6c696e6f7469662f762f737461626c65)](https://packagist.org/packages/jolicode/jolinotif) [![Latest Unstable Version](https://camo.githubusercontent.com/d35d41ae33c8ea341da3763583cc85155b5b2c7a0cb73b5c7f68d662f2a69499/68747470733a2f2f706f7365722e707567782e6f72672f6a6f6c69636f64652f6a6f6c696e6f7469662f762f756e737461626c65)](https://packagist.org/packages/jolicode/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](doc/04-cron-usage.md)

Installation
------------

[](#installation)

Use [Composer](http://getcomposer.org/) to install JoliNotif in your project:

```
composer require "jolicode/jolinotif"
```

Usage
-----

[](#usage)

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')
    ->setIcon(__DIR__.'/path/to/your/icon.png')
    ->addOption('subtitle', 'This is a subtitle') // Only works on macOS (AppleScriptNotifier)
    ->addOption('sound', 'Frog') // Only works on macOS (AppleScriptNotifier)
;

// Send it
$notifier->send($notification);
```

A [shell executable](doc/05-cli-usage.md) is also provided to use JoliNotif from CLI:

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

Further documentation
---------------------

[](#further-documentation)

Discover more by reading the docs:

- [Basic usage](doc/01-basic-usage.md)
- [Notification](doc/02-notification.md)
- [Notifier](doc/03-notifier.md)
- [CRON usage](doc/04-cron-usage.md)
- [CLI usage](doc/05-cli-usage.md)

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

- the `git tag` command
- the [releases page on Github](https://github.com/jolicode/JoliNotif/releases)
- the file listing the [changes between versions](CHANGELOG.md)

And finally some meta documentation:

- [versioning and branching models](VERSIONING.md)
- [contribution instructions](CONTRIBUTING.md)

Credits
-------

[](#credits)

- [All contributors](https://github.com/jolicode/JoliNotif/graphs/contributors)
- This project was originally inspired by [mikaelbr/node-notifier](https://github.com/mikaelbr/node-notifier)

License
-------

[](#license)

JoliNotif is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 79.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

829d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ac1d28cb921e9a277ce445639e984a8dfbc7b8f050a8ab132f34d54f3ff69fb1?d=identicon)[F1ll0y](/maintainers/F1ll0y)

---

Top Contributors

[![pyrech](https://avatars.githubusercontent.com/u/2021641?v=4)](https://github.com/pyrech "pyrech (181 commits)")[![lyrixx](https://avatars.githubusercontent.com/u/408368?v=4)](https://github.com/lyrixx "lyrixx (23 commits)")[![tamtamchik](https://avatars.githubusercontent.com/u/265510?v=4)](https://github.com/tamtamchik "tamtamchik (6 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (2 commits)")[![matthieumota](https://avatars.githubusercontent.com/u/2427947?v=4)](https://github.com/matthieumota "matthieumota (2 commits)")[![nunomaduro](https://avatars.githubusercontent.com/u/5457236?v=4)](https://github.com/nunomaduro "nunomaduro (2 commits)")[![pborreli](https://avatars.githubusercontent.com/u/77759?v=4)](https://github.com/pborreli "pborreli (2 commits)")[![javiereguiluz](https://avatars.githubusercontent.com/u/73419?v=4)](https://github.com/javiereguiluz "javiereguiluz (1 commits)")[![raphael-da-silva](https://avatars.githubusercontent.com/u/53321603?v=4)](https://github.com/raphael-da-silva "raphael-da-silva (1 commits)")[![F1ll0y](https://avatars.githubusercontent.com/u/5658745?v=4)](https://github.com/F1ll0y "F1ll0y (1 commits)")[![paulmallet](https://avatars.githubusercontent.com/u/426515?v=4)](https://github.com/paulmallet "paulmallet (1 commits)")[![xavierlacot](https://avatars.githubusercontent.com/u/177293?v=4)](https://github.com/xavierlacot "xavierlacot (1 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![gremo](https://avatars.githubusercontent.com/u/1532616?v=4)](https://github.com/gremo "gremo (1 commits)")[![jeremyFreeAgent](https://avatars.githubusercontent.com/u/176363?v=4)](https://github.com/jeremyFreeAgent "jeremyFreeAgent (1 commits)")[![julienbourdeau](https://avatars.githubusercontent.com/u/1525636?v=4)](https://github.com/julienbourdeau "julienbourdeau (1 commits)")[![kamilsk](https://avatars.githubusercontent.com/u/1165416?v=4)](https://github.com/kamilsk "kamilsk (1 commits)")

---

Tags

notificationlinuxwindowsgrowlMAC

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/f1ll0y-php-os-gui-notify/health.svg)

```
[![Health](https://phpackages.com/badges/f1ll0y-php-os-gui-notify/health.svg)](https://phpackages.com/packages/f1ll0y-php-os-gui-notify)
```

###  Alternatives

[jolicode/jolinotif

Send desktop notifications on Windows, Linux, MacOS.

1.4k11.6M41](/packages/jolicode-jolinotif)[mouse0270/bootstrap-growl

This is a simple pluging that turns standard Bootstrap alerts into "Growl-like" notifications.

2.2k119.1k](/packages/mouse0270-bootstrap-growl)[sly/notification-pusher

Standalone PHP library for easy devices notifications push.

1.2k2.8M15](/packages/sly-notification-pusher)[symfony/notifier

Sends notifications via one or more channels (email, SMS, ...)

80640.3M290](/packages/symfony-notifier)[kartik-v/yii2-widget-growl

A widget to generate growl based notifications using bootstrap-growl plugin (sub repo split from yii2-widgets)

384.2M14](/packages/kartik-v-yii2-widget-growl)[loveorigami/yii2-notification-wrapper

This module for renders a message from session flash (with ajax, pjax support and etc.)

77199.7k5](/packages/loveorigami-yii2-notification-wrapper)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)