_ _ _ _ /_\ | | ___ _ __| |_ /\ /\_ _| |__ //_\\| |/ _ \ '__| __|/ /_/ / | | | '_ \ / _ \ | __/ | | |_/ __ /| |_| | |_) | \_/ \_/_|\___|_| \__\/ /_/ \__,_|_.__/
AlertHub is a simple tool written with NodeJS to get alerted from GitHub releases, tags and commits.
When you watch a release over GitHub, you also auto watch the issues and comments etc., however if you want to only follow new releases, commits or tags, there isn't a way to achieve this from GitHub directly.
There's been a service called sibbell.com, but they shut down on 15th May, 2018. That's why, I decided to make one for myself.
This simple cli tool watches the releases set in config, and notifies you with E-mail or PushBullet, and provides you an aggregated RSS feed which you can use in IFTTT or your personal feed reader.
Update 2018.11.28: GitHub now supports following the repositories' releases, however, they still don't cover the push notification feature which this tool offers.
- NodeJS 8.x or newer
- (Optional) PushBullet Api Key
- (Optional) SMTP credentials to dispatch e-mail
Either one of the PushBullet or the SMTP credentials are required to get notifications. RSS feed doesn't require neither.
You can install and run AlertHub with some simple steps:
- Clone this repository or get the latest release version.
- Navigate to the folder, and run
npm installto install dependencies.
npm run initto copy the configuration file.
/etc/config.js, and fill your credentials.
npm startor something like
pm2 start npm -- startand run the application.
You can also run AlertHub through a Docker container. See kmlucy/docker-alerthub.
I'll keep track of each release in the CHANGELOG.md.
Please refer to UPGRADING.md.
TODOs / Plans
- A portable storage solution such as SQLite etc.
- Following GitLab and BitBucket releases
- Multi user feature
Aggregated RSS Following commits and tags in addition to releases.
- Following commits from a specific branch
- You say!
Buy me a coffee or beer!
Donations are kindly accepted to help develop my projects further.
ETH / ERC20 Tokens: 0x3C2b0AC49257300DaB96dF8b49d254Bb696B3458
NEO / Nep5 Tokens: AYbHEah5Y4J6BV8Y9wkWJY7cCyHQameaHc