8000 GitHub - nicholas-fedor/shoutrrr: Notification library for Watchtower.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

nicholas-fedor/shoutrrr

 
 

Repository files navigation

Shoutrrr

Notification library for gophers and their furry friends. Heavily inspired by caronc/apprise.

github actions workflow status codecov Codacy Badge report card go.dev reference github code size in bytes license Pulls from DockerHub godoc All Contributors



Installation

Using the Go CLI

go install github.com/nicholas-fedor/shoutrrr/shoutrrr@latest

From Source

go build -o shoutrrr ./shoutrrr

Quick Start

As a package

Using shoutrrr is easy! There is currently two ways of using it as a package.

Using the direct send command

  url := "slack://token-a/token-b/token-c"
  err := shoutrrr.Send(url, "Hello world (or slack channel) !")

Using a sender

  url := "slack://token-a/token-b/token-c"
  sender, err := shoutrrr.CreateSender(url)
  sender.Send("Hello world (or slack channel) !", map[string]string { /* ... */ })

Using a sender with multiple URLs

  urls := []string {
    "slack://token-a/token-b/token-c"
    "discord://token@channel"
  }
  sender, err := shoutrrr.CreateSender(urls...)
  sender.Send("Hello world (or slack channel) !", map[string]string { /* ... */ })

Through the CLI

Start by running the build.sh script. You may then run send notifications using the shoutrrr executable:

shoutrrr send [OPTIONS] <URL> <Message [...]>

From a GitHub Actions workflow

You can also use Shoutrrr from a GitHub Actions workflow.

See this example and the action on GitHub Marketplace:

name: Deploy
on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Some other steps needed for deploying
        run: ...
      - name: Shoutrrr
        uses: nicholas-fedor/shoutrrr-action@v1
        with:
          url: ${{ secrets.SHOUTRRR_URL }}
          title: Deployed ${{ github.sha }}
          message: See changes at ${{ github.event.compare }}.

Documentation

For additional details, visit the full documentation.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Nicholas Fedor
Nicholas Fedor

💻 📖 🚧 👀
Amir Schnell
Amir Schnell

💻
nils måsén
nils måsén

💻 📖 🚧
Luka Peschke
Luka Peschke

💻 📖
MrLuje
MrLuje

💻 📖
Simon Aronsson
Simon Aronsson

💻 📖 🚧
Arne Jørgensen
Arne Jørgensen

📖 💻
Alexei Tighineanu
Alexei Tighineanu

💻
Alexandru Bonini
Alexandru Bonini

💻
Senan Kelly
Senan Kelly

💻
JonasPf
JonasPf

💻
claycooper
claycooper

📖
Derzsi Dániel
Derzsi Dániel

💻
Joseph Kavanagh
Joseph Kavanagh

💻 🐛
Justin Steven
Justin Steven

🐛
Carlos Savcic
Carlos Savcic

💻 📖

This project follows the all-contributors specification. Contributions of any kind welcome!

Related Project(s)

  • watchtower - automate Docker container image updates

About

Notification library for Watchtower.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Languages

  • Go 99.8%
  • Other 0.2%
0