Skip to content

Announcarr

Yuval Ziv edited this page Nov 30, 2024 · 2 revisions

Announcarr lets you get summary and forecast of your arr instances, currently supporting Radarr and Sonarr. I call them integrations. Each one have its own configuration. You can configure multiple instances of each integration, allowing you to have one notification center for all your instances.

Announcarr also supports listening to webhooks (currently only Overseerr is supported), giving greater control over the notifications (mostly because notification control in Overseerr is bad - one agent per app).

Integrations

Integrations need to support summaries and forecasts. A summary is what happened on the previous interval (for example, last week), and a forecast is what will happen in the up-and-coming interval.

Both Sonarr and Radarr support both of these functionalities. On the summary, they will get any new series/movie added, and new episodes/movies downloaded. On the forecast part, they will just get which episodes and movies are supposed to be released.

Webhooks

Starts an HTTP listener that can handle requests (HTTP method and path can be configured easily). Currently only supports Overseerr as I have no idea of other things to add. Handles almost all notification types (except media failed since I can't figure out how to mock it).

Exporters

Basically, they are notification channels. Currently only supporting Telegram cause this is the one I mainly use.

Note

Telegram bots are limited to one message per second per chat, and a burst bulk of 30 messages per second, unless paid broadcasts are enabled (see more).

Tags

Each integration, webhook and exporter support tagging. This can help you direct the announcement to the correct exporter. By default, announcements and exporters don't have any tags, which means exporters will send any notification coming their way. If any of them has tags, there needs to be an overlap between the announcement's tags and the exporter's tags.

Interval

All summaries and forecast will currently be sent at the same time, according to the configured Announcarr range. You can control the exact minute, hour and day when exporting will be sent.

Clone this wiki locally