Get notified when streams go live, recordings start, or errors occur.
Notification Types
| Event | Description |
|---|
| Stream Live | A monitored channel goes live |
| Recording Started | Recording has begun |
| Recording Complete | Recording finished successfully |
| Recording Failed | Recording encountered an error |
| Processing Complete | Post-processing finished |
| Storage Warning | Approaching storage limit |
| Storage Full | Storage quota reached |
Discord Webhooks
Send notifications to a Discord channel.
Setup
Create Webhook
In Discord: Server Settings → Integrations → Webhooks → New Webhook
Copy URL
Copy the webhook URL
Add to Battles Record
Navigate to Settings → Notifications → Discord and paste the URL
Configure Events
Select which events should trigger Discord notifications
Test
Click Send Test to verify the webhook works
| Field | Description |
|---|
| Title | Event type (e.g., “Recording Started”) |
| Channel | Streamer name |
| Platform | Twitch/YouTube/Kick icon |
| Stream Title | Current stream title |
| Category | Game or category |
| Quality | Recording quality |
| Thumbnail | Stream thumbnail image |
Customization
Customize Discord messages in Settings → Notifications → Discord → Format:
| Option | Description |
|---|
| Include Thumbnail | Attach stream thumbnail |
| Include Link | Add link to stream |
| Mention Role | @mention a role for certain events |
| Color | Embed color by event type |
Telegram
Send notifications to a Telegram chat or channel.
Setup
Get Token
Copy the bot token provided by BotFather
Get Chat ID
Add the bot to your channel/group, then use @userinfobot to get the
chat ID Configure
Navigate to Settings → Notifications → Telegram and enter token + chat ID
Test
Click Send Test to verify the bot works
- Event type emoji
- Channel name and platform
- Stream title
- Recording details
- Thumbnail (optional)
Bot Commands
Your Telegram bot responds to commands:
| Command | Description |
|---|
/status | Show active recordings |
/channels | List monitored channels |
/storage | Show storage usage |
/pause {channel} | Pause recording |
/resume {channel} | Resume recording |
Generic Webhooks
Send notifications to any HTTP endpoint.
Setup
Add Webhook
Navigate to Settings → Notifications → Webhooks → Add Webhook
Configure Endpoint
Enter the URL and authentication method
Select Events
Choose which events trigger the webhook
Test
Click Send Test to verify the endpoint
{
"event": "recording.started",
"timestamp": "2026-02-02T14:30:00Z",
"data": {
"channel": "shroud",
"platform": "twitch",
"title": "Valorant Ranked",
"category": "Valorant",
"quality": "1080p60",
"recording_id": "abc123"
}
}
Authentication
| Method | Description |
|---|
| None | No authentication |
| Bearer Token | Authorization header with token |
| Basic Auth | Username/password |
| Custom Header | Any custom header |
Retry Policy
Failed webhooks are retried:
- 3 attempts with exponential backoff
- Delays: 1s, 5s, 30s
- Failed webhooks logged to console
Push Notifications (Desktop)
Desktop application supports system notifications:
Windows
Uses Windows Toast notifications. Appears in Action Center.
Linux
Uses system notification daemon (libnotify).
Configuration
| Setting | Description |
|---|
| Enable | Toggle push notifications |
| Sound | Play notification sound |
| Events | Which events trigger push |
Email Notifications
Email notifications require SMTP configuration.
Configure SMTP
Navigate to Settings → Notifications → Email and enter: - SMTP server and port - Username
and password - From address
Add Recipients
Enter email addresses to receive notifications
Select Events
Choose which events send emails
Notification Filters
Control notification volume:
Per-Channel Settings
Go to Channels
Select a channel
Notification Settings
Toggle which notifications this channel triggers
Quiet Hours
Suppress notifications during specific hours:
| Setting | Description |
|---|
| Start | When quiet hours begin |
| End | When quiet hours end |
| Exceptions | Events that ignore quiet hours |
Rate Limiting
Prevent notification spam:
| Setting | Description |
|---|
| Cooldown | Minimum time between notifications |
| Batch | Group notifications within a time window |
Testing
Test your notification configuration:
Go to Settings
Navigate to Settings → Notifications
Select Service
Click Send Test on any configured service
Verify
Check that the test notification arrived
