Skip to main content

​
Overview

Once you’ve added streamers, you can view your tracked list, check live status, and remove streamers when needed.

​
Viewing Tracked Streamers

Use the /streamer list command to see all streamers being tracked in your server.
1

Run the List Command

/streamer list
This command requires no permissions - anyone can view the list.
2

Review the List

The bot displays an embed with all tracked streamers:Example Output:
📋 Tracked Streamers (1-5 of 12)

🟣 shroud • Twitch • 🔴 LIVE
   └ Alerts → #stream-alerts

🔴 mrbeast • YouTube
   └ Alerts → #youtube-alerts

🟢 trainwreckstv • Kick
   └ Alerts → #stream-alerts

🟣 pokimane • Twitch
   └ Alerts → #general

⚫ khaby.lame • TikTok • 🔴 LIVE
   └ Alerts → #tiktok-live

Page 1/3
3

Navigate Pages (if needed)

If you have more than 10 streamers, use the pagination buttons:
  • ◀ Prev - Previous page
  • Page X/Y - Current page indicator (disabled button)
  • Next ▶ - Next page
The list shows 10 streamers per page. Pagination buttons appear automatically when needed.

​
Understanding the List Format

Each entry shows:

​
Platform Emoji

  • 🟢 Kick / Rumble
  • 🟣 Twitch
  • 🔴 YouTube
  • ⚫ TikTok

​
Streamer Info

  • Username in bold
  • Platform name
  • 🔴 LIVE indicator (only when streaming)

​
Notification Channel

  • Shows which channel receives alerts
  • Format: └ Alerts → #channel-name
The live indicator (🔴 LIVE) updates in real-time based on the bot’s last check. If you see this, the streamer is currently streaming!

​
Removing Streamers

Use /streamer remove to stop tracking a streamer.
1

Run the Remove Command

/streamer remove
Requires Manage Channels permission.
2

Select Streamer to Remove

The bot shows a dropdown menu with all tracked streamers:Embed Preview:
🗑️ Remove Streamer

Select a streamer to remove:
Each option shows:
  • Platform emoji
  • Streamer username
  • Platform name
  • Notification channel (last 4 digits)
Example menu options:
🟣 shroud
Twitch • Alerts in #...2345

🔴 mrbeast
YouTube • Alerts in #...6789
The menu shows up to 25 streamers. If you have more, remove some to access older entries.
3

Confirm Removal

After selecting a streamer, the bot asks for confirmation:
⚠️ Confirm Removal

Remove shroud (Twitch)?

[Yes, Remove]  [Cancel]
  • Yes, Remove - Permanently removes the streamer
  • Cancel - Cancels the operation
4

Removal Complete

After confirming, the bot displays a success message:
✅ Streamer Removed

No longer tracking shroud on Twitch
The bot immediately stops monitoring this streamer.

​
Canceling Operations

Both add and remove flows include a Cancel button: 
[Cancel]
Clicking this button:
  • Dismisses the interaction
  • Cancels the operation
  • Shows a brief acknowledgment
No changes are made to your streamer list.

​
Per-Server Configuration

Each Discord server has its own independent streamer list. Adding or removing streamers in one server doesn’t affect others.

​
Server A Example

🟣 shroud • Twitch
🔴 mrbeast • YouTube

​
Server B Example

🟢 trainwreckstv • Kick
⚫ khaby.lame • TikTok
The bot can track different streamers in each server where it’s installed.

​
Data Persistence

The bot uses Enmap for automatic data persistence:
  • Streamer lists are saved immediately after any change
  • Data persists across bot restarts
  • No manual database configuration needed
  • Stored locally in the bot’s data directory
If you’re self-hosting, make sure to back up the data/ directory to preserve your streamer lists.

​
Managing Notification Channels

​
Changing a Streamer’s Channel

To move a streamer to a different notification channel:
1

Remove the streamer

/streamer remove
Select the streamer and confirm removal.
2

Re-add with new channel

/streamer add platform:twitch username:shroud
Select the new notification channel.
There’s no “edit” command. You must remove and re-add to change the notification channel.

​
Multiple Streamers, One Channel

You can send all alerts to a single channel: 
# Add multiple streamers to #stream-alerts
/streamer add platform:twitch username:pokimane
# Select #stream-alerts

/streamer add platform:youtube username:@valkyrae  
# Select #stream-alerts

/streamer add platform:kick username:adin
# Select #stream-alerts
All live alerts will be posted to #stream-alerts.

​
Streamer Limits

The bot has no hard limit on tracked streamers, but consider:
  • API rate limits: More streamers = more requests every 60 seconds
  • Performance: 50+ streamers may slow down checks
  • Channel spam: Too many alerts in one channel can be overwhelming
Recommended limits:
  • Small servers: 10-20 streamers
  • Medium servers: 20-50 streamers
  • Large servers: 50-100 streamers

​
Bulk Management

Currently, the bot doesn’t support bulk operations. To manage multiple streamers:

​
Removing Multiple Streamers

Run /streamer remove multiple times: 
/streamer remove
# Select streamer 1 → Confirm

/streamer remove  
# Select streamer 2 → Confirm

/streamer remove
# Select streamer 3 → Confirm
If you need to clear all streamers, consider manually deleting the data file (requires bot restart) or removing and re-inviting the bot.

​
Monitoring Live Status

The /streamer list command shows real-time live status: 
🟣 shroud • Twitch • 🔴 LIVE
🔴 mrbeast • YouTube
🟢 trainwreckstv • Kick • 🔴 LIVE
Streamers with 🔴 LIVE are currently streaming based on the last 60-second check.

​
Live Status Updates

  • Updated every 60 seconds automatically
  • Reflects the bot’s internal cache
  • May have a 1-2 minute delay from actual stream start
The live indicator in /streamer list is not real-time. It shows the status from the last polling cycle.

​
Common Scenarios

Remove the old username and add the new one:
/streamer remove
# Select old username

/streamer add platform:twitch username:new_username
The bot doesn’t have a pause feature. Options:
  1. Remove the streamer (easy to re-add later)
  2. Remove bot permissions in the notification channel
  3. Delete the notification channel (create new one later)
Simply re-add them:
/streamer add platform:twitch username:streamer_name
Note: You’ll lose the historical cache (last title, etc.), so you might get a duplicate alert if they’re currently live.
The bot checks every 60 seconds. If the status seems wrong:
  1. Wait 1-2 minutes and check again
  2. Verify the streamer’s actual status on their platform
  3. Check the bot is running with /ping

​
Next Steps

Adding Streamers

Learn how to add new streamers to track

Troubleshooting

Fix common issues and errors

Build docs developers (and LLMs) love

Get started for freeTalk to us