-
Notifications
You must be signed in to change notification settings - Fork 0
Notifications
Nudgarr uses Apprise to send push notifications. Apprise supports over 100 notification services through a unified URL syntax — the same configuration field works for Telegram, Discord, Slack, Gotify, Pushover, ntfy, and many others.
- Open the Notifications panel in the sidebar
- Toggle Notifications Enabled to on
- Enter your Apprise URL (separate multiple URLs with commas)
- Choose which events should trigger a notification
- Save and use the Test button to verify delivery
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.
To send notifications to more than one service, separate the URLs with commas. The Apprise URL field is a single-line input, so commas — not line breaks — are how you add multiple targets. Nudgarr sends to all configured URLs on each triggered event.
| 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.
Nudgarr — Sweep Complete
Radarr-Main — 4 Searched (3 Cutoff, 1 CF Score)
Sonarr-Main — 2 Searched (1 Cutoff, 1 Backlog)
Nudgarr — Movie Imported
Dune: Part Two was successfully imported via Radarr-Main.
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 lines starting withNotification. Failures are logged at WARNING level (Notification failed to send:orNotification error for). Successful sends are logged at DEBUG only, so if the logs look empty set Log Level toDEBUGin Advanced before concluding nothing was attempted
Apprise URL schemes not working
All Apprise schemes are supported, including tgram://, discord://, ntfy://, gotify://, and mailto://.
On versions before v5.0.5 the Test button rejected every non-HTTP scheme — only https:// webhook URLs (such as a raw Discord webhook URL) passed its validation check. This affected the Test button only; a saved URL still delivered normally. If Test reports an invalid or disallowed URL for a scheme like ntfy://, upgrade to v5.0.5 or later.
Desktop-only transports (dbus://, gnome://, macosx://) cannot work inside the container regardless of version, since the container has no desktop session.
Apprise is not available
If the container logs show Apprise not installed — notification skipped, the Apprise library was not installed in this build. File an issue on GitHub.