Notifications
Configure Discord, Telegram, Slack, email, and 8 more notification providers.
Comicarr can notify you when issues are snatched (sent to a download client) and when they are imported into your library. Enable one or more providers below.
Each provider has an ONSNATCH toggle that controls whether notifications fire on snatch events in addition to import events.
Send notifications to a Discord channel via webhook.
| Setting | Type | Default | Description |
|---|---|---|---|
DISCORD_ENABLED | bool | False | Enable Discord notifications. |
DISCORD_WEBHOOK_URL | string | none | Discord webhook URL. Create one in Server Settings > Integrations > Webhooks. |
DISCORD_ONSNATCH | bool | False | Also notify on snatch events. |
Setup: In Discord, go to your channel's settings, select Integrations > Webhooks > New Webhook, copy the URL, and paste it into DISCORD_WEBHOOK_URL.
Send notifications to a Telegram chat via a bot.
| Setting | Type | Default | Description |
|---|---|---|---|
TELEGRAM_ENABLED | bool | False | Enable Telegram notifications. |
TELEGRAM_TOKEN | string | none | Bot token from @BotFather. |
TELEGRAM_USERID | string | none | Chat ID to send messages to. Use @userinfobot to find yours. |
TELEGRAM_ONSNATCH | bool | False | Also notify on snatch events. |
TELEGRAM_IMAGE | bool | False | Include cover art in notifications. |
Setup: Message @BotFather to create a bot, copy the token, then start a conversation with your bot and enter your chat ID.
Send notifications to a Slack channel via incoming webhook.
| Setting | Type | Default | Description |
|---|---|---|---|
SLACK_ENABLED | bool | False | Enable Slack notifications. |
SLACK_WEBHOOK_URL | string | none | Slack incoming webhook URL. |
SLACK_ONSNATCH | bool | False | Also notify on snatch events. |
Setup: In your Slack workspace, go to Apps > Incoming Webhooks, create a new webhook for your channel, and paste the URL.
Send push notifications to iOS and Android devices via Pushover.
| Setting | Type | Default | Description |
|---|---|---|---|
PUSHOVER_ENABLED | bool | False | Enable Pushover notifications. |
PUSHOVER_PRIORITY | int | 0 | Message priority: -2 to 2. 0 = normal. |
PUSHOVER_APIKEY | string | none | Application API key from the Pushover dashboard. |
PUSHOVER_DEVICE | string | none | Target device name. Leave blank to send to all devices. |
PUSHOVER_USERKEY | string | none | Your Pushover user key. |
PUSHOVER_ONSNATCH | bool | False | Also notify on snatch events. |
PUSHOVER_IMAGE | bool | False | Include cover art in notifications. |
Setup: Register an application at pushover.net to get your API key, then find your user key on the dashboard.
Send notifications via email (SMTP).
| Setting | Type | Default | Description |
|---|---|---|---|
EMAIL_ENABLED | bool | False | Enable email notifications. |
EMAIL_FROM | string | none | Sender address. |
EMAIL_TO | string | none | Recipient address. |
EMAIL_SERVER | string | none | SMTP server hostname. |
EMAIL_USER | string | none | SMTP username. |
EMAIL_PASSWORD | string | none | SMTP password. Encrypted at rest. |
EMAIL_PORT | int | 25 | SMTP port. |
EMAIL_ENC | int | 0 | Encryption: 0 = none, 1 = TLS, 2 = SSL. |
EMAIL_ONGRAB | bool | False | Send on snatch events. |
EMAIL_ONPOST | bool | False | Send on post-processing events. |
For Gmail, use smtp.gmail.com, port 587, and EMAIL_ENC = 1 (TLS). You will need an app password if 2FA is enabled.
Send notifications to a self-hosted Gotify server.
| Setting | Type | Default | Description |
|---|---|---|---|
GOTIFY_ENABLED | bool | False | Enable Gotify notifications. |
GOTIFY_SERVER_URL | string | none | Gotify server URL (e.g. http://localhost:8070). |
GOTIFY_TOKEN | string | none | Application token from the Gotify dashboard. |
GOTIFY_ONSNATCH | bool | False | Also notify on snatch events. |
Setup: In Gotify, create a new application under Apps and copy the token.
Send notifications to a Matrix room.
| Setting | Type | Default | Description |
|---|---|---|---|
MATRIX_ENABLED | bool | False | Enable Matrix notifications. |
MATRIX_HOMESERVER | string | none | Matrix homeserver URL (e.g. https://matrix.org). |
MATRIX_ACCESS_TOKEN | string | none | Access token for the Matrix bot account. |
MATRIX_ROOM_ID | string | none | Target room ID (e.g. !abc123:matrix.org). |
MATRIX_ONSNATCH | bool | False | Also notify on snatch events. |
Setup: Create a Matrix account for the bot, generate an access token (via Element or the Matrix API), and invite the bot to the target room.
Send notifications to a Mattermost channel via incoming webhook.
| Setting | Type | Default | Description |
|---|---|---|---|
MATTERMOST_ENABLED | bool | False | Enable Mattermost notifications. |
MATTERMOST_WEBHOOK_URL | string | none | Mattermost incoming webhook URL. |
MATTERMOST_ONSNATCH | bool | False | Also notify on snatch events. |
Setup: In Mattermost, go to Integrations > Incoming Webhooks, create a webhook for your channel, and paste the URL.
Send push notifications via PushBullet.
| Setting | Type | Default | Description |
|---|---|---|---|
PUSHBULLET_ENABLED | bool | False | Enable PushBullet notifications. |
PUSHBULLET_APIKEY | string | none | Access token from the PushBullet settings page. |
PUSHBULLET_DEVICEID | string | none | Target device identifier. Leave blank for all devices. |
PUSHBULLET_CHANNEL_TAG | string | none | PushBullet channel tag for channel-based notifications. |
PUSHBULLET_ONSNATCH | bool | False | Also notify on snatch events. |
Setup: Go to pushbullet.com/#settings and create an access token.
Send push notifications to iOS via Prowl.
| Setting | Type | Default | Description |
|---|---|---|---|
PROWL_ENABLED | bool | False | Enable Prowl notifications. |
PROWL_PRIORITY | int | 0 | Message priority: -2 (very low) to 2 (emergency). |
PROWL_KEYS | string | none | Prowl API key(s). Comma-separated for multiple keys. |
PROWL_ONSNATCH | bool | False | Also notify on snatch events. |
Setup: Generate an API key at prowlapp.com.
Boxcar is retained as a legacy notification integration. Comicarr sends requests to https://new.boxcar.io/api/notifications.
Boxcar's public site and API endpoint did not respond during the documentation check on 2026-09-05, so current service availability could not be verified. Existing Boxcar tokens may still work if the service becomes reachable, but do not depend on Boxcar for a new setup. Use the Pushover or PushBullet tabs above for alternative setup instructions.
| Setting | Type | Default | Description |
|---|---|---|---|
BOXCAR_ENABLED | bool | False | Enable Boxcar notifications. |
BOXCAR_ONSNATCH | bool | False | Also notify on snatch events. |
BOXCAR_TOKEN | string | none | Boxcar access token. |
Setup: Enter an existing Boxcar access token in BOXCAR_TOKEN. The current application retains this setting and notifier, but no working Boxcar setup page was available to link during the documentation check.