Commands

Edit

General #

All YouTube Live commands are accessible from Send to Extension command by selecting the desired YouTube Live command from the Extension dropdown menu.

Extension command name Description
Chat Message Sends a message to your current broadcast’s chat under your linked account’s name.
Ban or Unban User Bans or timeouts a user. Can unban them as well.
Update Broadcast Updates your current broadcast’s title, description or category via chat trigger or by manual input.
Get Categories Gets all available categories for Update Broadcast command.
Get My Channel Stats Retrieves your channel stats, such as title, ID, viewcount, sub count, video count.
Get My Broadcast Stats Retrieves your current broadcast’s stats, such as title, duration, views, likes, dislikes and current amount of viewers.
Get Member Info Retrieves information about a member (same as Twitch subscriber) of your channel.
Get Subscriber Status Checks whether your viewer is subscribed (same as Twitch follower) to your channel.


Edit

Send Chat Message #

Command: Send to Extension - YouTube Live Chat Message
Sends a message to your current broadcast’s chat under your linked account’s name. Broadcast must be live and connection status must be listening. Currently does not support custom emoji.

Please try to be reasonable with the amount of messages you send, as there’s a quota limit. You can display some messages on your stream overlay instead to save quota!

Box Name Type Description
message String Message to send


Edit

Ban or Unban User #

Command: Send to Extension - YouTube Live Ban or Unban User
Ban or unban a viewer. Broadcast must be live and connection status must be listening.
Provide either their channel ID or chat display name.
You can only unban a permanently banned user. If you want to remove a timeout, select temporary ban with 0 duration (which will override the original timeout).

Box Name Type Description
displayName String Viewer’s chat display name. Do not provide channel id if you already provided a display name.
channelid string Viewer’s channel ID. Do not provide a display name if you already provided a channel ID.
type Dropdown Whether you want to ban or unban the user. You can only unban a permanently banned user.
permanent Boolean Whether you want your ban to be permanent or temporary (=timeout).
duration Int Duration (if you selected temporary ban) in minutes. Use 0 if you want to un-timeout a user.


Edit

Update Broadcast #

Command: Send to Extension - YouTube Live Update Broadcast
Update your broadcast’s title, description or category. Broadcast must be live and connection status must be listening.

  1. Use a chat command
    You or your moderators can use the following command to update your broadcast: !update title XXX category CATEGORYID description XXX. The order of the keywords (title, category, description) must stay the same, however you can only include relevant keywords. I.e. to update only title and category, use !update title Playing Elden Ring category 5, or to just update the category, use !update category 5.
    If you’re using a chat command, do not edit anything in the button.
  2. Manually fill out the boxes
    You can manually fill out the Send to extension boxes (title, description, category) and press the button to update your broadcast.

List of all available categories can be found in your Transmitter in YouTube Live tab or by pressing the List Categories button. No global list is provided, as it might be different for each country.

Box Name Type Description
title String new title of your broadcast
description String new description of your broadcast
categoryid Int new category id for your broadcast
streamid String Automatically filled out, do not touch


Edit

List Categories #

Command: Send to Extension - YouTube Live Get Categories
Retrieve a list of all available categories. Also accessible from your Transmitter in your YouTube Live tab. Connection status must be ready.
This is needed if you wish to change the category when using Update Broadcast button.
The integration will return a stack with the name you specify containing all categories in this format: Category Name:Category ID.

Box Name Type Description
stackName String Name of the stack to save the categories into


Edit

Get My Broadcast Stats #

Command: Send to Extension - YouTube Live Get My Broadcast Stats
Retrieves stats for your current broadcast. Refreshed once per minute. Broadcast must be live and connection status must be listening. Stats are refreshed once every minute. This button can be spammed as it does not make any API calls.
All stats will be saved in the stack name you specified (if successfully retrieved, else the stack will be empty).

Stats retrieved:

  • title: [0]stackName
  • URL: [1]stackName
  • duration (hours): [2]stackName
  • view count: [3]stackName
  • like count: [4]stackName
  • dislike count: [5]stackName
  • concurrent viewers: [6]stackName
Box Name Type Description
stackName String Name of the stack to save the stats into


Edit

Get My Channel Stats #

Command: Send to Extension - YouTube Live Get My Channel Stats
Retrieves your channel stats. Also accessible from your Transmitter in your YouTube Live tab. Connection status must be ready.
Stats are refreshed once per Transmitter reload. This button can be spammed as it does not make any API calls.
All stats will be saved in the stack name you specified (if successfully retrieved, else the stack will be empty).

Stats retrieved:

  • title: [0]stackName
  • channel ID: [1]stackName
  • view count: [2]stackName
  • subscriber count: [3]stackName
  • video count: [4]stackName


Edit

Get Member Info #

Command: Send to Extension - YouTube Live Get Member Info
Retrieves information about a member (same as Twitch subscriber) of your channel. Connection status must be ready.
Provide either their channel ID or chat display name.

Box Name Type Description
displayName String Viewer’s chat display name. Do not provide channel id if you already provided a display name.
channelid string Viewer’s channel ID. Do not provide a display name if you already provided a channel ID.
stackName String Name of the stack to save the member info into

Member info retrieved:

  • display name: [0]stackName
  • channel ID: [1]stackName
  • channel URL: [2]stackName
  • profile image URL: [3]stackName
  • highest member level: [4]stackName
  • highest member level display name: [5]stackName
  • membership duration in months: [6]stackName


Edit

Get Subscriber Status #

Command: Send to Extension - YouTube Live Check Sub Status
Checks whether your viewer is subscribed to (follows) your channel. Connection status must be ready.
Provide either their channel ID or chat display name.\

Box Name Type Description
displayName String Viewer’s chat display name. Do not provide channel id if you already provided a display name.
channelid string Viewer’s channel ID. Do not provide a display name if you already provided a channel ID.
variable String Variable name to save the result into. Will be ‘true’ if the user is a subscriber and ‘false’ if they’re not.