Skip to content

Notifications

MMagTech edited this page Mar 12, 2026 · 6 revisions

Notifications (Apprise)

Nudgarr uses Apprise to send push notifications. Apprise supports over 80 notification services through a unified URL syntax — the same configuration field works for Telegram, Discord, Slack, Gotify, Pushover, ntfy, and many others.


Enabling notifications

  1. Open the Notifications tab
  2. Toggle Notifications Enabled to on
  3. Enter one or more Apprise URLs (one per line)
  4. Choose which events should trigger a notification
  5. Save and use the Test button to verify delivery

Apprise URL format

Each service has its own URL format. The general pattern is:

schema://[credentials@]host[:port][/path]

Some common examples:

Service Example URL
Telegram tgram://bottoken/chatid
Discord discord://webhookid/webhooktoken
Slack slack://tokenA/tokenB/tokenC/channel
Gotify gotify://hostname/apptoken
Pushover pover://userkey@apptoken
ntfy ntfy://hostname/topic
Pushbullet pbul://accesstoken
Email (SMTP) mailto://user:pass@hostname

For a full list of supported services and their URL formats, see the Apprise wiki.

Multiple notification targets

To send notifications to more than one service, enter each URL on a separate line in the Apprise URL field. Nudgarr sends to all configured URLs on each triggered event.


Notification triggers

Trigger Default What it sends
Sweep Complete On A summary after each sweep: number of items searched and number skipped due to cooldown
Import Confirmed On A message when a confirmed import is detected, including the title, type (Movie/Episode), and instance name
Error On A message when a sweep or instance error occurs

Each trigger can be toggled independently.


Sweep Complete message format

Nudgarr — Sweep Complete
3 items searched, 7 skipped due to cooldown.

Import Confirmed message format

Nudgarr — Movie Imported
Dune: Part Two was successfully imported via Radarr-Main.

Troubleshooting notifications

Notifications aren't arriving

  • Check that Notifications Enabled is toggled on
  • Use the Test button on the Notifications tab — this sends a test message immediately
  • Verify your Apprise URL is correct for your service; refer to the Apprise wiki for the exact format
  • Check the container logs (docker logs nudgarr) for [Notify] lines — these show whether Apprise attempted delivery and whether it succeeded

Apprise URL schemes not working

Nudgarr supports non-HTTP Apprise schemes including tgram://, discord://, slack://, and all others. If a URL appears to be rejected, check that notifications are enabled and that the URL is entered without any surrounding whitespace.

Apprise is not available

If the container logs show [Notify] Apprise not available, the Apprise library was not installed in this build. File an issue on GitHub.

Clone this wiki locally