Skip to content

ivkos/botyo-command-youtube

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

YouTube Command for Botyo

npm npm npm

The YouTube Command for Botyo posts a YouTube video to the chat.

Usage

#yt <search query> or #youtube <search query>

For example:

  • #yt Starboy
  • #yt ozzy man cat vs mantis

Requirements

You need to obtain an API key to use the YouTube Data API. Please refer to the YouTube API Reference for instructions how to do so.

Install

Step 1. Install the module from npm.

npm install --save botyo-command-youtube

Step 2. Configure the API key in your configuration file config.yaml

modules:
  YouTubeCommand:
    apiKey: YOUR_YOUTUBE_API_KEY # https://developers.google.com/youtube/v3/docs/#calling-the-api

Step 3. Register the module.

import Botyo from "botyo";
import YouTubeCommand from "botyo-command-youtube"

Botyo.builder()
    ...
    .registerModule(YouTubeCommand)
    ...
    .build()
    .start();

Configuration

The configuration of the YouTube command modules has some sensible defaults. However, you can still override the defaults if you need to.

modules:
  YouTubeCommand:
    apiKey: YOUR_YOUTUBE_API_KEY # https://developers.google.com/youtube/v3/docs/#calling-the-api
    regionCode: US               # Return search results for the specified country. (ISO 3166-1 alpha-2 country code)
    order: relevance             # Method to use to order videos: date/rating/relevance/title/viewCount
    safeSearch: moderate         # Indicates whether the search results should include restricted content as well as standard content; moderate/none/strict

You can override all configuration properties (except apiKey) on a per-chat-thread basis. For example:

modules:
  YouTubeCommand:
    apiKey: YOUR_YOUTUBE_API_KEY
    regionCode: US
    order: relevance
    safeSearch: moderate

chat-threads:
  SOME_CHAT_THREAD_ID:
    overrides:
      modules.YouTubeCommand:
        regionCode: BG
        order: viewCount
  OTHER_CHAT_THREAD_ID:
    overrides:
      modules.YouTubeCommand:
        enable: false     # disables the command for this chat thread

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published