Notifications

Inspectarr sends notifications through Pushover. Notifications are optional; configure them under Settings → Notifications or in config.yaml.

---

Setup

You'll need two values from your Pushover account:

• An application token — create an application at pushover.net/apps/build.
• Your user key — shown on your Pushover dashboard.

notifications:
  pushover:
    enabled: true
    app_token: your_app_token
    user_key: your_user_key
    notify_on: [action, error, startup, dry_run]
    priority: 0

The Settings page has a Test Notification button that sends a test push to confirm your credentials work before you rely on them.

---

Event types

notify_on controls which events trigger a push. Include only the ones you care about.

Event	Fires when
action	A bad torrent is blocklisted and deleted
error	An *arr or qBittorrent call fails, or an unhandled error occurs
startup	Inspectarr launches
dry_run	A match is found while Dry Run is on (no action taken)

---

Priority

priority: 0

Maps to Pushover's priority scale: -2 silent, -1 quiet, 0 normal, 1 high, 2 emergency. Most people leave this at 0, or use 1 for action events so a caught malicious torrent gets your attention.

---

Error deduplication

Inspectarr won't spam you with the same error every cycle. If a service stays down, the error notification fires once; it won't fire again for that same failure until the condition clears and recurs. This is automatic and needs no configuration.