Notifications

Librariarr supports Discord webhook notifications. Configure them in Settings → Notifications.

Discord Webhooks

Send notifications to a Discord channel via webhook.

Setup

1. In Discord, go to Channel Settings → Integrations → Webhooks
2. Create a new webhook and copy the URL
3. In Librariarr, go to Settings → Notifications
4. Paste the webhook URL
5. Optionally set a custom username (default: “Librariarr”) and avatar URL
6. Click Test Webhook to verify it works

Events

Discord notifications are sent for:

• Lifecycle actions: When rules execute actions (delete, unmonitor, etc.) — success or failure, for both scheduled and manual execution
• Match changes: When rule detection finds new matches or removes stale ones (configurable per rule set)
• Maintenance mode: When maintenance mode is toggled on/off

Lifecycle notifications are configured per rule set via the discordNotifyOnAction and discordNotifyOnMatch toggles in the rule set settings.

Message Format

Notifications are sent as Discord embeds with:

• Title: Media title or event name
• Description: Action details and status
• Color: Green for success, red for failure
• Footer: “Librariarr Lifecycle”
• Timestamp: When the event occurred

Limitations

• Discord webhooks require a valid Discord channel with webhook permissions