Platform

YouTube

Full YouTube Live integration with real-time chat, Super Chat and membership support, broadcast management, video and playlist control, and comprehensive API access.

Overview

FaustBot provides deep integration with YouTube Live through the YouTube Data API and Live Streaming API, enabling real-time chat interaction and complete control over your broadcasts.

Live Chat

Real-time chat messages, Super Chats, and stickers.

Memberships

New member events and membership gifts.

Broadcast Control

Update title, description, privacy, and more.

Moderation

Ban, timeout, and manage moderators.

Video Management

Update videos, manage playlists.

Channel Analytics

Subscriber count, views, and statistics.

Setup

Connecting Your YouTube Account

Open YouTube Settings

In FaustBot, navigate to Platforms in the sidebar and select YouTube.

Login with Google

Click Login with Google. A browser window will open for you to sign in to your Google account and authorize FaustBot.

Screenshot: Google OAuth authorization

Grant Permissions

Review and accept the requested permissions. FaustBot needs access to your YouTube account to manage broadcasts, read chat, and perform moderation actions.

Automatic Connection

Once authorized, FaustBot will automatically connect and start monitoring your live broadcasts. Enable Auto-Connect to reconnect automatically when FaustBot starts.

Broadcast Detection

FaustBot automatically detects when you go live on YouTube and begins monitoring your live chat. No additional configuration is required.

Triggers

React to real-time events from your YouTube Live stream:

Chat Events

Chat Message Message sent in live chat

Super Chat Paid Super Chat message received

Super Sticker Paid Super Sticker sent

First Words User's first message of the stream

Membership Events

New Member Someone became a channel member

Membership Gift Memberships were gifted

Member Milestone Member anniversary celebration

Broadcast Events

Broadcast Started Your stream went live

Broadcast Ended Your stream ended

Viewer Count Update Live viewer count changed

Channel Events

New Subscriber Someone subscribed to your channel

New Comment Comment on your video

Effects

Chat Effects

Send Message

Send to live chat.

Delete Message

Remove a chat message.

Pin Message

Pin message to top of chat.

Unpin Message

Remove pinned message.

Highlight Message

Highlight a Super Chat.

Moderation Effects

Ban User

Permanently ban from chat.

Unban User

Remove a ban.

Timeout

Temporarily ban a user.

Add Moderator

Grant moderator status.

Remove Moderator

Revoke moderator status.

Chat Mode Effects

Slow Mode

Limit message frequency.

Members-Only

Restrict to members only.

Broadcast Effects

Set Title

Change stream title.

Set Description

Update stream description.

Set Category

Change stream category.

Set Privacy

Public, unlisted, private.

Add/Remove Tags

Manage stream tags.

Insert Cuepoint

Trigger an ad break.

Broadcast Management Effects

Create Broadcast

Schedule a new stream.

Delete Broadcast

Delete a scheduled stream.

Transition Broadcast

Change broadcast status.

Bind to Stream

Connect broadcast to stream.

Stream Management Effects

Create Stream

Create a new stream.

Update Stream

Modify stream settings.

Delete Stream

Remove a stream.

Video & Playlist Effects

Update Video

Edit video metadata.

Delete Video

Delete a video.

Set Thumbnail

Upload custom thumbnail.

Create Playlist

Create a new playlist.

Add to Playlist

Add video to playlist.

Delete Playlist

Remove a playlist.

Comment Effects

Post Comment

Comment on a video.

Reply to Comment

Reply to existing comment.

Delete Comment

Remove a comment.

Moderate Comment

Approve/reject comments.

Channel Effects

Update Channel

Edit channel info.

Set Watermark

Add branding watermark.

Remove Watermark

Remove watermark.

Subscribe to a channel.

Scripting API

Access YouTube features from your scripts using the CPH API:

Chat Messages

Send and manage chat messages

# Send a message to live chat
CPH.YouTubeSendMessage("Hello everyone!")

# Delete a message
CPH.YouTubeDeleteMessage("%messageId%")

Moderation

Moderate your live chat

# Ban a user from live chat
CPH.YouTubeBan("%userId%")

# Unban a user
CPH.YouTubeUnban("%banId%")

# Timeout a user (300 seconds default)
CPH.YouTubeTimeout("%userId%", 300)

# Add/remove moderator
CPH.YouTubeAddModerator("%channelId%")
CPH.YouTubeRemoveModerator("%moderatorId%")

Broadcast Control

Control your broadcast settings

# Update stream title
CPH.YouTubeSetTitle("Playing games with chat!")

# Update description
CPH.YouTubeSetDescription("Welcome to the stream!")

# Set stream category
CPH.YouTubeSetCategory("20")  # Gaming category ID

# Set privacy
CPH.YouTubeSetPrivacy("public")  # public, unlisted, private

# Add/remove tags
CPH.YouTubeAddTags(["gaming", "live", "fun"])
CPH.YouTubeClearTags()

Broadcast Management

Manage broadcasts and ads

# Create a new broadcast
CPH.YouTubeInsertBroadcast("My Stream Title", "2024-01-15T18:00:00Z", "unlisted")

# Transition broadcast status
CPH.YouTubeTransitionBroadcast("%broadcastId%", "live")  # testing, live, complete

# Insert an ad break (cuepoint)
CPH.YouTubeInsertCuepoint("%broadcastId%", 60)  # 60 second ad

# Delete a broadcast
CPH.YouTubeDeleteBroadcast("%broadcastId%")

Playlist Management

Manage playlists and videos

# Create a playlist
CPH.YouTubeInsertPlaylist("Stream Highlights", "Best moments from my streams", "public")

# Add video to playlist
CPH.YouTubeInsertPlaylistItem("%playlistId%", "%videoId%")

# Remove from playlist
CPH.YouTubeDeletePlaylistItem("%playlistItemId%")

# Delete playlist
CPH.YouTubeDeletePlaylist("%playlistId%")

See the full API reference for all YouTube methods.

Example Use Cases

Super Chat Alerts

Trigger on Super Chat to display an overlay alert, play a sound, and read the message with text-to-speech.

Member Welcome

Automatically welcome new members with a personalized message in chat and trigger special visual effects.

Chat Commands

Create custom chat commands that members or everyone can use to interact with the stream.

Dynamic Titles

Update your stream title automatically based on game changes, viewer milestones, or other events.

Ad Break Automation

Schedule ad breaks at optimal times or trigger them based on viewer count thresholds.

VOD Management

Automatically organize past streams into playlists based on game or date when the broadcast ends.

Cross-Platform Streaming

FaustBot can handle events from both Twitch and YouTube simultaneously, making it perfect for multi-platform streamers. Create actions that respond to events from either platform.