{"id":15038454,"url":"https://github.com/jolicode/jolinotif","last_synced_at":"2025-05-14T12:07:14.788Z","repository":{"id":28000847,"uuid":"31495112","full_name":"jolicode/JoliNotif","owner":"jolicode","description":":computer: Send notifications to your desktop directly from your PHP script","archived":false,"fork":false,"pushed_at":"2025-02-17T10:55:37.000Z","size":3091,"stargazers_count":1417,"open_issues_count":0,"forks_count":94,"subscribers_count":47,"default_branch":"main","last_synced_at":"2025-04-11T19:14:26.884Z","etag":null,"topics":["desktop-notifications","hack","hacktoberfest","notifier","notify","php"],"latest_commit_sha":null,"homepage":"http://jolicode.com/blog/desktop-notification-in-php","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jolicode.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"tidelift":"packagist/jolicode/jolinotif"}},"created_at":"2015-03-01T11:50:10.000Z","updated_at":"2025-04-11T09:28:08.000Z","dependencies_parsed_at":"2024-05-03T12:58:29.708Z","dependency_job_id":"f82fefac-c4db-4ca2-9ccc-08ed3bd56aa9","html_url":"https://github.com/jolicode/JoliNotif","commit_stats":{"total_commits":215,"total_committers":25,"mean_commits":8.6,"dds":0.2930232558139535,"last_synced_commit":"87a02e2696753d49e6786845de663ec8539eeefa"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2FJoliNotif","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2FJoliNotif/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2FJoliNotif/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jolicode%2FJoliNotif/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jolicode","download_url":"https://codeload.github.com/jolicode/JoliNotif/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248465346,"owners_count":21108244,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["desktop-notifications","hack","hacktoberfest","notifier","notify","php"],"created_at":"2024-09-24T20:38:34.561Z","updated_at":"2025-04-11T19:14:47.684Z","avatar_url":"https://github.com/jolicode.png","language":"PHP","funding_links":["https://tidelift.com/funding/github/packagist/jolicode/jolinotif"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=doc/images/demo.gif alt=\"JoliNotif demo\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://packagist.org/packages/jolicode/jolinotif\"\u003e\u003cimg src=\"https://poser.pugx.org/jolicode/jolinotif/downloads\" alt=\"Total Downloads\"\u003e\u003c/img\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/jolicode/jolinotif\"\u003e\u003cimg src=\"https://poser.pugx.org/jolicode/jolinotif/v/stable\" alt=\"Latest Stable Version\"\u003e\u003c/img\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/jolicode/jolinotif\"\u003e\u003cimg src=\"https://poser.pugx.org/jolicode/jolinotif/v/unstable\" alt=\"Latest Unstable Version\"\u003e\u003c/img\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# About JoliNotif\n\nJoliNotif is a cross-platform PHP library to display desktop notifications.\nIt works on Linux, Windows or macOS.\n\nRequires PHP \u003e= 8.1 (support for PHP 5 was available in version 1.x, for PHP 7.0\nand 7.1 in version \u003c 2.1.0, for PHP 7.2 and 7.3 in version \u003c 2.4.0, for PHP \u003c 8.0 in version 2.6.0).\n\n\u003e [!NOTE]\n\u003e This library can not be used in a web context (FPM or equivalent). Use\n\u003e it in your CLI scripts or in a [CRON](doc/04-cron-usage.md)\n\n## Installation\n\nUse [Composer](http://getcomposer.org/) to install JoliNotif in your project:\n\n```shell\ncomposer require \"jolicode/jolinotif\"\n```\n\n## Usage\n\n```php\ninclude __DIR__.'/vendor/autoload.php';\n\nuse Joli\\JoliNotif\\Notification;\nuse Joli\\JoliNotif\\DefaultNotifier;\n\n$notifier = new DefaultNotifier();\n\n// Create your notification\n$notification =\n    (new Notification())\n    -\u003esetTitle('Notification title')\n    -\u003esetBody('This is the body of your notification')\n    -\u003esetIcon(__DIR__.'/path/to/your/icon.png')\n    -\u003eaddOption('subtitle', 'This is a subtitle') // Only works on macOS (AppleScriptDriver)\n    -\u003eaddOption('sound', 'Frog') // Only works on macOS (AppleScriptDriver \u0026 TerminalNotifierDriver)\n;\n\n// Send it\n$notifier-\u003esend($notification);\n```\n\nA [shell executable](doc/05-cli-usage.md) is also provided to use JoliNotif from CLI:\n\n```shell\njolinotif --title \"Hello\" --body \"World\"\n```\n\n## Further documentation\n\nDiscover more by reading the docs:\n\n* [Basic usage](doc/01-basic-usage.md)\n* [Notification](doc/02-notification.md)\n* [Drivers](doc/03-drivers.md)\n* [CRON usage](doc/04-cron-usage.md)\n* [CLI usage](doc/05-cli-usage.md)\n\nYou can see the current and past versions using one of the following:\n\n* the `git tag` command\n* the [releases page on Github](https://github.com/jolicode/JoliNotif/releases)\n* the file listing the [changes between versions](CHANGELOG.md)\n\nAnd finally some meta documentation:\n\n* [versioning and branching models](VERSIONING.md)\n* [contribution instructions](CONTRIBUTING.md)\n\n## Credits\n\n* [All contributors](https://github.com/jolicode/JoliNotif/graphs/contributors)\n* This project was originally inspired by [mikaelbr/node-notifier](https://github.com/mikaelbr/node-notifier)\n\n## License\n\nJoliNotif is licensed under the MIT License - see the [LICENSE](LICENSE) file\nfor details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolicode%2Fjolinotif","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjolicode%2Fjolinotif","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjolicode%2Fjolinotif/lists"}