Skip to content

Settings YouTube

Jump to bottom
ekudram edited this page Nov 6, 2025 · 1 revision

YouTube Settings

YouTube Settings Tab

The YouTube Settings tab configures integration with YouTube Live chat. Note: Full functionality currently requires Google API verification, but basic chat reading is available.

⚠️ Important Notice

YouTube API Verification Status: Currently limited due to Google's API verification requirements. Basic chat reading works, but full OAuth functionality may be restricted.

⚙️ Basic Configuration

Enable YouTube Integration

  • Purpose: Turns YouTube integration on/off
  • Default: Disabled
  • Effect: When enabled, connects to YouTube Live chat

Auto-connect on Startup

  • Purpose: Automatically connect to YouTube when RimWorld loads
  • Default: Disabled
  • Recommended: Enable for regular YouTube streamers

📺 Channel Configuration

Channel ID

  • Purpose: Your unique YouTube channel identifier
  • Format: Starts with UC followed by random characters
  • Example: UC_x1234567890abcdef
  • How to Find:
    • Click "Find ID" button
    • Use external tools like Comment Picker
    • Look in YouTube Studio under Advanced settings

Bot Username

  • Purpose: Your YouTube channel display name
  • Format: Your public channel name as it appears on YouTube
  • Example: MyGamingChannel
  • Note: This is for display purposes only

🔐 API Configuration

API Key

  • Purpose: YouTube Data API v3 key for accessing chat
  • Security: Displayed as asterisks (********) for protection
  • How to Get:
    1. Click "Get" button to open Google Cloud Console
    2. Create a new project or select existing
    3. Enable YouTube Data API v3
    4. Create credentials (API Key)
    5. Copy and paste using "Paste" button

API Key Preview

  • Purpose: Verify your API key is correctly set
  • Display: Shows first 10 characters of your key
  • Example: AIzaSyC6vK...

🔑 OAuth Configuration

OAuth Client Secrets

  • Purpose: For sending messages and full chat interaction
  • Status Indicators:
    • ✓ Ready - Green: OAuth configuration file exists
    • ✗ No OAuth - Yellow: Basic chat reading only
    • ⚠ May require Google verification - Warning about API limits

OAuth Setup

  1. Click "Create" or "Edit" button
  2. Configure OAuth 2.0 credentials in Google Cloud Console
  3. Download client_secrets.json file
  4. Use the editor to configure OAuth settings

Current Limitations

  • Chat Reading: Works with just API Key + Channel ID
  • Sending Messages: Requires verified OAuth (currently restricted)
  • Google Verification: May be required for full functionality

📊 API Quota Management

Quota Display

  • Purpose: Monitor your YouTube API usage
  • Appears When: Connected to YouTube
  • Shows:
    • Current quota percentage
    • Visual progress bar
    • Usage warnings

Quota Colors

  • Green: Normal usage (< 80%)
  • Yellow: High usage (80-95%)
  • Red: Near limit (> 95%)

Quota Conservation Tips

  • Reduce chat polling frequency if needed
  • Monitor usage during long streams
  • Consider API quota limits for your Google Cloud project

🔌 Connection Management

Connection Status

  • Connected - Green: Successfully connected to YouTube Live chat
  • Disconnected - Red: Not currently connected

Connection Requirements

Minimum for Chat Reading:

  • ✅ Channel ID
  • ✅ API Key
  • ✅ Bot Username

Full Functionality (currently limited):

  • ✅ OAuth Client Secrets
  • ✅ Google API Verification

Connection Controls

  • Connect: Establish YouTube connection
  • Disconnect: Close current connection

🛠️ Setup Guide

Basic Setup (Chat Reading Only)

  1. Enable YouTube Integration
  2. Find and enter your Channel ID
  3. Enter your channel display name as Bot Username
  4. Get API Key from Google Cloud Console
  5. Paste API Key
  6. Click Connect

Advanced Setup (When Available)

  1. Complete basic setup above
  2. Create OAuth Client Secrets
  3. Configure OAuth in the editor
  4. Complete Google verification process

🔄 Related Settings

📋 Recommended Configurations

For Current Functionality

  • Enable YouTube: ✅
  • Channel ID: [Your UC... ID]
  • Bot Username: [Your channel name]
  • API Key: [Your API key]
  • OAuth: ❌ (Use basic chat reading)
  • Auto-connect: ❌

When Full OAuth Available

  • Enable YouTube: ✅
  • Channel ID: [Your UC... ID]
  • Bot Username: [Your channel name]
  • API Key: [Your API key]
  • OAuth: ✅ (Configured and verified)
  • Auto-connect: ✅

For Testing

  • Enable YouTube: ✅
  • Channel ID: [Test channel ID]
  • Bot Username: [Test channel]
  • API Key: [Test API key]
  • OAuth: ❌
  • Auto-connect: ❌

💡 Troubleshooting Tips

  • "Channel not found": Double-check Channel ID format (starts with UC)
  • API errors: Verify API Key is valid and YouTube Data API v3 is enabled
  • OAuth issues: Google verification may be required for full functionality
  • Quota exceeded: Reduce polling frequency or upgrade Google Cloud plan

Next: Economy Settings - Configure coins, karma, and reward systems

Clone this wiki locally