YouTube Alerts
Subscribe to YouTube channels and stay updated when new videos are posted.
Overview
SYNTHET's YouTube Alerts feature allows you to subscribe to your favorite channels and receive instant notifications in your Discord server whenever new videos are uploaded. Never miss a video from the creators you love.
Set up custom notification channels, filter by keywords, and manage subscriptions with simple commands. Notifications include video title, thumbnail, and a direct link to the video.
YouTube Alerts are delivered within seconds of a video being published.
Core Commands
Use these commands to manage your YouTube channel subscriptions:
/youtube subscribe <channel_url> | Subscribe to a YouTube channel for notifications |
/youtube unsubscribe <channel_id> | Stop receiving notifications from a channel |
/youtube list | View all your active channel subscriptions |
/youtube channel <channel_id> | View details about a subscribed channel |
/youtube set-notification-channel <#channel> | Set where YouTube alerts are posted |
/youtube filter <channel_id> <keyword> | Only notify for videos containing a keyword |
/youtube remove-filter <channel_id> <keyword> | Remove a keyword filter |
/youtube pause <channel_id> | Temporarily pause notifications from a channel |
/youtube resume <channel_id> | Resume notifications from a paused channel |
/youtube status | Check YouTube alert system status |
Getting Started
Follow these steps to set up YouTube Alerts in your server:
Step 1: Choose a Notification Channel
First, decide which channel in your server should receive YouTube notifications. This should typically be a dedicated channel like #youtube-alerts or #content.
/youtube set-notification-channel #youtube-alertsStep 2: Subscribe to Channels
Use the subscribe command with a YouTube channel URL. You can get this from the channel's YouTube page.
/youtube subscribe https://youtube.com/@channelnameStep 3: Verify Your Subscription
Check your active subscriptions to confirm everything is set up correctly.
/youtube listNotification Format
YouTube Alerts are formatted with comprehensive information about new videos:
Default Notification Include:
- • Video title and channel name
- • Video thumbnail image
- • Upload timestamp
- • Video description (truncated)
- • Direct link to the video
- • View count and engagement metrics
Advanced Features
Customize your YouTube notification experience:
Keyword Filtering
/youtube filter <channel_id> <keyword>Only receive notifications for videos containing specific keywords in the title or description.
Example: /youtube filter UC1234567890 gaming
Pause & Resume
/youtube pause <channel_id>Temporarily stop notifications from a channel without unsubscribing. Resume anytime.
Example: /youtube pause UC1234567890
Channel Details
/youtube channel <channel_id>View comprehensive information about a subscribed channel including subscriber count.
Example: /youtube channel UC1234567890
Multi-Channel Setup
Subscribe to multiple channelsSubscribe to as many channels as you want. All alerts go to your notification channel.
Example: Subscribe to 10+ channels for maximum coverage
Supported URL Formats
YouTube Alerts supports multiple URL formats for subscribing to channels:
Channel Handle
https://youtube.com/@channelnameMost common format, works with custom handles
Channel ID
https://youtube.com/channel/UC1234567890Direct channel ID format, always reliable
User Format
https://youtube.com/user/usernameLegacy format, still supported
Short Format
https://www.youtube.com/c/channelnameAlternative channel format
Permission Requirements
Ensure your SYNTHET bot has the necessary permissions:
Send Messages - Post notifications in the designated channel
Embed Links - Display video thumbnails and formatted content
Read Message History - Track notification settings
Manage Channels - Set up notification channels (admin only)
Tips & Best Practices
- • Create a dedicated #youtube-alerts channel to keep notifications organized
- • Use keyword filters to focus on content you actually want to see
- • Pause notifications temporarily during events or breaks without unsubscribing
- • Subscribe to multiple creators across different genres for variety
- • Check the status of YouTube alerts to ensure everything is working properly
- • Remember that notifications are delivered very quickly after upload
- • Use channel details to verify you're subscribed to the right creator
- • Keep your notification channel in a logical place in your server structure
Troubleshooting
Not receiving notifications
Check that you've set a notification channel with `/youtube set-notification-channel`. Verify the channel URL is correct and the channel exists.
Invalid channel URL
Use the channel's main page URL (https://youtube.com/@channelname). Avoid video URLs or playlist URLs.
Subscriptions not showing in /youtube list
Wait a few moments for the subscription to process, then try again. Verify the bot has proper permissions.
Keyword filters not working
Filters are case-insensitive but must match words in the video title. Use common keywords for better results.
Duplicate notifications
Check that you haven't subscribed to the same channel multiple times. Use `/youtube list` to verify subscriptions.