AlertHub logo

AlertHub

  •  0 ratings
In category: Miscellaneous

About AlertHub

AlertHub is a simple tool to get alerted from GitHub releases.

  •   545  
  •   0  
  •   0  
  •   0  
Github stats:
  •  Commits: N/A  
  •   N/A  
  •   N/A  
  •  Latest commit: N/A  

Deploy this app to Linode with a free $100 credit!

Languages/Platforms/Technologies:
Lincenses:

  Depends on a proprietary service outside the user's control

More about AlertHub

AlertHub

   _   _           _                _
  /_\ | | ___ _ __| |_  /\  /\_   _| |__
 //_\\| |/ _ \ '__| __|/ /_/ / | | | '_ \
/  _  \ |  __/ |  | |_/ __  /| |_| | |_) |
\_/ \_/_|\___|_|   \__\/ /_/  \__,_|_.__/

AlertHub is a simple tool written with NodeJS to get alerted from GitHub and GitLab 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, or only 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, it's still buggy for me, and they still don't cover the push notification feature which this tool offers.

Features

Some people still wonder why this tool, which was released before GitHub release feature announced, yet exists, so I wanted to list the features as a bullet list:

  • You can watch GitHub releases, AND tags and commits and issues
  • You can also watch private GitHub repositories by providing an access token
  • You can watch GitLab tags and commits
  • You can watch 3rd party releases which are neither from GitHub nor GitLab
  • You can get notified with e-mail when a new update to your watch list is published
  • You can also get notified with push notification, using services PushBullet and / or PushOver
  • You can generate an aggreagated RSS feed with this tool for all your watches, which is sorted by date, and use this aggregated feed to source to your favorite news reader application, or to pipe to services such as IFTTT etc.
  • Self-hosted. Also, no GUI. You can simply set it and forget it

Requirements

  • NodeJS 10.x or newer
  • (Optional) PushBullet Api Key
  • (Optional) PushOver Api Key
  • (Optional) SMTP credentials to dispatch e-mail
  • (Optional) Personal GitHub Access token to access to private repositories and to increase fetching rate limits

Either one of the PushBullet, PushOver or the SMTP credentials are required to get notifications. RSS feed doesn't require neither.

Installation

You can install and run AlertHub with some simple steps:

  1. Clone this repository or get the latest release version.
  2. Navigate to the repository's folder, and run npm install to install dependencies.
  3. Run npm run init to copy the configuration file.
  4. Edit /etc/config.js, and fill your credentials.
  5. Run npm start or something like pm2 start npm -- start and run the application.

Docker Container

To run

docker run --name alerthub -d -v /host/path/config.js:/usr/src/app/etc/config.js -p 3444:3444 ghcr.io/ardakilic/alerthub:2

Changelog

I'll keep track of each release in the CHANGELOG.md.

Upgrading

Please refer to UPGRADING.md.

TODOs / Plans

  • A portable storage solution such as SQLite etc.
  • ~~Following GitLab releases~~
  • Following BitBucket releases
  • Multi user feature
  • Per-repository webhooks
  • ~~Aggregated RSS~~
  • ~~Following commits and tags in addition to releases~~
  • ~~PushOver integration~~
  • ~~Following commits from a specific branch (GitHub and GitLab)~~
  • You say!

License

MIT

Buy me a coffee or beer!

Donations are kindly accepted to help develop my projects further.

BTC: 1QFHeSrhWWVhmneDBkArKvpmPohRjpf7p6

ETH / ERC20 Tokens: 0x3C2b0AC49257300DaB96dF8b49d254Bb696B3458

NEO / Nep5 Tokens: AYbHEah5Y4J6BV8Y9wkWJY7cCyHQameaHc

Stellar (XLM): GBTYNE5RDGH44E7VH4DNYB4NV72GCV5VUH6PJLCJY27JZRO2K7XUML2Q

Comments (0)

Please login to join the discussion on this project.

AlertHub Reviews (0)

Overall Rating

None

based on 0 ratings

Please login to review this project.

No reviews for this project yet.

↑ back to top

pCloud Lifetime

Popular Projects

FluxBB

in Social Networks and Forums
 33k    0    0    0  

Nextcloud

in File Transfer & Synchronization
 20k    1    1    0  

Libreddit

in Social Networks and Forums
 7k    0    1    0  

Dashboard

in Personal Dashboards
 6k    0    0    0  

Audiobookshelf

in Audio Streaming
 6k    0    1    0  

CasaOS

in Self-hosting Solutions
 5k    0    0    0  

Mediagoblin

in Photo and Video Galleries
 4k    0    0    0  

Most Discussed

Nextcloud

in File Transfer & Synchronization
 20k    1    1    0  

Tube Archivist

in Automation
 3k    0    1    0  

OneDev

in Project Management
 2k    0    0    0  

iodine

in Proxy
 2k    0    0    0  

Alf.io

in Booking and Scheduling
 2k    0    0    0  

sysPass

in Password Managers
 1k    0    0    0  

Misskey

in Social Networks and Forums
 2k    0    0    0  
Linux VPS from $11/yr.
RackNerd VPS for $11.38/mo

Top Rated Projects

Gitea

 1 rating
in Project Management

Bagisto

 1 rating
in E-commerce

LinkAce

 1 rating
in Bookmarks and Link Sharing

Pydio

 1 rating
in File Transfer & Synchronization

Audiobookshelf

 1 rating
in Audio Streaming

Nextcloud

 1 rating
in File Transfer & Synchronization

Seafile

 1 rating
in File Transfer & Synchronization

Categories

You May Also Be Interested In

Reactive Resume logo
Reactive Resume cover

Reactive Resume

A one-of-a-kind resume builder that keeps your privacy in m…

NATS logo
NATS cover

NATS

Publish/Subscribe event bus, durable queues, key-value stor…

Notica logo
Notica cover

Notica

Lets you send browser notifications from your terminal to y…