streamlinx
docs

Troubleshooting

Common issues and their solutions. If you can't find your issue here, join our Discord support server.

Bot Issues

Bot Not Responding to Commands

Symptoms: Commands show error or no response

Possible Causes:

  1. Bot is offline or restarting
  2. Missing permissions
  3. Discord API issues

Solutions:

  1. Verify bot has these permissions:
    • Send Messages
    • Embed Links
    • Use Slash Commands
  2. Try again in a few minutes (Discord API may be slow)
  3. Re-invite bot with correct permissions

Try running /help to check if bot is responding. If no response, bot may be offline or missing permissions.

"Missing Permissions" Error

Error Message: "You need Manage Server permission to use this command"

Solution:

  1. Verify you have "Manage Server" role in Discord
  2. Server Settings → Roles → Your Role → Enable "Manage Server"
  3. If you're the server owner, you automatically have this permission

Commands Not Appearing

Symptoms: Slash commands don't show in autocomplete

Possible Causes:

  1. Bot recently added (commands take 1 hour to sync)
  2. Discord cache issue
  3. Bot missing permissions

Solutions:

  1. Wait up to 1 hour for commands to sync
  2. Restart Discord client (Ctrl+R or Cmd+R)
  3. Re-invite bot using the invite link
  4. Check bot has "Use Application Commands" permission

Bot Left Server Unexpectedly

Possible Causes:

  1. Someone kicked the bot
  2. Bot was banned
  3. Service maintenance

Solutions:

  1. Check Audit Log (Server Settings → Audit Log)
  2. Re-invite bot using the invite link
  3. Check #announcements in support Discord for maintenance notices

Notification Issues

Not Receiving Notifications

Symptoms: Streamer is live but no notification sent

Check These First:

  1. Verify Streamer is Tracked:

    • Use /portal to open the web dashboard
    • Confirm streamer appears in your streamers list

  2. Check Notification Channel:

    • Bot needs "Send Messages" permission in channel
    • Channel not deleted or archived
    • Check in the Web Portal which channel is assigned

  3. Verify Streamer is Actually Live:

    • Check on platform (Twitch/YouTube)
    • May be marked as live but in waiting room (YouTube)

  4. Check Bot Online Status:

    • Bot must be online to send notifications
    • Check bot status in member list

Advanced Troubleshooting:

Platform Connection Issues

Monitoring may fail to start if:

  • Platform API is down
  • Bot restarted recently (reconnecting)
  • Streamer account is banned/suspended

Solution:

  1. Remove streamer: /streamer remove platform:Twitch username:username
  2. Wait 30 seconds
  3. Re-add streamer: /streamer add platform:Twitch username:username channel:#channel
  4. This resets the monitoring connection

Duplicate Notifications

Symptoms: Multiple notifications for same stream

Possible Causes:

  1. Streamer added multiple times
  2. Multiple notification channels configured
  3. Bot error (rare)

Solutions:

  1. Use /portal to open the Web Portal - check for duplicate entries
  2. Verify expected notification channels in the dashboard
  3. Remove duplicate entries
  4. If issue persists, contact support

Delayed Notifications

Symptoms: Notifications arrive 5+ minutes after stream starts

Expected Delays by Platform:

  • Twitch: Under 30 seconds
  • YouTube: 2-5 minutes (platform limitation)

If Delays Are Longer:

  1. Check Platform Status:

  2. Connection Refresh:

    • Platform connections occasionally need renewal
    • Bot automatically handles this, but issues can occur
    • Solution: Remove and re-add streamer

  3. Discord API Issues:

If consistent delays only affect certain streamers, their platform API data may be cached. This is a platform issue, not Streamlinx.

Notifications Missing Information

Symptoms: Embed shows "Unknown Game" or missing thumbnail

Causes:

  1. Platform API didn't provide data
  2. Streamer hasn't set game/category
  3. New game not in platform database

Solutions:

  • Usually resolves automatically when streamer updates info
  • Not a bot error if streamer hasn't set category
  • Check streamer's actual stream page to confirm

Wrong Notification Channel

Symptoms: Notifications going to wrong channel

Solution:

  1. Use /portal to see current channel assignments in the Web Portal
  2. To change channel:
    • Remove streamer: /streamer remove platform:Twitch username:username
    • Re-add with correct channel: /streamer add platform:Twitch username:username channel:#correct
    • Or edit the streamer in the Web Portal to change the channel

Web Portal Issues

Can't Login

Symptoms: OAuth redirect fails or shows error

Possible Causes:

  1. Discord OAuth app misconfigured
  2. Popup blocked by browser
  3. Session cookies disabled

Solutions:

  1. Allow popups from streamlinx.io
  2. Enable cookies in browser settings
  3. Try different browser
  4. Clear browser cache and cookies
  5. Disable ad blockers temporarily

Server Not Showing in List

Symptoms: Your Discord server missing from portal

Requirements:

  • You must have "Manage Server" permission
  • Bot must be in the server
  • Server must have at least setup completed

Solutions:

  1. Verify "Manage Server" permission in Discord
  2. Ensure bot is invited to server
  3. Logout and login again to refresh
  4. Use /streamer add in Discord to track your first streamer

Changes Not Saving

Symptoms: Settings revert after saving

Possible Causes:

  1. Network error
  2. Session expired
  3. Validation error

Solutions:

  1. Check browser console for errors (F12)
  2. Verify network connection
  3. Logout and login again
  4. Try different browser

Dashboard Shows Old Data

Symptoms: Live status not updating

Solution:

  • Dashboard auto-refreshes every 30 seconds
  • Manually refresh browser page (F5)
  • Clear browser cache

Streamer Issues

"Invalid Username" Error

Error: Cannot add streamer - invalid username

Correct Username Formats:

Twitch:

  • ✅ ninja (just the username)
  • ✅ pokimane
  • ❌ https://twitch.tv/ninja (use just the username, not full URL)

YouTube:

  • ✅ @MrBeast (channel handle with @)
  • ✅ mrbeast (handle without @)
  • ❌ https://youtube.com/@MrBeast (use just the handle, not full URL)

Solution: Use just the username/handle from the streamer's channel page

"Streamer Already Tracked" Error

Error: Cannot add - streamer already tracked

Solutions:

  1. Use /portal to view your streamers list and find the existing entry
  2. If you want it in different channel:
    • Remove existing: /streamer remove platform:Twitch username:username
    • Re-add with new channel: /streamer add platform:Twitch username:username channel:#new-channel
  3. If you don't see it in list but get error:
    • May be tracked in different server you manage
    • Streamers can only be tracked once per server

"Streamer Not Found" Error

Error: Platform API cannot find streamer

Possible Causes:

  1. Username Changed: Streamer changed their username
  2. Account Deleted: Account no longer exists
  3. Account Suspended: Temporarily banned by platform
  4. Typo: Wrong username in URL

Solutions:

  1. Verify streamer exists by visiting URL in browser
  2. Check username hasn't changed
  3. Try again in a few minutes (API may be slow)
  4. If account is suspended, remove and re-add when unbanned

Can't Remove Streamer

Error: Removal fails or streamer reappears

Solutions:

  1. Verify streamer name spelling (use autocomplete)
  2. Check you have "Manage Server" permission
  3. Try via web portal instead of Discord command
  4. If issue persists, contact support with streamer ID

Premium & Subscription Issues

Premium Not Activating

Symptoms: Purchased premium but features not unlocked

Solutions:

  1. Wait up to 5 minutes for activation
  2. Run /subscription to check your tier status
  3. Verify purchase in Discord → User Settings → Subscriptions
  4. Contact support with transaction ID

Premium Features Not Working

Symptoms: Custom webhooks or advanced features not available

Check:

  1. /subscription - verify tier shows "Premium"
  2. Check subscription expiration date
  3. Ensure payment method is valid

Solutions:

  1. If expired, renew subscription in Discord settings
  2. Contact support if active but not working

Can't Upgrade to Premium

Symptoms: Upgrade button doesn't work

Solutions:

  1. Verify server is eligible (community server with bot)
  2. Check Discord Nitro required for server subscriptions
  3. Try desktop Discord app instead of web
  4. Clear Discord cache and restart

Template Issues (Premium)

Template Not Applying

Symptoms: Notifications still use default template

Solutions:

  1. Verify template saved in the Web Portal (use /portal to access)
  2. Check for invalid variables (must use exact names)
  3. Ensure correct platform selected (Twitch/YouTube)
  4. Template applies to new notifications only (not retroactive)

Template Variables Not Working

Symptoms: Variables like {streamer} showing as literal text

Common Mistakes:

  • Wrong brackets: [streamer] ❌ Should be {streamer} ✅
  • Extra spaces: { streamer } ❌ Should be {streamer} ✅
  • Wrong case: {STREAMER} ❌ Should be {streamer} ✅
  • Typos: {stremer} ❌ Should be {streamer} ✅

Valid Variables:

Common (all notifications):

  • {streamer} - Streamer display name
  • {username} - Platform username/handle
  • {platform} - Platform name (Twitch, YouTube)
  • {title} - Stream title
  • {game} - Game/category
  • {url} - Direct link to stream

Live notifications only:

  • {viewer_count} - Current viewer count

Offline notifications only:

  • {duration} - How long stream lasted
  • {vod_url} - Link to VOD/recording

Template Too Long

Error: Template exceeds character limit

Limits:

  • Message: 2000 characters
  • Embed title: 256 characters
  • Embed description: 4096 characters

Solution:

  1. Shorten template text
  2. Remove unnecessary variables
  3. Use shorter custom text

Performance Issues

Bot Responding Slowly

Possible Causes:

  1. High server load
  2. Discord API rate limits
  3. Large server with many commands

Solutions:

  • Usually resolves within a few minutes
  • If persistent, contact support

Web Portal Loading Slowly

Solutions:

  1. Clear browser cache
  2. Disable browser extensions
  3. Check network connection
  4. Try incognito mode
  5. Use different browser

Common Error Messages

"Rate Limited"

Meaning: Too many requests in short time

Solution: Wait 30 seconds and try again

"Bot Missing Permissions"

Meaning: Bot cannot perform action in channel

Required Permissions:

  • Send Messages
  • Embed Links
  • Manage Webhooks (Premium)
  • Read Message History

Solution:

  1. Server Settings → Roles → @Streamlinx
  2. Enable missing permissions
  3. Or give permissions in channel settings

"Internal Server Error"

Meaning: Unexpected error on our side

Solution:

  1. Try again in a few minutes
  2. If persists, contact support with:
    • Timestamp of error
    • Command used
    • Server ID

Getting Help

If your issue isn't listed here:

  1. Search Documentation:

  2. Check Status Page:

  3. Join Support Server:

  4. Contact Support:

When Reporting Issues, Include:

  • What you were trying to do
  • What command/page you used
  • Expected vs actual behavior
  • Screenshots (if applicable)
  • Server ID and streamer name (if relevant)
  • Error messages (exact text)
Quick Response Tips

Provide as much detail as possible in your first message. This helps us resolve your issue faster without back-and-forth questions.