youtubeSocial

Configure YouTube, Twitch, and RSS feed notifications

Introduction

The Social configuration file (social.json) manages notifications for YouTube uploads, Twitch streams, and RSS feeds.


YouTube Notification

Notify your server when YouTube channels upload new videos.

enabled

Type: Boolean

Whether to enable YouTube notifications.

youtube_notification: {
    enabled: false,
}

youtube_api_key

Type: String

Google API key for YouTube API V3.

How to get an API key: https://elfsight.com/blog/how-to-get-youtube-api-key-tutorial/


subscribed_channels

Type: Array of Objects

YouTube channels to monitor for new uploads.

youtube_channel_username - Exact YouTube username (case-sensitive) discord_channel_id - Where to send upload notifications mention_roles - Array of role IDs to ping on new uploads

circle-exclamation

Twitch Notification

Notify your server when Twitch streamers go live.

enabled

Type: Boolean

Whether to enable Twitch notifications.


twitch_client_id

Type: String

Your Twitch application client ID.

How to get credentials:

  1. Visit https://dev.twitch.tv/console/apps

  2. Create a new application

  3. Set OAuth Redirect URLs to http://localhost

  4. Select category "ChatBot"

  5. Copy the Client ID from the management page


twitch_client_secret

Type: String

Your Twitch application client secret.

Found on the same management page as the Client ID.


pingable_role_id

Type: String

Role ID to mention when streamers go live.

Leave empty to disable role pings.


enable_raid_notifications

Type: Boolean

Whether to send notifications when raids occur.


delete_embeds_on_offline

Type: Boolean

Automatically delete live notifications when stream ends.

When true: Live embeds are deleted when streamer goes offline When false: Embeds remain in the channel


RSS Feeds

Monitor RSS feeds and post updates to Discord.

enabled

Type: Boolean

Whether to enable RSS feed monitoring.


feeds

Type: Array of Objects

RSS feeds to monitor.

name - Feed name used in embed title url - RSS feed URL channel_id - Discord channel for feed posts mention_roles - Array of role IDs to ping (leave empty to disable)


Complete Configuration Example

Here's a production-ready social configuration:

Last updated