> For the complete documentation index, see [llms.txt](https://docs.sxbot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sxbot.io/discord-live-notifications/discord-voice-stream-notifications.md).

# Discord Voice Stream Notifications

## How do Discord voice stream notifications work?

Sx Bot will automatically post announcements in your Discord server whenever someone goes live in your Discord voice channels.

![Discord Live Voice Channel Streaming](/files/fJq5WUPz0yMor5NBGN3c)

## Set up your notification channel

**1.** [Invite the Bot](https://invite.sxbot.io) if you haven't already.

**2.** Create a channel for stream announcements if you haven't already.

**3.** Configure the bot to send stream notifications to that channel.\
**Example: `/discord-live channel set #stream-notifications`**

**4.** Edit your channel's settings, and go to the "Permissions" tab.

**5.** From the "Roles/Members" selection, add Sx Bot.

**6.** Allow Sx Bot to have the following permissions in the channel:

* View Channel
* Send Messages
* Embed Links
* Attach Files
* Use External Emoji
* Mention @everyone, @here, and All Roles

## Add the streamers

**1.** Add the streamers.

**Example:`/discord-live streamers add @user#2041`**

{% hint style="success" %}
That's it! Anytime the streamer @user#2041 goes live in a voice channel, you will now receive an alert to the notifications channel you set.
{% endhint %}

## Ping a specific role (optional)

**1.** Ping a specific role instead of @everyone

**Example:`/discord-live ping-role set @stream notifications`**

**2.** If you want to turn off pings altogether

**Example:`/discord-live no-ping enable`**

{% hint style="success" %}
The notifications will be sent silently without mentioning anyone!
{% endhint %}

## Live Logs (optional)

1. Setup a log channel to keep an audit lot of the live role\
   **Example:`/discord-live log-channel set #live-logs`**

## Create a live role (optional)

**1.** [Invite the Bot](https://invite.sxbot.io) 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: `/discord-live role set @Live on Discord`**

**4.** Setup a whitelist role to allow only members with this role to receive the live role.\
**Example: `/discord-live whitelist-role set @Members`**

**5.** You can turn on onlystreamers mode which will only allow users who are manually added to the streamers list to receive the live role.\
**Example: `/discord-live only-streamers enable`**<br>

{% hint style="warning" %}
Creating the live role is optional is will automatically give members a specific role when they begin streaming. It's not required for the notifications to be sent.
{% endhint %}

{% hint style="info" %}
Need help? join our [support server](https://support.sxlivebot.com)!
{% endhint %}