shonp40 / github-releases-to-discord

Posts a GitHub Release changelog to a specified Discord channel

GitHub Releases To Discord Action

A GitHub action that parses a GitHub release and posts it to a Discord channel as a stylized Discord webhook.

---

Output

Configuration

Variable	Required	Default	Description
webhook_url	✔		Discord's webhook url. Use GH repo secrets.
color	❌	"2105893"	Decimal color value for embed.
username	❌		String username for webhook.
avatar_url	❌		String url to webhook avatar picture.
content	❌		String content for webhook.
footer_title	❌		String title for the webhook footer.
footer_icon_url	❌		String url for the webhook footer picture.
footer_timestamp	❌		Boolean to enable footer timestamp.

Example Usage

.github/workflows/github-releases-to-discord.yml

on:
  release:
    types: [published]

jobs:
  github-releases-to-discord:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      - name: Github Releases To Discord
        uses: SethCohen/[email protected]
        with:
          webhook_url: ${{ secrets.WEBHOOK_URL }}
          color: "2105893"
          username: "Release Changelog"
          avatar_url: "https://cdn.discordapp.com/avatars/487431320314576937/bd64361e4ba6313d561d54e78c9e7171.png"
          content: "||@everyone||"
          footer_title: "Changelog"
          footer_icon_url: "https://cdn.discordapp.com/avatars/487431320314576937/bd64361e4ba6313d561d54e78c9e7171.png"
          footer_timestamp: true

Setup Instructions

1. Open your Server Settings and head into the Integrations tab:
2. Click the "Create Webhook" button to create a new webhook!
3. Copy the webhook url
4. Create a new GitHub repository secret called WEBHOOK_URL and paste the webhook url into it.
5. Save the secret.
6. Add the secret to your action configuration.

And you're done! Whenever you create a new release, the workflow should run and, if properly setup, post to your specified Discord channel.