How to use a YouTube stream bot in Discord

The short answer

To use a YouTube stream bot in Discord, you add the bot to a server you manage, give it the channel permissions it needs, and then configure it with commands or a web dashboard. What "YouTube stream bot" means changes the steps, though. The phrase usually refers to one of three different jobs, and no single bot is guaranteed to do all of them.

• Live notifications: the bot watches a YouTube channel and posts a message in a Discord text channel when that channel goes live or uploads a video.
• Audio playback: a music-style bot joins a voice channel and plays sound from a YouTube link or search.
• Watching video together: people in a voice channel view the same YouTube stream at the same time. Bots generally cannot do this, because Discord's bot platform lets bots send audio into voice channels but not video. For shared video, you use Discord's own screen sharing or an Activity instead.

Decide which of these you need before choosing a bot, then follow the matching section below.

Before you start

• You need the Manage Server permission in the target server. Without it, the server will not appear as an option when you authorize a bot.
• Pick a bot whose current documentation says it supports the specific job you want. Features change over time. A bot listed somewhere as a "YouTube bot" may only do notifications, or may have dropped YouTube playback.
• Decide which text channel should receive alerts, or which voice channel the bot should join.
• If you want alerts to ping everyone, decide whether to use @everyone, @here or a dedicated role. A dedicated role lets members opt in.

Set up a YouTube live-notification bot

• 1. Open the bot's official invite option, usually labeled "Add to Discord" or "Invite" on its website or listing.
• 2. On Discord's authorization screen, choose your server and review the requested permissions. Approve only what the bot needs for posting: View Channels, Send Messages and Embed Links. Add Mention @everyone, @here and All Roles only if you want those pings.
• 3. Confirm the bot now appears in your server's member list.
• 4. In the alert channel, open Edit Channel > Permissions and make sure the bot or its role is not blocked from viewing or sending messages there. Channel-level settings can override server-wide permissions.
• 5. Use the bot's setup command or dashboard to add the YouTube channel you want to follow. Bots usually accept a channel link, handle or channel ID. Then select the Discord channel where alerts should appear.
• 6. Set the alert message and any role mention, if the bot offers that option.
• 7. Run the bot's test or preview command, if it has one.

How to tell it worked: a test or sample alert appears in the chosen channel, formatted the way you expect, and the intended role or members receive the mention. This only proves that the bot can post in that channel. It does not prove the bot will detect a real live stream. Some bots check YouTube on a schedule rather than instantly, so the first real alert is the true confirmation. If your bot's documentation states how often it checks, use that to judge whether an alert is late. The supplied material gives no figure for any particular bot.

Play YouTube audio in a voice channel

Before you invite a music bot for this, check that its documentation still lists YouTube as a supported source. YouTube's terms of service restrict pulling content out of its player. Because of that, some bots have removed YouTube playback or offer other sources instead.

• 1. Invite the bot as above. For voice use, it needs Connect and Speak on the voice channel. It also needs View Channels and Send Messages in the text channel where you type its commands.
• 2. Join the voice channel yourself. Many bots join whichever channel the person giving the command is in.
• 3. Use the bot's play command with a YouTube link or search term. The exact command syntax depends on the bot.
• 4. Check that the bot appears in the voice channel's member list.
• 5. Watch the bot's avatar. When Discord receives audio from a member, it draws a green ring around that member's avatar.
• 6. Listen for the sound on your own device.

Keep these three checks separate. If the bot appears in the channel, it has connected. A green ring means it is sending audio. Hearing clear sound depends on your side as well: your selected output device, your own volume settings and the bot's volume. If the ring shows but you hear nothing, the problem is probably on your end rather than with the bot.

Watch a YouTube stream together on video

Since bots cannot send video into a voice channel, use one of Discord's own features instead.

• Screen share: open the YouTube stream in a browser or app, join a voice channel and start sharing that window or tab. Whether the stream's sound is shared along with the picture depends on your operating system and Discord app, so ask a viewer to confirm they can hear it.
• Activities: Discord has offered a YouTube watch-together Activity that you launch from a voice channel. Availability can vary by platform, region and server, so check the Activities menu in your own voice channel.

Either way, the real confirmation is that another person in the call reports seeing smooth video and hearing the audio. Your own preview only shows what you are sending.

If something isn't working

• The bot isn't in your server: make sure you picked the right server on the authorization screen and that you have Manage Server there.
• The bot is in the server but doesn't respond to commands: check that it can view and send messages in that channel. Also check whether it uses slash commands or a text prefix.
• There's no live alert: confirm that the YouTube channel you entered is correct and that the stream was a public live stream. Then check the channel permissions again.
• Alerts arrive but nobody is notified: the bot may be missing permission to mention @everyone or the chosen role, or members may have muted that channel.
• The bot joins voice but stays silent: check that it has Speak, that it isn't server-muted and that YouTube is still a supported source for that bot.
• The bot is audible but too loud or quiet: right-click the bot in the voice channel and adjust its user volume. This setting changes only what you hear.

What this guide can't confirm

The supplied material contains no evidence about specific bots. That includes which ones currently support YouTube notifications or playback, how quickly they detect a live stream and whether they charge for features. Because of that, this guide does not recommend a particular bot or give timing or audio-level targets. Check the bot's current documentation for those details, and use a real live stream as the final test of your setup.