Skip to content

Apprise Notification

Actions
Send a dynamic push notification to every single platform thanks to the Apprise library
v3.0.2
Latest
Star (21)

Tags

 (2)

apprise-ga

GitHub Action to send a dynamic push notification to every single platform thanks to the Apprise library

Supports services like Slack, AWS SNS, Discord, IFTTT, Matrix, Microsoft Teams, Telegram, Twitter etc., as well as email and webhooks.

Supports dynamically adding event data to the notification message with Jinja2 templates.

Example usage

uses: cstuder/apprise-ga@master
with:
  title: "Notification title"
  message: "Message"
env:
  APPRISE_URL: ${{ secrets.APPRISE_URL }}

Complete usage

  1. Create a new action in your workflow which uses cstuder/apprise-ga@master. (Or a tagged version.)
  2. Look up the syntax for your push notification URL in the list of Supported Notifications by Apprise. (I.e. protocol://user:password@hostname/channel)
  3. Create a repository secret named APPRISE_URL with your URL as content.
  4. Add your message as inputs title or message.

Inserting event data with templates

For both title and message you can use the Jinja2 syntax to insert data from the event trigger (/github/workflow/event.json) into your notification.

Find the event data in the list of GitHub webhook payloads.

Templating example

For a push event, you might use the following arguments:

title: "Push received on {{ ref }}"
message: "Commit by {{ head_commit.author.name }}: {{ head_commit.message | truncate(128) }} ({{ head_commit.id[0:7] }})"

Inputs

title

Required String with notification title.

message

Required String with notification message.

Secrets

APPRISE_URL

Required Notification URL(s) according to the Apprise documentation.

To notify mulitple URLs, add them separated by spaces.

License

MIT.

Apprise Notification is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Send a dynamic push notification to every single platform thanks to the Apprise library
v3.0.2
Latest

Tags

 (2)

Apprise Notification is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.