Social

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.

youtube_api_key: "YOUR_API_KEY_HERE"

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.

subscribed_channels: [
    {
        youtube_channel_username: "Iynx",
        discord_channel_id: "804354119523500082",
        mention_roles: ["884573835205148692"],
    },
]

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

Important: The YouTube username must match exactly (case-sensitive) or the channel will fail to load.

---

Twitch Notification

Notify your server when Twitch streamers go live.

enabled

Type: Boolean

Whether to enable Twitch notifications.

twitch_notification: {
    enabled: false,
}

---

twitch_client_id

Type: String

Your Twitch application client ID.

twitch_client_id: "YOUR_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.

twitch_client_secret: "YOUR_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.

pingable_role_id: "884573835205148692"

Leave empty to disable role pings.

---

enable_raid_notifications

Type: Boolean

Whether to send notifications when raids occur.

enable_raid_notifications: true

---

delete_embeds_on_offline

Type: Boolean

Automatically delete live notifications when stream ends.

delete_embeds_on_offline: true

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.

rss_feeds: {
    enabled: false,
}

---

feeds

Type: Array of Objects

RSS feeds to monitor.

feeds: [
    {
        name: 'Feed One',
        url: "https://rss.nytimes.com/services/xml/rss/nyt/US.xml",
        channel_id: "1274005906610454619",
        mention_roles: ["884573835205148692"],
    },
]

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:

{
    config: {
        youtube_notification: {
            enabled: true,
            youtube_api_key: "AIzaSyXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            subscribed_channels: [
                {
                    youtube_channel_username: "Iynx",
                    discord_channel_id: "804354119523500082",
                    mention_roles: ["884573835205148692"],
                },
            ]
        },

        twitch_notification: {
            enabled: true,
            twitch_client_id: "your_client_id_here",
            twitch_client_secret: "your_client_secret_here",
            pingable_role_id: "884573835205148692",
            enable_raid_notifications: true,
            delete_embeds_on_offline: true,
        },

        rss_feeds: {
            enabled: true,
            feeds: [
                {
                    name: 'Server News',
                    url: "https://example.com/rss",
                    channel_id: "1274005906610454619",
                    mention_roles: [],
                },
            ],
        }
    }
}