# containrrr/shoutrrr

Notification library for gophers and their furry friends.

Repository: https://github.com/containrrr/shoutrrr
Canonical: https://ross.abutalabs.com/products/shoutrrr
Homepage: https://containrrr.dev/shoutrrr/
Language: Go
License: MIT
License Family: permissive
Topics: notifications, golang, go, messaging, integrations, hacktoberfest
Last push: 2026-07-01T20:02:57+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 90, release rhythm 8, longevity 100
- inputs: {"age_days": 2701, "days_push": 63, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1661, forks 104 (observed 2026-08-28T04:05:18.560449+00:00)

## What it is
Shoutrrr is a Go notification library that lets you send messages to services like Slack, Discord, Telegram, and email via simple URL-based service configurations. It also ships as a CLI tool for sending notifications from scripts and shell commands.

## Use cases
- send slack notifications from a go application
- notify discord channel when a script finishes
- send alerts from shell scripts
- push notifications to telegram from ci pipeline
- send messages to multiple services at once
- add notification support to my go app

## When to choose
- you write Go and want multi-service notifications with a simple API
- you need URL-based notification config similar to apprise
- you want a CLI to fire notifications from scripts or cron jobs

## When to avoid
- you need a non-Go language SDK
- you need a hosted notification service with dashboards and retries
- you need rich message formatting beyond what the services support

## Facets
- artifact type: library
- maturity: active
- function: sdk, cli, webhook
- domain: developer-tools
- platform: go, cli, cross-platform
- tags: notifications, messaging-integrations, url-based-configuration, alerting, go-library, messaging, automation, command-line

## Member repositories
- containrrr/shoutrrr (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.560449+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:44:36.952342+00:00, confidence not recorded.
  - readme: https://github.com/containrrr/shoutrrr (fetched 2026-08-28T04:05:18.560449+00:00, sha bfb6ac0e75b7)
  - homepage: https://containrrr.dev/shoutrrr/ (fetched 2026-08-29T11:16:53.198310+00:00, sha 36c6c3c2e4f9)
- Data as of 2026-08-30T08:39:29.467469+00:00.