# Introduction Welcome to Sx Live's documentation. This site will guide you on the process of setting up Sx Live in your server. ## Basic bot setup This page will cover everything you need to do to get started with Sx Live. {% content-ref url="/pages/wRnOqi09mb7niKXsLRbC" %} [What is Sx Live?](/the-basics/what-is-sx-live) {% endcontent-ref %} {% content-ref url="/pages/ue4LgJDFrm5G6u1HxPA8" %} [Getting Started](/the-basics/getting-started) {% endcontent-ref %} ## Kick Notifications/Alerts {% content-ref url="/pages/UkrqHvaU00QJQGKgTu4v" %} [Setup Kick Alerts](/live-stream-notifications/setup-kick-alerts) {% endcontent-ref %} ## Twitch/YouTube Notifications {% content-ref url="/pages/lmtkFREgSX76yuXyKfrp" %} [Setup Twitch/YouTube Notifications](/live-stream-notifications/setup-twitch-youtube-notifications) {% endcontent-ref %} ## Twitch/YouTube Live Role {% content-ref url="/pages/iLHux6D2uqs9Ha6TlYD8" %} [Setup Live Role](/automated-live-role/setup-live-role) {% endcontent-ref %} ## Spotify Roles {% content-ref url="/pages/kMbqjjbrgM6T91bFGJCU" %} [Setup Spotify Role](/spotify-roles/setup-spotify-role) {% endcontent-ref %} ## Getting help, reporting issues, and making suggestions If you're still unsure on how to setup a specific feature, or if you run into any issues, feel free to reach us on our [Discord server](https://support.sxlivebot.com). ## Supporting the bot Sx Live is free at it's core, but for $3.00 / month, you can unlock extra premium benefits. All of the money we earn will go directly to paying the servers and improving the bot. You can check out or premium perks on our [Patreon](https://patreon.sxlivebot.com). # What is Sx Live? Sx Live is a live stream announcing Discord bot that will notify your Discord community when you or your favorite streamers go live on Kick.com, Twitch, or YouTube. # Getting Started Don't know what to do after inviting Sx Live to your server? We'll show you how to get started! {% hint style="info" %} You can invite Sx Live to any server that you have the **Manage Server** permission in. {% endhint %} 1. Go to [sxlivebot.com/invite](https://discord.com/oauth2/authorize?client_id=540349742178107409\&permissions=268946504\&response_type=code\&redirect_uri=https%3A%2F%2Fsxlivebot.com%2Fwelcome%3Fsource%3Dwebsite\&scope=bot%20applications.commands). 2. You should a Discord prompt, asking you to add the bot to a server. * Select your server name in the dropdown, and click **Continue**. * Choose the permissions that you want to give Sx Live. Click **Authorize**. ## The basics To view Sx Live's help menu, just type `+help` in the server you've invited the bot to.

Help Menu

From here, you can view the available bot categories. For example you can type `+help kick` to view the available commands in the kick streaming category. {% hint style="info" %} **Note:** If you see an empty message from Sx Live with buttons, you've most likely turned off embeds in your Discord settings. From your Discord app, go to **User Settings -> Text & Images** and turn on **Show embeds website preview info from links pasted into chat**. {% endhint %} Type `+help all` to view a full list of commands or visit our [commands](https://sxlivebot.com/commands) page on our website.
{% hint style="info" %} Make sure to use the prefix **`+`** before each command! {% endhint %} # Frequently Asked Questions ## What is Sx Live? [Sx Live](https://sxlivebot.com) is a bot for [Discord](https://discord.com) designed for Kick, Twitch, and YouTube streamers and their communities. ## How do I automatically let people in Discord know when I go live on Kick? You can set up a [stream notification](https://docs.sxlivebot.com/live-stream-notifications/setup-kick-alerts) to automatically notify your Discord community when you go live on Kick. ## Sx Live isn't sending announcements/notifications or giving the live role for Twitch and YouTube In order for the notifications to work properly and to receive the live role for Twitch and YouTube, the user **must have** the purple streaming status on Discord. To get the purple streaming status, a user **must**: * Enable [streamer mode](/live-stream-notifications/setup-twitch-youtube-notifications) on Discord * Have their Twitch or YouTube account linked to their Discord account The following cases can also cause problems with the live role: * The user is streaming on a console or a phone * Manually enable streamer mode and keep Discord open on a desktop or laptop device. {% hint style="info" %} To know if streamer mode is on and working, you should see the purple streaming icon next to the user's avatar. It can take up to 30 seconds for this to appear after a stream starts. {% endhint %}

Streaming Status

## What is the difference between Sx Live and Sx Bot Sx Live will automatically detect anyone who is live on Twitch or YouTube based on their streaming status ( The little purple icon next to your avatar). For the notifications to work properly, the user **must have** Streamer Mode enabled, which requires them to connect and integrate their Twitch or YouTube account to Discord in the user settings. Streamer mode is not required for kick notifications. Sx Bot allows you add twitch streamers directly by their channel names, and does not require streamer mode. You can [add the bot](https://invite.sxbot.io) and use **`/twitch streamers add`** **Which option should you choose?** If you want users detected automatically by a whitelisted role when they go live, Sx Live is the better option, but **does require** streamer mode. On the other hand, if only have several streamers you want to add or don't want to use streamer mode, you might be better adding them with [Sx Bot](https://invite.sxbot.io). Feel free to test out both and see what works best for you. You can also use both bots to combine different features and such. {% hint style="info" %} Purchasing a [premium](https://patreon.com/sxbot) subscription for Sx Live also gives you full premium access to our other multi-purpose bot [Sx Bot](https://invite.sxbot.io) which has many additional features such as boost tracking, invite tracking, logging, utilities, and more. {% endhint %} ## Why aren't the notifications showing up? The first step is to make sure you have set the notifications channel and added a streamer. \ **For example:** **`+kickchannel show` or `+kickstreamers show`** If both of these are correctly set, you want to make sure that the bot has permissions to send messages to your stream channel. The permissions the bot requires to send the notifications are: **View Channel, Send Messages, and Embed Links.** If the bot has the proper permissions and the notifications are still not working correctly. Please join our [support server](https://discord.gg/FxwmDT83qY) and speak to a bot specialist. ## Why is the live role not working? The first step is to make sure you have set the live role\ **Example:** **`+tliverole show` or `+ytliverole show`** If the live role is showing as correctly set, the next step is to make sure Sx Live has **Manage Roles** permissions and it's highest role is above the live role you set The bot is not able to give/remove roles if the role is above it's highest role in the hierarchy. If using the live role or Twitch or YouTube, make sure streamer mode is enabled and the purple streaming status icon is showing next to users avatar. For Kick, make sure you have successfully linked the Discord user to the kick streamer. To check all the active connections use **`+kickliverole list`** If the bot has the proper permissions and the live role is still not working correctly. Please join our [support server](https://support.sxlivebot.com) and speak to a bot specialist. ## What permissions are required for the notifications? The bot only requires 3 permissions to send notifications. **View Channel, Send Messages, and Embed Links.** If the bot has this permissions and the notifications are still not sending, you might need to go into the channel specific permissions and add **Sx Live** and give these 3 permissions for the notifications channel. ## Where can I get more information about Sx Live? To get more information about Sx live, you can join our [support server](https://discord.gg/FxwmDT83qY). # What does Premium offer? Sx Live Premium unlocks extra features not available in the free tier. By upgrading to Premium, you get faster notifications, unlimited stream alerts, and more! Your support also helps cover development costs, keeping the bot running smoothly and improving for everyone. ## What do I get with Premium? Premium gives you extra customization options in your server. Here’s what’s included: * Unlimited Kick streamer notifications * Unlimited Twitch streamer notifications * Unlimited YouTube streamer notifications * Unlimited automatic streamer roles * Faster notification times * Filter notifications by stream title * Access to Spotify roles * Patron-only Discord role and channel * Priority on feature requests * Early access to new features ## How much are the subscriptions? We have both monthly and yearly subscriptions available, with a 15% discount if you subscribe for an entire year. The tiers start at 3.00 / a month. ## How are subscriptions handled? All payments and subscriptions are processed through either [Patreon](https://patreon.com/sxbot) or directly in the [Discord app,](https://discord.com/application-directory/540349742178107409/store/1254896712791887943) depending on your choice of subscription method. You can manage your active subscriptions by visiting the respective platform you used to sign up. # Getting started with Premium ### **How to** Upgrade **If you want to upgrade through the Discord app (Fast and Easy Way):** 1. **Add** [**Sx Live**](https://sxlivebot.com/invite) **to your server.** 2. **Click on the bot and go to "Store"** * Or you can visit the store [here](https://discord.com/application-directory/540349742178107409/store/1254896712791887943). 3. **Click "Subscribe"** 4. **Select your payment method and click "Subscribe"** 5. **That’s it!** Premium features will be automatically activated in your server. **If you prefer to upgrade through Patreon:** 1. **Go to** [**patreon.com/sxbot**](https://www.patreon.com/sxbot)**.** 2. **Click "Join" on the tier that best fits your needs.** 3. **Choose between monthly or yearly (which saves 15%), and provide your payment information.** 4. **That's it!** Once your upgrade is complete, send us a message on Patreon with your server name or ID, or join our support server and provide it in the #patron-lounge channel and your server will be activated. {% hint style="warning" %} Make sure to connect your Discord account to Patreon by visiting [this link](https://www.patreon.com/settings/apps). This step is important to ensure you receive your special Patron role and access to Premium features. {% endhint %} For an exclusive Patron role, priority support, and updates, join the [Sx Live support server](https://discord.gg/FxwmDT83qY). # Setup Kick Alerts How to setup Kick Alerts in your Discord server **1.** Invite [Sx Live](https://sxlivebot.com/invite) if you haven't already. **2.** Add the kick streamer. (username or channel url)\ **Example:`+kickstreamers add xqc`** **3.** Set the notifications channel\ **Example:`+kickchannel set #your-alerts-channel`** **5.\[optional]** Send the notification without mentioning **`@everyone`**. \ **Example:** **`+kicknoping enable`** **7.\[optional]** Customize the message that is sent when a streamer goes live\ **Example: `+kickmessage set {HERE} {STREAMER} is now live!`** {% hint style="info" %} These variables can be used in the message:\ **{STREAMER}** = Kick Streamer Username\ **{GAME}** = Game/Category Name \ **{URL}** = Kick Stream URL\ **{EVERYONE}** = Mention @everyone \ **{HERE}** = Mention @here {% endhint %} **7.\[optional]** To ping a specific role for notifications\ **Example: `+kickmessage set @stream notifications {STREAMER} is now live!`** **8.\[optional]** Filter notifications by title name. (Requires filter word to be in stream title)\ **Example: `+kicktitlefilter set No Pixel`** {% hint style="info" %} This is particularly useful for GTA RP servers, similar to hasroot, where only streamers who have the keyword in their title will have the notifications sent. {% endhint %} **8.\[optional]** Set a cooldown for the notifications\ **Example: `+kickcooldown set 2h`** {% hint style="success" %} All done! Notifications will be sent within a few seconds of going live! {% endhint %} # Setup Twitch/YouTube Notifications How to get Twitch live notifications on Discord **1.** [Add Sx Live to your server](https://discord.com/oauth2/authorize?client_id=540349742178107409\&permissions=268946504\&response_type=code\&redirect_uri=https%3A%2F%2Fsxlivebot.com%2Fwelcome%3Fsource%3Dwebsite\&scope=bot%20applications.commands) if you haven't already. **2.** Connect your Twitch or YouTube account to your Discord account if you haven't already. ![User Settings > Connections > Twitch or YouTube](/files/ijW3od1ANJHnM56Z20l6) {% hint style="info" %} If you would rather add your twitch channel without connecting your account with Discord, you can add our multipurpose bot [Sx Bot](https://discord.com/oauth2/authorize?client_id=696870234262339614\&permissions=276220603640\&response_type=code\&redirect_uri=https%3A%2F%2Fsxbot.io%2Fwelcome%3Fsource%3Dsxlive\&scope=bot%20applications.commands) and use the command **`/twitch add`** {% endhint %} **3.** Make sure that Streamer Mode is enabled in your user settings. **4.** Create a channel for stream announcements if you haven't already. **5.** Configure the bot to send stream notifications to that channel.\ **Example:`+tchannel set #stream-notifications`**\ **Example:`+ytchannel set #stream-notifications`** **6.** Add individual users in your server for whom the notifications will be sent for.\ **Example:`+tstreamers add @user#3214`**\ **Example:`+ytstreamers add @user#4141`** **7.\[optional]** Set a required whitelist role in order to receive notifications.\ **Example:`+twhitelist add @Streamer`**\ **Example:`+ytwhitelist add @everyone`** **8.\[optional]** Set a cooldown for the notifications\ **Example: `+tcooldown set 30m`**\ **Example: `+ytcooldown set 30m`** {% hint style="info" %} Cooldowns can anywhere from **5m** to **8 hours.** {% endhint %} **9.\[optional]** If you don't want to mention `@everyone` and only a specific role when streamers go live.\ **Example: `+tpingrole set @stream alerts`** **10.\[optional]** Customize your own message for the stream alerts\ **Example:** **`+tmessage set {HERE} {STREAMER} is going live playing {GAME}!`** {% hint style="info" %} These variables can be used in the message:\ {STREAMER} = Twitch Username\ {USER} = Discord Username \ {MENTION} = Discord Mention\ {TITLE} = Stream Title\ {GAME} = Game Name \ {URL} = Twitch URL\ {EVERYONE} = Mention @everyone \ {HERE} = Mention @here {% endhint %} {% hint style="success" %} All done! The notifications are setup. {% endhint %} {% hint style="warning" %} For the stream notifications to work, you need to see a purple streaming icon next to member names who are streaming. This shows that Discord recognizes you are live, and the alerts will be sent. If you don't see this, try disconnecting/connecting your twitch/youtube account in user settings and make sure streamer mode is enabled and you are using OBS. If you still don't see the purple icon, you can try to add our multipurpose bot [Sx Bot](https://invite.sxbot.io) instead and add your channel directly without connecting. {% endhint %} If you still need assistance, please join our [Discord server](https://support.sxlivebot.com/). # Discord Voice Notifications How to setup Discord Voice Stream Notifications To setup Discord voice stream notifications in your server. You need to add to invite our multi-purpose bot [Sx Bot](https://sxbot.io) to your server and use the command **`/discord-live streamers add`** You can also follow our [Setup Discord Live Notifications](https://docs.sxbot.io/discord-live-notifications/setup-discord-live-notifications) for a step by step guide. # Kick Live Role How to setup Kick Live Role in your Discord server Easily know when members in your Discord server go live on Kick. Sx Live can automatically add a special role to people when they start streaming on Kick, and take it away when they stop. **1.** [Add Sx Live to your server](https://discord.com/oauth2/authorize?client_id=540349742178107409\&permissions=268946504\&response_type=code\&redirect_uri=https%3A%2F%2Fsxlivebot.com%2Fwelcome%3Fsource%3Dwebsite\&scope=bot%20applications.commands) if you haven't already. **2.** Create a live role if you haven't already. **3.** Configure the bot to the live role you created.\ **Example:`+kickliverole set "Now Live" or "Streaming on Kick"`** **4.** Add and link the Kick streamer to by Discord user mention or ID.\ **Example`+kickstreamers add xqc @discorduser`**\ **Example:`+kickstreamers add xqc 540349742178105409`** **5.** View a list of connected streamers to Kick Live role.\ **Example: `+kickliverole list`**

Kick Live Role example

{% hint style="warning" %} Kick Live role is currently a premium only feature. You will need to sign up on [Patreon](https://patreon.com/sxbot) to get access! {% endhint %} # Introduction to Live Role ## What is live role? Live Role allows you to promote streamers in your server by allowing them to receive an automatic role that gets added when someone streams on Twitch. We currently support the following two ways: **Option 1)** Sx Live will detect their purple "streaming" status and add the configured role when they begin their stream. When they lose the streaming status, Sx Live will remove the live role. {% hint style="info" %} This option is better if you want everyone or a large amount of streamers in your server to receive the live role. This also requires them to connect their Twitch account to Discord, and use OBS. If you prefer this option, you will need to add our live bot called [Sx Live](https://discord.com/oauth2/authorize?client_id=540349742178107409\&permissions=268946536\&scope=bot). You can invite the bot [here](https://discord.com/oauth2/authorize?client_id=540349742178107409\&permissions=268946536\&scope=bot). {% endhint %} **Option 2)** You will connect individual Discord members to a twitch streamer, and Sx Bot will give the configured role when they begin their stream, and remove it when the stream is over. {% hint style="info" %} This option is better if you only have a few streamers who should receive the live role, they stream on mobile, or they don't have their Twitch account connected to Discord. For this option, you can use Sx Bot directly by using the commands:**`/twitch live-role set`**`and`**`/twitch discord-member connect`** {% endhint %}

Discord Live Role example

# Setup Live Role How to setup automated live roles in your Discord server **1.** [Add Sx Live to your server](https://discord.com/oauth2/authorize?client_id=540349742178107409\&permissions=268946504\&response_type=code\&redirect_uri=https%3A%2F%2Fsxlivebot.com%2Fwelcome%3Fsource%3Dwebsite\&scope=bot%20applications.commands) if you haven't already. **2.** Connect your Twitch or YouTube account to your Discord account if you haven't already. ![User Settings > Connections > Twitch or YouTube](/files/ijW3od1ANJHnM56Z20l6) **3.** Make sure that Streamer Mode is enabled in your user settings. ![User Settings > Streamer Mode > Enable Streamer Mode](/files/LLZO2ZhtZdnUy9QR55hr) **4.** Create a live role if you haven't already. **5.** Configure the bot to the live role you created.\ **Example:`+tliverole set "Now Live" or "Streaming on Twitch"`**\ **Example:`+ytliverole set "Live Now" or "Streaming on YouTube"`** {% hint style="warning" %} Make sure the Sx Live role is above the live you created and the bot has Manage Roles permissions. {% endhint %} ![Role List](/files/revFF5UDMgaIo27XNihk) **6.\[optional]** Filter users who receive the live role by enabling only streamers.\ **Example:`+tonlystreamers enable`**\ **Example:`+ytonlystreamers enable`** {% hint style="warning" %} By default, everyone in the server will receive the live role. If you want only certain users to receive the live role, you can filter it by enabling only streamers mode. If only streamers is enabled, you will be required to add individual users using the **+tstreamers add** or **+ytstreamers add** command, or set a whitelisted role with +**twhitelist add** or **+ytwhitelist add** {% endhint %} **8.\[optional]** Add individual users in your server who will receive the live role is only streamers mode is enabled.\ **Example:`+tstreamers add @user#3214`**\ **Example:`+ytstreamers add @user#4141`** {% hint style="success" %} All done! The live roles are setup! {% endhint %} {% hint style="warning" %} For the live role to work correctly, you need to see a purple streaming icon next to the user names who are streaming. {% endhint %} ![Currently Live Icon on Discord](/files/8S0aU9mg1qB0y4MPGfpp) We also have created a walkthrough video on how to setup the live roles. If you only need the live role, you don't need to complete the last 2 steps of setting the channel and streamer. {% embed url="" %} Live Role Setup Demo {% endembed %} If you still need assistance, please join our [Discord server](https://discord.gg/FxwmDT83qY). # Live Logs Create a live streaming feed in your Discord server Live logs allow you to keep track of when streamers in your Discord server begin and end streaming. It will keep an audit log of when they receive the live roles, and when the live role is removed. **1.** Create a channel for your live logs if you haven't aleady **2.** Configure the bot to the live logs channel you created.\ **Example: `.tlivelogs set #live-logs`**\ **Example: `.ytlivelogs set #live-logs`** {% hint style="success" %} All done! You will now receive logs of when members receive the live role and when it's removed. {% endhint %} ![Live Logs](/files/0EvbwE4umT1pBskLK0Az) # Setup Spotify Role How to get a role when listening to Spotify **1.** [Add Sx Live to your server](https://discord.com/oauth2/authorize?client_id=540349742178107409\&permissions=268946504\&response_type=code\&redirect_uri=https%3A%2F%2Fsxlivebot.com%2Fwelcome%3Fsource%3Dwebsite\&scope=bot%20applications.commands) if you haven't already. **2.** Create a listening to Spotify role if you haven't already **3.** Configure the bot to the spotify role you created.\ **Example:`+spotifyrole set @Listening to Spotify`** {% hint style="warning" %} Make sure the bot has **Manage Roles** permissions and the Sx Bot role is above in the Spotify role in the roles list in server settings. {% endhint %} {% hint style="success" %} All done! Members will now receive this role when listening to Spotify. {% endhint %} ![Discord Spotify role example](/files/LIJW1s7KZXoqtdkXx4PD)