botyo-command-youtube
TypeScript icon, indicating that this package has built-in type declarations

2.0.1 • Public • Published

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 

Package Sidebar

Install

npm i botyo-command-youtube

Weekly Downloads

0

Version

2.0.1

License

Apache-2.0

Unpacked Size

52.2 kB

Total Files

8

Last publish

Collaborators

  • ivkos