Youtube

Get notifications about uploaded YouTube videos, and search for any YouTube data!

The YouTube module will allow bot users to search for YouTube videos and channels, and see notifications of new uploads.

Credentials Setup

The module requires you to create an application on the Google Cloud Console, to communicate with the YouTube API. Follow the steps below to retrieve your API key, and paste it into the settings of the module:

Project Creation page for Google Cloud Console
API/Service Details page for Google Cloud Console
Create Credentials (Credential Type) page for Google Cloud Console
Create Credentials (Your Credentials) page for Google Cloud Console


Settings

Upload Notifications

In this area, you can set up (a) new upload tracker(s) to receive notifications for newly uploaded videos from YouTube channels.

Announcement Channel

From this dropdown, you may choose which channel new uploads will be announced in.

YouTube Channel Handle

In this field, input the handle of the YouTube channel you are tracking uploads for. The handle can be found by opening the channel in a browser and checking the URL.

Search Filter

From this dropdown you can choose the type of notification you would like to receive.

Filter Type
Details

All Uploads

If selected, you will receive notifications for all uploaded videos from the channel.

Uploads Matching Query

If this option is selected then only notifications for videos that match the query input will be posted.

Search Query

In this field you can input a term in which the bot will only search and post notifications based off that query. This setting is only visible with Search Filter set to "Uploads Matching Query.

Notification Roles

From this selection you can choose server roles that will be pinged once a notification is posted.

YouTube Upload Notification

In this section you can customize the message for the notifications that will be posted. Module variables can be used to customize this.

Automatically Cross-post Message

If this toggle is enabled then notifications posted in an announcement channel chosen from Announcement Channel will automatically get published to all servers / channels that follow the channel.

To save the upload tracker's settings, you need to click "Add" in the bottom-right corner of the settings.

Tracked Uploads

In this area, you can view, edit, and delete the settings for the upload tracker(s) you added above.

When adding a new upload tracker, it and its settings will appear in this section. All upload trackers will be ordered by the number in which they were created.

To view, edit, and delete the settings you selected above for that tracker, simply click the dropdown arrow next to the upload tracker you wish to do so for.

To save the edits you made on the upload tracker's settings, you need to click "Edit" in the bottom-right corner of the settings.

Search Filters

In this area, you can customize the filters used in search results of the /youtube-search command and search query trackers.

YouTube Safe Search Type

In this section you can change the filter sensitivity for the command. It can be changed from having no filter, to having a highly sensitive one that won't allow inappropriate content.

Definition Requirement

From this dropdown you can define the quality of the searched content.

Duration Requirement

From this dropdown you can define the duration of the searched content.

Variables

Here is some module variables that can be used to customize Upload Notifications.

Variable
Details

{video_title}

Displays the video title.

{video_thumbnail}

Displays the video thumbnail

{video_channel}

Displays the video channel name

{video_description}

Displays the video description

{video_url}

Links the url for the video.


Commands

Below you may find some information on each command of the module.

/youtube channel

This command is what your users can run to search for a YouTube channel.


Events

Below you may find some information on each event of the module.

YouTube Handler

This event handles your upload trackers according to the settings for them you specified.

Last updated