/GitHub-Discord-Bot

Subscribe a Discord Channel to Events in your GitHub Repositories.

Primary LanguagePythonMIT LicenseMIT

GitHub Bot for Discord

Subscribe a Discord Channel to Events in your GitHub Repositories. Try it now!

Banner

Discord Bot AWS Lambda Python 3.11 Developer Program Slash Commands

Like this bot? Give it a ⭐ on GitHub!

Getting Started

First, add the bot to your Discord server. Use the commands below in a text channel to subscribe to specific GitHub events.

Commands

Type or Copy into Discord!

Subscription Create ➕

/github subscription create repo: events:

Subscription Delete 🗑️

/github subscription delete repo: events:

List Subscriptions 📋

/github status list

Example

Live GIF Example

  1. Subscribed to All Events in this repo.
  2. Received a new Star ⭐ event on the GitHub repo.
  3. Listed current subscriptions for the Discord channel.
  4. Deleted the All Events subscription in the channel.

GitHub URLs or Owner/Repo formats work!

Issues

Found a bug, ran into an issue, or have an idea? Submit an issue!

Permissions

This bot requires specific permissions to function properly. The bot only requests the minimum necessary permissions for its intended functionality, prioritizing user privacy and security.

  1. Discord - Manage Webhooks: The bot requires this permission to create and manage webhooks in your Discord server. Webhooks are used to deliver GitHub-related events to your specified channels.
  2. GitHub - Repository Webhooks: The bot needs permission to create and manage webhooks in your GitHub repositories.

Maintainer

Nic Jones, (@NicPWNs)

License

This project is licensed under the MIT License.

Disclaimer

This bot is not officially created or endorsed by GitHub, Inc. It is an independent project developed by NicPWNs for enhancing GitHub integration under the GitHub Developer Program.

GitHub and the GitHub and Octocat logo are trademarks of GitHub, Inc. The use of the GitHub name and logo is for identification and reference purposes only and does not imply any association with the GitHub brand.