https://github.com/nightskylark/github-releases-slack-notifier

Slack bot that notify about new releases for GitHub repositories
https://github.com/nightskylark/github-releases-slack-notifier

Last synced: about 2 months ago
JSON representation

Slack bot that notify about new releases for GitHub repositories

• Host: GitHub
• URL: https://github.com/nightskylark/github-releases-slack-notifier
• Owner: nightskylark
• Created: 2016-01-21T15:52:22.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2016-07-22T09:11:49.000Z (about 8 years ago)
• Last Synced: 2024-07-18T16:33:38.112Z (2 months ago)
• Language: JavaScript
• Size: 4.88 KB
• Stars: 20
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# github-releases-slack-notifier

This module is a simple Slackbot that post a notification to a Slack group channel when new releases for one of configured GitHub repositories.

Implementation of this module uses [rss-slack-integration](https://www.npmjs.com/package/rss-slack-integration)

## Installation

`npm install github-releases-slack-notifier`

## Configuration and starting

Application needs an incoming webhook in your Slack. You can create it [here](https://my.slack.com/services/new/incoming-webhook)

* Copy your `webhookUrl`

* Create `config.json` file using `config.json.template`. Example:

```

{

	"webhookUrl": "https://hooks.slack.com/services/yourservicehash",

	"icon": ":loudspeaker:",

	"interval": 3600

}

```

* Insert your `webhookUrl` into the config file

* Change default `icon` (smile code or url) and `interval` (seconds) if it is necessary

* Create `repos.json` file using `repos.json.template`

* Add a config object for each repo using example from template. `url` is a required field and the rest fields are optional. Example:

```

[

	{

		"url": "https://github.com/jquery/jquery",

		"name": "jQuery",

		"webhookUrl": "https://hooks.slack.com/services/YourAlternativeServiceHash",

		"icon": "https://example.com/icon.png",

		"interval": 1800,

		"botName" : "jQuery releases"

	},

	{

		"url": "https://github.com/angular/angular"

	}

]

```

* Run `index.js` on your server

`node index`

**Note:** It's recommended to start this application as a backgroud process and setup it to start automatically after server restarting.

## Created by

[Evgeny Zhavoronkov](https://github.com/nightskylark)

## Issues and contributions

If you experience any issues with this module you can submit issues at the

[project's Github Repository](https://github.com/nightskylark/github-releases-slack-notifier/issues).

Any help towards improving this module is welcome. If you want to add features

or fix bugs you are welcome to submit a

[pull request](https://github.com/nightskylark/github-releases-slack-notifier/pulls).

## License

This project is licensed under MIT. See the

[LICENSE file](https://github.com/pilsprog/rss-slack-integration/blob/master/LICENSE).