streamlinx
docs

Frequently Asked Questions

Find answers to the most common questions about Streamlinx, stream notifications, and platform integrations.

General Questions

What is Streamlinx?

Streamlinx is a Discord bot that monitors your favorite streamers on Twitch, YouTube, and Kick and sends notifications to your Discord server when they go live. It supports custom notifications, analytics, and multi-channel organization.

Is Streamlinx free?

Yes! Streamlinx offers a Free Tier that supports:

  • 15 streamers total (5 Twitch + 5 YouTube + 5 Kick)
  • Real-time notifications sent to your server
  • Custom message templates

For larger communities, Premium unlocks 360 streamers (300 Twitch + 10 YouTube + 50 Kick), custom notification identity, advanced analytics, notification filters, cooldowns, and quiet hours for $2.99/month.

Which platforms does Streamlinx support?

Currently supported:

  • ✅ Twitch - Full support with instant notifications
  • ✅ YouTube - Full support (2-5 minute delay due to platform limitations)
  • ✅ Kick - Full support with instant notifications
  • ...and more to come!

How do I invite the bot to my server?

  1. Visit streamlinx.io
  2. Click "Add to Discord"
  3. Select your server
  4. Authorize the required permissions
  5. Use /streamer add to track your first streamer, or visit the web portal for a visual interface

What permissions does the bot need?

Required:

  • Send Messages - To send notifications
  • Embed Links - To display rich notification embeds
  • Read Message History - To update/delete notifications

Optional (Premium):

  • Manage Webhooks - For custom notification name/avatar
  • Manage Messages - For auto-delete feature

Notifications

How long does it take for notifications to arrive?

Twitch: Under 30 seconds

YouTube: 2-5 minutes

Kick: Under 30 seconds

If notifications are delayed longer than 10 minutes, check Troubleshooting.

Can I customize what the notifications say?

Yes! All users (Free and Premium) can use custom message templates to customize notification text. Configure templates in the Web Portal:

Example template:

🔴 {streamer} is live playing {game}!
{url}

Available variables: {streamer}, {title}, {game}, {url}, {viewer_count}, and more.

See Notifications Guide for full details.

Can notifications mention a role?

Yes! Configure a ping role in the Web Portal under streamer settings. When streamers go live, the notification will mention this role to alert members.

Why am I not getting notifications?

Common causes:

  1. Bot Permissions: Ensure bot has "Send Messages" and "Embed Links" in the notification channel
  2. Streamer Not Added: Verify in the Web Portal using /portal
  3. Platform Delays: YouTube can take 2-5 minutes
  4. Platform Issues: Twitch/YouTube/Kick may be experiencing issues (check status pages)

See Troubleshooting for detailed solutions.

Can I get notifications in multiple channels?

Yes! Both Free and Premium tiers can route individual streamers to different channels:

  • Send Twitch streams to #twitch-alerts
  • Send YouTube streams to #youtube-alerts
  • Create game-specific channels
  • Organize by streamer priority

When you add a streamer with /streamer add, you specify which channel should receive notifications for that streamer. You can assign each streamer to a different channel or send them all to the same channel.

Do notifications work for YouTube premieres?

No, premieres are not treated as live streams and won't trigger notifications. Only actual live streams trigger notifications.

This is intentional to prevent confusion between live content and pre-recorded uploads.

Streamers

How many streamers can I add?

Free Tier:

  • 15 streamers total
  • Maximum 5 Twitch
  • Maximum 5 YouTube
  • Maximum 5 Kick

Premium Tier:

  • 360 streamers total
  • Maximum 300 Twitch
  • Maximum 10 YouTube
  • Maximum 50 Kick

Can I add the same streamer to multiple servers?

Yes! Each Discord server has its own independent configuration. The same streamer can be tracked in unlimited servers.

What if a streamer changes their username?

Twitch:

  • Remove the old username
  • Add the new username
  • Monitoring will update automatically

YouTube:

  • If they changed their @handle, update it
  • If you're using channel ID, no action needed (IDs don't change)

Can I track streamers from my own account?

Yes! You can track your own Twitch, YouTube, or Kick channel to send notifications to your community when you go live.

Do streamers need to authorize or approve anything?

No! Streamers don't need to take any action. Streamlinx monitors public streaming platforms and doesn't require streamer cooperation.

Premium

What's included in Premium?

Premium features:

  • 360 streamers (300 Twitch + 10 YouTube + 50 Kick)
  • Custom notification identity (custom name/avatar)
  • Full analytics dashboard (Activity Patterns, Leaderboards, growth trends - Overview is free)
  • Up to 5 notification filter rules per streamer
  • Notification cooldowns (1 min to 24 hours)
  • Quiet hours scheduling with skip or summary modes
  • Up to 5 live role configurations with blacklist mode
  • Priority support

See Premium Features for full details.

How much does Premium cost?

$2.99 per month per Discord server via Discord Server Subscriptions.

Payment is processed securely through Discord. You can cancel anytime.

Can I use Premium on multiple servers?

No, Premium is per-server. Each Discord server requires its own subscription.

How do I upgrade to Premium?

  1. Run /upgrade in your server
  2. Click "Upgrade to Premium"
  3. Complete purchase through Discord
  4. Features activate immediately

Alternatively, visit Discord Store.

What happens if I cancel Premium?

  • Subscription remains active until end of billing period
  • After expiration, the system automatically downgrades your guild:
    • Excess streamers are deactivated but preserved (all streamers kept, oldest ones paused first)
    • Custom notification identities are preserved but cannot be used on Free tier
    • Notification filter rules are preserved but disabled
    • Cooldowns and quiet hours settings are preserved but disabled
    • Queued quiet hours notifications are cancelled
  • You and your guild receive a notification after downgrade
  • Automatic restoration: When you resubscribe, all previously deactivated streamers are automatically restored

See Premium Features for details.

Can I get a refund?

Refund policy follows Discord Server Subscriptions terms. Generally:

  • No refunds for partial months
  • Contact Discord support for refund requests

Web Portal

What is the Web Portal?

A browser-based dashboard at streamlinx.io where you can:

  • Manage streamers visually
  • View analytics (Overview free, full dashboard Premium)
  • Edit notification channels
  • Monitor live status

Alternative to using Discord commands.

Do I need to use the Web Portal?

For basic streamer management, you can use Discord commands (/streamer add, /streamer remove). However, the Web Portal is required for advanced features like custom templates, custom identity, embed customization, and filters.

What can I do in the Web Portal?

Available Features:

  • Add/edit/remove streamers
  • View sortable streamer table with live status
  • Search and filter streamers
  • View analytics Overview (free) and full dashboard (Premium)
  • Monitor real-time streaming activity
  • Configure custom message templates
  • Set up custom notification identity (Premium)
  • Customize embed colors and settings
  • Configure notification filter rules (Premium)

How do I access the Web Portal?

  1. Visit streamlinx.io
  2. Click "Login" or "Dashboard"
  3. Authorize with Discord OAuth2
  4. Select your server

You must have "Manage Server" permission in Discord to access.

Technical

Does Streamlinx store my messages?

No. Streamlinx only stores:

  • Server ID and name
  • Notification channel IDs
  • Streamer usernames and platform
  • Notification history (last 90 days)
  • Analytics data (Overview free, full analytics Premium)

We never access or store Discord messages, DMs, or voice data.

Is my data secure?

Yes. Streamlinx uses:

  • Encrypted session tokens
  • Secure Discord OAuth2 authentication
  • HTTPS for all communications
  • No third-party data sharing

See Privacy Policy for details.

How often does the bot check for streams?

Streamlinx monitors streams in real-time:

  • Twitch: Instant notifications (under 30 seconds)
  • YouTube: 2-5 minute delay
  • Kick: Instant notifications (under 30 seconds)

The system includes automatic backup monitoring to ensure reliable notifications even when platforms are experiencing issues.

What happens if the bot goes offline?

If the bot experiences downtime:

  • Platform monitoring continues automatically
  • Stream updates are queued and processed when the bot returns
  • Notifications resume when bot comes back online
  • May experience delays for streams that started during downtime

Check bot status in the support Discord.

Can I self-host Streamlinx?

No, Streamlinx is not open-source and cannot be self-hosted. This ensures:

  • Reliable uptime and monitoring
  • Secure platform credential management
  • Consistent feature updates
  • Professional support

Troubleshooting

The bot isn't responding to commands

Check:

  1. Bot is online (green status in member list)
  2. You have required permissions (Manage Server for most commands)
  3. Commands are slash commands (use /streamer, not !streamer)
  4. Bot has "Use Application Commands" permission

If still not working:

  • Kick and re-invite the bot
  • Contact support

Notifications stopped working suddenly

Common Causes:

  1. Channel Deleted: Notification channel was removed
  2. Permissions Changed: Bot lost required permissions
  3. Connection Refresh: Platform connections need renewal (happens automatically)
  4. Platform Issues: Twitch/YouTube/Kick may be experiencing issues

Solutions:

  • Use /portal to verify streamers are still tracked in the Web Portal
  • Check that notification channels still exist
  • Verify bot has permissions in notification channel
  • Wait 5 minutes for system to stabilize

How do I reset my configuration?

Remove Streamers:

  • Remove individual streamers: /streamer remove platform:Twitch username:name
  • Or use the Web Portal to manage streamers visually

Reset Advanced Settings:

  • Use the Web Portal to reset templates, embed colors, and other settings

Note: Removing configuration doesn't cancel Premium subscription. Manage that in Discord Server Settings.

I'm hitting the streamer limit

Free Tier: Maximum 15 streamers (5 Twitch + 5 YouTube + 5 Kick)

Solutions:

  • Remove unused streamers
  • Upgrade to Premium (360 streamers: 300 Twitch + 10 YouTube + 50 Kick)
  • Prioritize your most important streamers

Check Current Usage:

/subscription

Platform-Specific

Twitch: How often are viewer counts updated?

Viewer counts are automatically updated in the Discord notification embed when stream metadata changes. Updates occur based on the monitoring interval (typically every few minutes).

If the embed isn't updating, ensure the bot has permission to edit messages in the notification channel.

YouTube: Why are notifications delayed?

YouTube notifications typically have a 2-5 minute delay due to how YouTube's notification system works. This is a YouTube platform limitation, not a Streamlinx issue.

Streamlinx includes backup monitoring to ensure reliable notifications. Most notifications arrive within 2 minutes.

YouTube: How do I find my channel handle?

Visit your YouTube channel, look at the URL:

  • youtube.com/@ChannelName → handle is @ChannelName

Use this format when adding: /streamer add platform:YouTube username:@ChannelName channel:#notifications

See YouTube Setup for details.

Twitch: Why did notifications stop after 10 days?

Streamlinx connections to Twitch need periodic renewal. The system automatically handles this every 6 hours.

If notifications stop unexpectedly (rare):

  • Remove and re-add the streamer
  • Contact support if issue persists

Community & Support

How do I get help?

  1. Check Documentation: Streamlinx Documentation
  2. Run /help: Quick command reference in Discord
  3. Join Support Server: Discord support server
  4. Email Support: support@streamlinx.io

Premium users get priority support.

Can I request features?

Yes! We welcome feature requests:

  • Join the support Discord
  • Post in #feature-requests channel
  • Premium users' requests get higher priority

How can I report bugs?

In Discord:

Via Email:

Can I contribute to Streamlinx?

Streamlinx is not open-source, but you can contribute:

  • Report bugs and test beta features
  • Help others in the support Discord
  • Share feedback and feature ideas
  • Create tutorial videos or guides

Still Have Questions?