Skip to main content

Connect YouTube Live

This guide walks you through connecting YouTube Live Chat so Super Chats land in the donation queue and regular chat flows into the Live Chat feed in real time.

YouTube uses OAuth 2.0, which means you need to create your own Project in the Google Cloud Console and grab a Client ID + Secret first — it's a one-time setup.

What you'll need​

  • A Google Account (the one you use to live stream)
  • Access to the Google Cloud Console
  • A YouTube channel with Live Streaming enabled (for actual testing)

Step 1 — Create OAuth credentials in Google Cloud Console​

  1. Go to console.cloud.google.com and create a new Project (or reuse an existing one)
  2. Open APIs & Services → Library → search for YouTube Data API v3 → click Enable
  3. Back to APIs & Services → Credentials
  4. Click + Create Credentials → OAuth client ID → choose Desktop app as the type
  5. Give it a name (e.g. "Mor9an") → Create
  6. Copy the Client ID and Client Secret you get back

:::tip OAuth Consent Screen The first time, you may need to set up the OAuth consent screen — choose External, fill in the app name and email, and the youtube.readonly scope is enough. If the project is still in Testing mode, add your Google account to the Test users list. :::

Step 2 — Paste Client ID / Secret into the app​

  1. In the app, head to Settings → Connections
  2. Scroll to the YouTube section
  3. Paste your Client ID and Client Secret into the matching fields
  4. Click Save

Step 3 — Click Connect YouTube and approve the OAuth flow​

  1. Click Connect YouTube
  2. A Google popup opens in your browser
  3. Sign in with the Google Account you use to live stream
  4. Click Allow to grant the app access to your YouTube data
  5. The window bounces back to the app — the YouTube status dot should flip to green

Step 4 — (Optional) Enable Test Mode​

The YouTube section has a Test Mode toggle — when on, every regular chat message is treated like a 0-baht donation, queued, and read aloud by TTS just like a Super Chat.

Useful for:

  • Testing the pipeline before going live
  • Dev/small chat rooms where you want the app to read everything

:::warning Turn Test Mode off before going live Otherwise the app reads every single chat message via TTS — burns through your TTS quota and gets annoying for viewers fast. :::

Tips & Troubleshooting​

  • OAuth shows "App is not verified": if your project is still in Testing mode, click Advanced → Go to (unsafe) to continue, or add yourself as a Test User.
  • Connected but no chat: YouTube Live Chat only works while you're actually broadcasting — start the live stream and try again.
  • Quota exceeded: YouTube Data API has a daily quota (10,000 units by default). If you hit the limit, request an increase in the Cloud Console.
  • Lost the Client Secret: go back to Cloud Console → Credentials → click the download icon on the OAuth client ID to view it again.

See also​