PHPackages                             wooshell/gh-notifier - 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. [Utility & Helpers](/categories/utility)
4. /
5. wooshell/gh-notifier

ActiveProject[Utility & Helpers](/categories/utility)

wooshell/gh-notifier
====================

Tracks github projects to let you know when new releases are available.

00PHP

Since Aug 3Pushed 12y agoCompare

[ Source](https://github.com/wooshell/gh-notifier)[ Packagist](https://packagist.org/packages/wooshell/gh-notifier)[ RSS](/packages/wooshell-gh-notifier/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

gh-notifier (wip)
=================

[](#gh-notifier-wip)

Tracks github projects to let you know when new releases are available.

Notifications modes:

- mail (mode: "swiftMailer")
- desktop notification (mode: "gnu")

Prerequisites
-------------

[](#prerequisites)

- notify-send for gnu mode

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

[](#installation)

```
$ composer install

```

Configuration
-------------

[](#configuration)

```
$ src/wooshell/ghnotifier/Resources/config/notify.yml

```

Usage
-----

[](#usage)

Use this command to send notifications:

```
$ bin/gh-notifier send gnu,mail
$ bin/gh-notifier send gnu
$ ..

```

In the background, an history file is stored for each github project and at each run, the script detects new releases via Github API.

Notification modes values are comma separated

Running automatically
---------------------

[](#running-automatically)

Lock each run of gh-notifier if you want to cronify the script. The lock file is removed at the end of a run.

```
$ bin/gh-notifier send gnu --lock-file=/tmp/gh-notifier.lock

```

You can build a PHAR if you need an easy way to deploy (needs box.phar installation from  ):

```
$ build box
$ chmod +x gh-notifier.phar
$ gh-notifier.phar send [...]

```

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/9146088?v=4)[wooshell](/maintainers/wooshell)[@wooshell](https://github.com/wooshell)

---

Top Contributors

[![willgarcia](https://avatars.githubusercontent.com/u/1169460?v=4)](https://github.com/willgarcia "willgarcia (3 commits)")

### Embed Badge

![Health badge](/badges/wooshell-gh-notifier/health.svg)

```
[![Health](https://phpackages.com/badges/wooshell-gh-notifier/health.svg)](https://phpackages.com/packages/wooshell-gh-notifier)
```

###  Alternatives

[jomweb/ringgit

Malaysia Ringgit implementation on top of Money PHP

30184.1k1](/packages/jomweb-ringgit)[fof/socialprofile

Add custom social media pages to your user profile

1441.9k](/packages/fof-socialprofile)[piwi/composer-symlinker

A composer plugin to install packages as local symbolic links

181.1k](/packages/piwi-composer-symlinker)

PHPackages © 2026

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