Integrations & Analytics

Twitch & YouTube Notifications

Get notified in Discord whenever a Twitch streamer goes live or a YouTube channel uploads a new video.

Free tier: one alert per service Social Alerts are part of the permanent free tier. A server with no active plan keeps one Twitch alert and one YouTube alert, with everything behind them — the go-live check, the upload check, the rich embed and custom messages. Pro raises that to 3 per service. Extra alerts configured on Pro are never deleted when a plan lapses: they are kept, marked 🔒 Not posting on the dashboard, and start posting again on renewal. For each service the alert you added first is the one that keeps posting — remove it to hand the slot to the next.

Server Requirements Twitch and YouTube API keys must be configured in the bot's environment variables (TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET). If these are blank, the social module is disabled globally.

Twitch Notifications

addtwitch <username> <channel>

Subscribe to a Twitch streamer. When they go live, a notification embed is posted in the specified Discord channel. Custom message supported.

removetwitch <username>

Remove live notifications for a specific Twitch streamer.

YouTube Notifications

addyoutube <channel-id> <notify-channel>

Subscribe to a YouTube channel. New video uploads trigger a notification embed in the Discord channel. Use the YouTube channel ID (starts with UC…).

removeyoutube <channel-id>

Remove YouTube upload notifications for a channel.

socials

List all active Twitch and YouTube integrations for this server — shows platform, streamer/channel name, notify channel, and enabled status.

How Polling Works

Poller runs every few minutes

→

Check Twitch / YouTube API

→

New stream / video detected?

→

Post notification embed

The bot tracks the last known event ID per integration to avoid duplicate notifications. If the bot restarts, polling resumes automatically from the clientReady event.

Notification Embed

The notification includes the streamer/creator name, stream title or video title, thumbnail, and a direct link. You can set a custom message text per integration to customize the ping (e.g. @everyone is live!).

Managing via Dashboard

Go to Dashboard → Social for a full management UI — add, remove, enable/disable integrations, and set custom notification messages — without any commands.

Analytics

30-day charts tracking your server's activity, growth, and moderation — visible in the dashboard with interactive Chart.js graphs.

Required Plan The Analytics dashboard page requires the analytics feature on a Pro subscription. The /stats command is always available.

Dashboard Charts

👥 Member Count

Daily snapshot of total server member count over 30 days — spot growth and churn trends.

Messages Sent

Daily total message volume across all tracked channels.

Joins & Leaves

Daily new member joins and leaves side by side — correlate with events or announcements.

Mod Actions

Breakdown of moderation actions: warns, bans, kicks, timeouts, automod triggers.

/stats Command

stats

Post a server analytics embed showing member count, total messages, joins, leaves, and mod actions. Useful for a public #server-info channel. Available without the analytics Pro feature.

Data Tracked

Metric	Granularity	Retention
Member count, messages, joins, leaves, voice minutes	Daily	Indefinite
Active users (unique per day)	Daily	Indefinite
Messages per hour	Hourly (0–23)	Indefinite
Messages per channel	Daily per channel	Indefinite

Data starts from bot join date Analytics data begins accumulating from the day the bot joins your server. There is no retroactive data for activity before the bot was added.