PHPackages jolicode/jolinotif - 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. jolicode/jolinotif ActiveLibrary[Mail & Notifications](/categories/mail) jolicode/jolinotif ================== Send desktop notifications on Windows, Linux, MacOS. v3.3.0(5mo ago)1.4k11.6M—4.3%99[1 issues](https://github.com/jolicode/JoliNotif/issues)20MITPHPPHP >=8.3CI passing Since Mar 20Pushed 3mo ago45 watchersCompare [ Source](https://github.com/jolicode/JoliNotif)[ Packagist](https://packagist.org/packages/jolicode/jolinotif)[ Fund](https://tidelift.com/funding/github/packagist/jolicode/jolinotif)[ RSS](/packages/jolicode-jolinotif/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (7)Versions (33)Used By (20) [![JoliNotif](https://camo.githubusercontent.com/85c037fd37bfa043e6b55352b4392ef2e6d6c7151ed67dd19a1a764737baed5f/68747470733a2f2f6a6f6c69636f64652e636f6d2f6d656469612f6f726967696e616c2f6f73732f686561646572732f6a6f6c696e6f7469662e706e67)](https://github.com/jolicode/JoliNotif) JoliNotif *###### Display desktop notifications from your PHP scripts.* =================================================================================================================================================================================================================================================================================================================================================================== [](#------jolinotif----display-desktop-notifications-from-your-php-scripts) [![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 (WSL included) or macOS. [![JoliNotif demo](doc/images/demo.gif)](doc/images/demo.gif) Requires PHP >= 8.2 (support for previous PHP versions was available in older releases of this library). 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) ``` include __DIR__.'/vendor/autoload.php'; use Joli\JoliNotif\Notification; use Joli\JoliNotif\DefaultNotifier; $notifier = new DefaultNotifier(); // 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 (AppleScriptDriver) ->addOption('sound', 'Frog') // Only works on macOS (AppleScriptDriver & TerminalNotifierDriver) ; // 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) - [Drivers](doc/03-drivers.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. [![JoliCode is sponsoring this project](https://camo.githubusercontent.com/5dd64f06b500f261fcaac4e3594ca2d4efa01177f217c45a88835dc62140aaa2/68747470733a2f2f6a6f6c69636f64652e636f6d2f6d656469612f6f726967696e616c2f6f73732f666f6f7465722d6769746875622e706e673f7633)](https://jolicode.com/) ### Health Score 74 — ExcellentBetter than 100% of packages Maintenance76 Regular maintenance activity Popularity71 Solid adoption and visibility Community48 Growing community involvement Maturity89 Battle-tested with a long release history Bus Factor1 Top contributor holds 74.6% 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 Every ~130 days Recently: every ~107 days Total 31 Last Release 166d ago Major Versions v1.3.0 → v2.0.02018-02-12 v2.7.3 → v3.0.02024-10-02 PHP version history (7 changes)v1.0PHP >=5.4.0 v2.0.0PHP >=7.0 v2.4.0PHP >=7.4 v2.5.0PHP >=8.0 v2.6.0PHP >=8.1 v3.1.0PHP >=8.2 v3.3.0PHP >=8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/c177e9f7e88fba40b24b047954fe1ff793d48c2bd8bb12bb2e412aa9ea633ede?d=identicon)[pyrech](/maintainers/pyrech) ![](https://www.gravatar.com/avatar/ebbe48a3e30540f24739602c197ad1212aeb81af96077aed5eb2a300267306bd?d=identicon)[damienalexandre](/maintainers/damienalexandre) ![](https://www.gravatar.com/avatar/c6547f10fb51d1e84f1d5371fb44ee3593c7791432471f0b0adabfb29a18c507?d=identicon)[xavierlacot](/maintainers/xavierlacot) --- Top Contributors [![pyrech](https://avatars.githubusercontent.com/u/2021641?v=4)](https://github.com/pyrech "pyrech (235 commits)")[![lyrixx](https://avatars.githubusercontent.com/u/408368?v=4)](https://github.com/lyrixx "lyrixx (39 commits)")[![tamtamchik](https://avatars.githubusercontent.com/u/265510?v=4)](https://github.com/tamtamchik "tamtamchik (6 commits)")[![shadoWalker89](https://avatars.githubusercontent.com/u/1449151?v=4)](https://github.com/shadoWalker89 "shadoWalker89 (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![adveris-aadam](https://avatars.githubusercontent.com/u/138238953?v=4)](https://github.com/adveris-aadam "adveris-aadam (3 commits)")[![matthieumota](https://avatars.githubusercontent.com/u/2427947?v=4)](https://github.com/matthieumota "matthieumota (2 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (2 commits)")[![pborreli](https://avatars.githubusercontent.com/u/77759?v=4)](https://github.com/pborreli "pborreli (2 commits)")[![alexandre-daubois](https://avatars.githubusercontent.com/u/2144837?v=4)](https://github.com/alexandre-daubois "alexandre-daubois (2 commits)")[![nunomaduro](https://avatars.githubusercontent.com/u/5457236?v=4)](https://github.com/nunomaduro "nunomaduro (2 commits)")[![morawskim](https://avatars.githubusercontent.com/u/1105278?v=4)](https://github.com/morawskim "morawskim (2 commits)")[![TheoD02](https://avatars.githubusercontent.com/u/72203064?v=4)](https://github.com/TheoD02 "TheoD02 (1 commits)")[![vesper8](https://avatars.githubusercontent.com/u/816028?v=4)](https://github.com/vesper8 "vesper8 (1 commits)")[![xavierlacot](https://avatars.githubusercontent.com/u/177293?v=4)](https://github.com/xavierlacot "xavierlacot (1 commits)")[![damienalexandre](https://avatars.githubusercontent.com/u/225704?v=4)](https://github.com/damienalexandre "damienalexandre (1 commits)")[![gremo](https://avatars.githubusercontent.com/u/1532616?v=4)](https://github.com/gremo "gremo (1 commits)")[![javiereguiluz](https://avatars.githubusercontent.com/u/73419?v=4)](https://github.com/javiereguiluz "javiereguiluz (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)") --- Tags desktop-notificationshackhacktoberfestnotifiernotifyphpnotificationlinuxwindowsgrowlMAC ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/jolicode-jolinotif/health.svg) ``` [![Health](https://phpackages.com/badges/jolicode-jolinotif/health.svg)](https://phpackages.com/packages/jolicode-jolinotif) ``` ### Alternatives [symfony/notifier Sends notifications via one or more channels (email, SMS, ...) 80640.3M290](/packages/symfony-notifier)[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)[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)[terminal42/notification_center Notification Center extension for Contao Open Source CMS 68396.6k78](/packages/terminal42-notification-center)[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)