discord-player-youtubei

Discord Player YouTubei

This is a preview the v7 version of the YouTube system that discord-player will be using made backwards compatiable with v6.

Installation

$ npm install discord-player-youtubei
# ----------- or -----------
$ yarn add discord-player-youtubei

Usage

Typescript and ESM

import { YoutubeiExtractor } from "discord-player-youtubei"

const player = getPlayerSomehow()

player.extractors.register(YoutubeiExtractor, {})

CommonJS

const { YoutubeiExtractor } = require("discord-player-youtubei")

const player = getPlayerSomehow()

player.extractors.register(YoutubeiExtractor, {})

Signing into YouTube

With the power of youtubei.js, we can sign into YouTube through their YouTube TV API.

import { generateOauthTokens } from "discord-player-youtubei";

(async () => {
    await generateOauthTokens()
})()

Oauth Tokens will be printed out shortly

These tokens can be used as an option for YoutubeiExtractor

import { YoutubeiExtractor } from "discord-player-youtubei"

const player = getPlayerSomehow()
const oauthTokens = getOauthTokens() // The tokens printed from `generateOauthTokens()

player.extractors.register(YoutubeiExtractor, {
    authentication: oauthTokens
})

Options for YoutubeiExtractor

interface YoutubeiOptions {
    authentication?: OAuth2Tokens;
    overrideDownloadOptions?: DownloadOptions;
    createStream?: (q: string, extractor: BaseExtractor<object>) => Promise<string|Readable>;
    signOutOnDeactive?: boolean;
}

Notice Regarding YouTube Streaming

Streaming from YouTube is against their Terms of Service (ToS). Refer to LEGAL.md to view the risks using YouTube.