Commands
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. |
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 |
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. |
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.
- 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. - 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 |
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 |
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 |
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
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
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. |