Notifications

Inspectarr sends notifications through Apprise, which supports Pushover, Telegram, Discord, email, and 100+ services. Notifications are optional; configure them under Settings → Notifications or in config.yaml.

---

Setup

Add one or more Apprise URLs to the urls list. Each URL targets a different notification service.

notifications:
  apprise:
    enabled: true
    urls:
      - pover://user@token              # Pushover
      - tgram://bottoken/ChatID         # Telegram
      - discord://webhook_id/token      # Discord
    notify_on: [action, error, startup, dry_run]

See the Apprise wiki for the full list of supported URL schemes. The Settings page has a Test Notification button that sends a test push to confirm your URLs work before you rely on them.

---

Common Apprise URL examples

Service	URL format
Pushover	pover://user@token
Telegram	tgram://bottoken/ChatID
Discord	discord://webhook_id/token
Slack	slack://tokenA/tokenB/tokenC/#channel
Email (SMTP)	mailto://user:pass@smtp.example.com
Gotify	gotify://hostname/token

---

Event types

notify_on controls which events trigger a notification. 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)

---

Digest

Batch individual notifications into a single summary instead of sending one per event.

  digest:
    enabled: false
    use_ollama: false

When use_ollama is enabled, the digest is narrated by your configured Ollama model for a more natural-language summary.

---

Periodic summary

Generate a daily or weekly summary of recent activity.

  summary:
    enabled: false
    schedule: daily        # "daily" or "weekly"
    use_ollama: true

---

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.