Add YouTube quickstart guide

astro.config.mjs

@@ -298,6 +298,18 @@ export default defineConfig({
                 { label: 'Getting started', items: [
                   { label: 'Install and connect', slug: 'selive/getting-started' },
                 ] },
+                {
+                  label: 'YouTube Quickstart',
+                  collapsed: true,
+                  items: [
+                    { label: 'Overview', slug: 'selive/guides/youtube-quickstart' },
+                    { label: '1. Create Your Account', slug: 'selive/guides/youtube-quickstart/create-your-account' },
+                    { label: '2. Dashboard Tour', slug: 'selive/guides/youtube-quickstart/dashboard-tour' },
+                    { label: '3. Build Your Overlay', slug: 'selive/guides/youtube-quickstart/build-your-overlay' },
+                    { label: '4. Connect OBS & Go Live', slug: 'selive/guides/youtube-quickstart/connect-obs-and-go-live' },
+                    { label: '5. Set Up Your Chatbot', slug: 'selive/guides/youtube-quickstart/set-up-your-chatbot' },
+                  ],
+                },
                 { label: 'Guides', items: [
                   { label: 'Add overlays and alerts', slug: 'selive/guides/overlays-and-alerts' },
                   { label: 'Create a vertical canvas', slug: 'selive/guides/canvas' },

src/content/docs/selive/guides/index.mdx

@@ -8,6 +8,7 @@ import { CardGrid, LinkCard } from '@astrojs/starlight/components';
 ## Platform setup
 
 <CardGrid>
+  <LinkCard title="YouTube quickstart" href="/selive/guides/youtube-quickstart" description="Set up your YouTube account, overlay, OBS, and chatbot." />
   <LinkCard title="Set up SE.Live for YouTube" href="/selive/guides/youtube-setup" description="Connect your account, stream key, overlay, and chatbot for YouTube." />
 </CardGrid>
 

src/content/docs/selive/guides/youtube-quickstart/build-your-overlay.mdx

@@ -0,0 +1,61 @@
+---
+title: "YouTube Quickstart: Build Your Overlay"
+sidebar:
+  label: "3. Build Your Overlay"
+description: "Create a YouTube overlay from a theme or a blank canvas, then add Super Chat alerts."
+platforms: [youtube]
+keywords:
+  - StreamElements YouTube overlay
+  - StreamElements AlertBox YouTube
+  - YouTube Super Chat alert
+---
+
+import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+An overlay adds graphics and alerts to your stream. If yours is ready, continue to [4. Connect OBS and Go Live](/selive/guides/youtube-quickstart/connect-obs-and-go-live).
+
+## Create an overlay
+
+To use a theme:
+
+<Steps>
+
+1. Go to the [Themes Gallery](https://streamelements.com/dashboard/themes) and open the **Theme** tab.
+2. Choose the **YouTube Theme**. Use the static version to reduce CPU usage.
+3. Click **Create** and give it a name.
+
+</Steps>
+
+![Overlay themes in the Themes Gallery](/img/youtube-quickstart/overlay-gallery.jpg)
+
+To start with a blank overlay, go to [Overlays](https://streamelements.com/dashboard/overlays) and click **New overlay**. Choose a resolution that matches your stream, such as 1920x1080, then click **Start**. If you saved an overlay during account setup, you can open that one instead.
+
+![Empty My Overlays page with the New overlay button](/img/youtube-quickstart/my-overlays.jpg)
+
+## Set up your AlertBox for Super Chats
+
+The AlertBox displays alerts on your stream. Open your overlay and select its AlertBox. If it doesn't have one yet, click **+** in the editor and choose **Alerts → AlertBox**.
+
+![Overlay editor with the widget picker open](/img/youtube-quickstart/overlay-editor.jpg)
+
+Open the AlertBox settings and enable **SuperChat**.
+
+:::note[Subscriber and membership alerts]
+New subscribers and memberships don't trigger AlertBox alerts on YouTube. Leave those alert types unchecked.
+:::
+
+Save the overlay. You'll add its URL to OBS next.
+
+## Next
+
+<CardGrid>
+  <LinkCard title="4. Connect OBS and Go Live" href="/selive/guides/youtube-quickstart/connect-obs-and-go-live" description="Install SE.Live, connect your YouTube account, and add this overlay to your scene." />
+</CardGrid>
+
+## Related
+
+<CardGrid>
+  <LinkCard title="Getting Started with Overlays" href="/overlays/getting-started" description="Add an AlertBox or Custom Widget in the Overlay Editor." />
+  <LinkCard title="Add an Overlay to Your Broadcast Software" href="/overlays/broadcast-software" description="Add an overlay URL as a browser source in OBS or XSplit." />
+  <LinkCard title="AlertBox Alert Variations" href="/overlays/alertbox-variations" description="Change alert images, sounds, and messages for each event." />
+</CardGrid>

src/content/docs/selive/guides/youtube-quickstart/connect-obs-and-go-live.mdx

@@ -0,0 +1,144 @@
+---
+title: "YouTube Quickstart: Connect OBS and Go Live"
+sidebar:
+  label: "4. Connect OBS & Go Live"
+description: "Install SE.Live, connect YouTube to OBS, add your camera, microphone, and overlay, and start streaming."
+platforms: [youtube]
+keywords:
+  - SE.Live YouTube setup
+  - StreamElements YouTube stream key
+  - connect OBS to YouTube
+---
+
+import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+Connect OBS to YouTube and add your overlay as a browser source. If you're already streaming with your overlay, continue to [5. Set Up Your Chatbot](/selive/guides/youtube-quickstart/set-up-your-chatbot).
+
+## Install SE.Live
+
+SE.Live is a StreamElements plugin that adds chat, the Activity Feed, and stream controls to OBS.
+
+**Requirements:** OBS Studio 31.x or newer. SE.Live is available for Windows, with a macOS beta.
+
+![Desktop Apps page with the SE.Live download](/img/youtube-quickstart/desktop-apps.jpg)
+
+<Steps>
+
+1. Download the installer for your operating system from the [SE.Live page](https://streamelements.com/selive). Choose the Mac beta for macOS.
+2. Close OBS, then run the installer and choose your install folder.
+3. Reopen OBS. On Windows, run it **as Administrator**. Look for the **StreamElements** menu in the menu bar.
+
+</Steps>
+
+## Connect your channel to SE.Live
+
+The first time SE.Live opens in OBS, it asks you to connect a channel.
+
+![SE.Live channel sign-in options in OBS](/img/youtube-quickstart/connect-channel.webp)
+
+<Steps>
+
+1. Click **YOUTUBE**, sign in with Google, and select your channel.
+2. On the **I'd like to start with...** screen, choose **New setup**. To stream to several platforms, choose **Multi-streaming Setup** and follow the [multistreaming guide](/selive/guides/multistreaming).
+
+</Steps>
+
+![SE.Live welcome screen with New setup and Multi-streaming Setup options](/img/youtube-quickstart/setup-wizard-start.png)
+
+## Run the setup wizard
+
+The **New setup** wizard adds your microphone, camera, and display capture to OBS.
+
+<Steps>
+
+1. **Camera & microphone.** Select your devices, or choose **No camera**. Click **Next**.
+
+   ![Microphone and camera selection in the setup wizard](/img/youtube-quickstart/wizard-camera-mic.png)
+
+2. **Display capture.** Select the display you want to stream and click **Next**. You can switch to game capture later.
+
+   ![Display selection in the setup wizard](/img/youtube-quickstart/wizard-display-capture.png)
+
+3. Click **Finish setup**.
+
+</Steps>
+
+![Finish setup button on the last wizard screen](/img/youtube-quickstart/wizard-finish.png)
+
+## Connect OBS to YouTube
+
+In OBS, open **Settings → Stream**, choose **YouTube - RTMPS**, and click **Connect Account**. Follow the Google sign-in prompts and select the channel you want to stream to. If OBS already shows the correct channel, keep that connection.
+
+### Use a stream key instead
+
+If you connected your YouTube account in OBS, skip this step. To connect with a stream key instead:
+
+<Steps>
+
+1. In [YouTube Studio](https://studio.youtube.com/), select **Create → Go Live** and open the **Stream** tab. Create a stream if you don't have one yet, then copy its stream key.
+2. In OBS, open **Settings → Stream**, choose **YouTube - RTMPS**, and select **Use Stream Key**. Paste the key and save your settings.
+
+</Steps>
+
+:::caution[Keep your stream key private]
+Anyone with your stream key can stream to your channel. Don't share it or show it on stream.
+:::
+
+## Add your overlay
+
+<Steps>
+
+1. Open **My Overlays** in StreamElements. Find the [overlay you created earlier](/selive/guides/youtube-quickstart/build-your-overlay), open its menu, and select **Copy URL**.
+2. In OBS **Sources**, click **+ → Browser**, name the source, and paste the URL.
+3. Set **Width** and **Height** to match your overlay (`1920` and `1080` if you used the default resolution). Check **Shutdown when source not visible** and click **OK**.
+
+</Steps>
+
+## Open chat and stream controls
+
+Open **StreamElements → SE.Live Docks** and choose the panels you want to show.
+
+**Canvas** shows a preview and scene list for a [canvas](/selive/guides/canvas), including vertical layouts.
+
+![Canvas dock with a vertical preview and scene list](/img/youtube-quickstart/canvas-dock.png)
+
+**YouTube Chat** shows chat messages while you're live. It also links to **Live Video Settings** and the **Live Dashboard**.
+
+![YouTube Chat dock before the stream starts](/img/youtube-quickstart/youtube-chat-dock.png)
+
+**Multi-Streaming** lists your connected destinations. Turn each destination on or off before you go live.
+
+![Multi-Streaming dock with two YouTube destinations enabled](/img/youtube-quickstart/multistreaming-dock.png)
+
+**Activity Feed** shows the same events and alert controls as the [dashboard feed](/selive/guides/youtube-quickstart/dashboard-tour#the-activity-feed).
+
+![Activity Feed dock with alert controls and no recent events](/img/youtube-quickstart/activity-feed-dock.png)
+
+Drag the panels to arrange them around your OBS preview.
+
+![OBS preview surrounded by Activity Feed, Canvas, Multi-Streaming, and YouTube Chat docks](/img/youtube-quickstart/obs-docks-layout.webp)
+
+## Go live
+
+<Steps>
+
+1. If you connected your YouTube account, use **Manage Broadcast** to create or select a broadcast. If you used a stream key, open that stream in YouTube Studio. Check the title, category, and privacy setting before starting.
+2. Click **Start Streaming** in OBS. Depending on your broadcast settings, you may also need to click **Go Live** in YouTube Studio. Check YouTube to confirm the stream is live.
+
+</Steps>
+
+See the [OBS YouTube guide](https://obsproject.com/forum/resources/how-to-stream-to-youtube-with-obs-studio.232/) for account connection options and [YouTube's encoder guide](https://support.google.com/youtube/answer/2907883) for stream key setup.
+
+## Next
+
+<CardGrid>
+  <LinkCard title="5. Set Up Your Chatbot" href="/selive/guides/youtube-quickstart/set-up-your-chatbot" description="Add the bot as a moderator and create your first command." />
+</CardGrid>
+
+## Related
+
+<CardGrid>
+  <LinkCard title="Install and connect SE.Live" href="/selive/getting-started" description="Install SE.Live and use its menus, docks, and backups." />
+  <LinkCard title="SE.Live troubleshooting" href="/selive/troubleshooting" description="Fix missing docks, login problems, and crashes." />
+  <LinkCard title="Set up multistreaming" href="/selive/guides/multistreaming" description="Stream to YouTube and other platforms at the same time." />
+</CardGrid>

src/content/docs/selive/guides/youtube-quickstart/create-your-account.mdx

@@ -0,0 +1,60 @@
+---
+title: "YouTube Quickstart: Create Your Account"
+sidebar:
+  label: "1. Create Your Account"
+description: "Create a StreamElements account with your YouTube channel and set up the chatbot, tipping, an overlay, and SE.Live."
+platforms: [youtube]
+keywords:
+  - StreamElements YouTube sign up
+  - StreamElements YouTube setup
+  - StreamElements initial setup
+---
+
+import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+Use your YouTube account to sign up for StreamElements. If you've already signed up, continue to [2. Dashboard Tour](/selive/guides/youtube-quickstart/dashboard-tour).
+
+:::note[Before you begin]
+You need to [enable live streaming on YouTube](/getting-started/youtube-live) before your first stream. This includes phone verification, and [activation can take up to 24 hours](https://support.google.com/youtube/answer/2907883). Start that now; you can set up StreamElements while you wait.
+:::
+
+## Sign up with YouTube
+
+<Steps>
+
+1. Go to [streamelements.com](https://streamelements.com/) and click **Get Started** or **Login**.
+2. Choose **YouTube** and authorize StreamElements to access your channel.
+
+</Steps>
+
+Your dashboard opens after you sign in. It shows existing totals, such as your subscriber count, but the Activity Feed won't include events from before you connected your account.
+
+:::note[YouTube feature limits]
+The [Loyalty system](/loyalty) isn't available on YouTube. This includes points, the Stream Store, giveaways, and viewer queues.
+:::
+
+## Complete the setup wizard
+
+Click **Continue** in the setup bar at the top of your dashboard.
+
+<Steps>
+
+1. **Activate the chatbot.** Click **Activate**. You'll also need to add the bot as a moderator in [5. Set Up Your Chatbot](/selive/guides/youtube-quickstart/set-up-your-chatbot). The bot joins when your stream is public and live.
+2. **Set up tipping.** Enter your PayPal email and connect your tipping page. See [Tipping](/revenue/tipping) for other payment options.
+3. **Create your first overlay.** Choose **Create**, keep the resolution at 1080p, and click **Start**. Save the overlay. You'll add alerts in [3. Build Your Overlay](/selive/guides/youtube-quickstart/build-your-overlay).
+4. **Download SE.Live.** Click **Download** to get the OBS plugin. The installation steps are in [4. Connect OBS and Go Live](/selive/guides/youtube-quickstart/connect-obs-and-go-live).
+
+</Steps>
+
+## Next
+
+<CardGrid>
+  <LinkCard title="2. Dashboard Tour" href="/selive/guides/youtube-quickstart/dashboard-tour" description="Check stream stats, manage alerts, and find your account settings." />
+</CardGrid>
+
+## Related
+
+<CardGrid>
+  <LinkCard title="Create Your Account" href="/getting-started/account-setup" description="Account setup for each supported platform." />
+  <LinkCard title="Enable Live Streaming on YouTube" href="/getting-started/youtube-live" description="Verify your phone number and activate live streaming." />
+</CardGrid>

src/content/docs/selive/guides/youtube-quickstart/dashboard-tour.mdx

@@ -0,0 +1,58 @@
+---
+title: "YouTube Quickstart: Take the Dashboard Tour"
+sidebar:
+  label: "2. Dashboard Tour"
+description: "Check your YouTube stream stats, manage alerts in the Activity Feed, and find your StreamElements account settings."
+platforms: [youtube]
+keywords:
+  - StreamElements dashboard
+  - StreamElements Activity Feed
+---
+
+import { Steps, CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+The dashboard shows your stream stats and recent activity. If you already know your way around, continue to [3. Build Your Overlay](/selive/guides/youtube-quickstart/build-your-overlay).
+
+## The main dashboard
+
+The home page shows subscribers, Super Chats, tips, and average viewership. Choose a time period from the top bar to change the stats and graph.
+
+On the right, check whether the chatbot has joined your channel. **Part** removes it from chat; **Mute** stops it from posting. You can also edit your stream title and category here.
+
+![The StreamElements dashboard home screen](/img/youtube-quickstart/dashboard-home.jpg)
+
+## The top bar
+
+Your profile picture appears at the top right of each dashboard page, with a red ring while you're live. Click it to change your language or theme, import settings, or open SE.Live and Ground Control.
+
+## The Activity Feed
+
+The [Activity Feed](https://streamelements.com/dashboard/activity) lists individual events as they happen. You can mute or skip alerts, check chatbot status, and reset session settings here.
+
+![Activity Feed with recent events and alert controls](/img/youtube-quickstart/dashboard-activity-feed.jpg)
+
+To filter the feed:
+
+<Steps>
+
+1. Click **Filter**.
+2. Choose which event types you want to see.
+3. Click **Filter** to apply.
+
+</Steps>
+
+You can also open the Activity Feed in OBS through [SE.Live](/selive).
+
+If you've connected several channels, see [Multiplatform Activity Feed](/getting-started/dashboard-overview#multiplatform-activity-feed) for filtering options and limits on showing the feed on stream.
+
+## Next
+
+<CardGrid>
+  <LinkCard title="3. Build Your Overlay" href="/selive/guides/youtube-quickstart/build-your-overlay" description="Create an overlay and set up your AlertBox for Super Chats." />
+</CardGrid>
+
+## Related
+
+<CardGrid>
+  <LinkCard title="Dashboard & Activity Feed" href="/getting-started/dashboard-overview" description="Dashboard controls and event filtering across platforms." />
+</CardGrid>

src/content/docs/selive/guides/youtube-quickstart/index.mdx

@@ -0,0 +1,20 @@
+---
+title: "YouTube Quickstart"
+description: "Set up StreamElements for YouTube: create an account, add an overlay to OBS, and connect the chatbot."
+platforms: [youtube]
+keywords:
+  - StreamElements YouTube setup guide
+  - how to stream on YouTube with StreamElements
+---
+
+import { CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+Connect your YouTube channel to StreamElements, add an overlay to OBS, and set up the chatbot. Follow the pages in order, or skip the steps you've already finished.
+
+<CardGrid>
+  <LinkCard title="1. Create Your Account" href="/selive/guides/youtube-quickstart/create-your-account" description="Sign in with YouTube and complete the setup wizard." />
+  <LinkCard title="2. Dashboard Tour" href="/selive/guides/youtube-quickstart/dashboard-tour" description="Check stream stats, manage alerts, and find your account settings." />
+  <LinkCard title="3. Build Your Overlay" href="/selive/guides/youtube-quickstart/build-your-overlay" description="Create an overlay and set up your AlertBox for Super Chats." />
+  <LinkCard title="4. Connect OBS & Go Live" href="/selive/guides/youtube-quickstart/connect-obs-and-go-live" description="Install SE.Live, connect YouTube, and add your overlay to OBS." />
+  <LinkCard title="5. Set Up Your Chatbot" href="/selive/guides/youtube-quickstart/set-up-your-chatbot" description="Add the bot as a moderator and create your first command." />
+</CardGrid>