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
- Open the Notifications panel in the sidebar
- Toggle Notifications Enabled to on
- Enter one or more Apprise URLs (one per line)
- Choose which events should trigger a notification
- 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 showing results per instance. Instances that searched nothing are omitted. Instances with notifications disabled via Per-Instance Override are silently skipped. |
| Import Confirmed | On | A message when a confirmed import is detected, including the title, type (Movie/Episode), and instance name |
| Auto-Exclusion | On | A message when a title is auto-excluded, including the title, search count, and instance name |
| Error | On | A message when a sweep or instance error occurs |
| Queue Depth | On | A message when a sweep is skipped because the total download queue meets or exceeds the configured threshold. Fires every time a sweep is skipped. Sweep Complete handles recovery when the next sweep runs successfully. |
Each trigger can be toggled independently.
Sweep Complete message format
Nudgarr — Sweep Complete
Radarr-Main — 4 Searched (3 Cutoff, 1 CF Score)
Sonarr-Main — 2 Searched (1 Cutoff, 1 Backlog)
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 panel — 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.