Class DisTube

DisTube class

Hierarchy

TypedEmitter<TypedDisTubeEvents>
- DisTube

Constructors

constructor

new DisTube(client, opts?): DisTube
Create a new DisTube class.
Parameters
- client: Client<boolean>
 Discord.JS client
- opts: DisTubeOptions = {}
 Custom DisTube options
Returns DisTube
Throws
DisTubeError
Overrides TypedEmitter<TypedDisTubeEvents>.constructor
- Defined in src/DisTube.ts:158

Properties

`Readonly`client

client: Client<boolean>

Discord.js v14 client

`Readonly`filters

filters: Filters

DisTube ffmpeg audio filters

`Readonly`handler

handler: DisTubeHandler

DisTube internal handler

`Readonly`options

options: Options

DisTube options

`Readonly`plugins

plugins: DisTubePlugin[]

DisTube plugins

`Readonly`queues

queues: QueueManager

Queues manager

`Readonly`voices

voices: DisTubeVoiceManager

DisTube voice connections manager

`Static`defaultMaxListeners

defaultMaxListeners: number

Accessors

version

get version(): string
DisTube version

Returns string
- Defined in src/DisTube.ts:180

`Static`version

get version(): string
Returns string
- Defined in src/DisTube.ts:173

Methods

addListener

addListener(event, listener): this
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- event: U
- listener: TypedDisTubeEvents[U]
Returns this
Inherited from TypedEmitter.addListener
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:11

addRelatedSong

addRelatedSong(guild): Promise<Song<unknown>>
Add related song to the queue
Parameters
- guild: GuildIdResolvable
 The type can be resolved to give a Queue
Returns Promise<Song<unknown>>
The guild queue
- Defined in src/DisTube.ts:421

createCustomPlaylist

createCustomPlaylist(songs, options?): Promise<Playlist<unknown>>
Create a custom playlist
Parameters
- songs: (string | Song<unknown>)[]
 Array of url or Song
- options: CustomPlaylistOptions = {}
 Optional options
Returns Promise<Playlist<unknown>>
- Defined in src/DisTube.ts:268

debug

debug(message): void
Emit debug event
Parameters
- message: string
  debug message
Returns void
- Defined in src/DisTube.ts:449

emit

emit(event, ...args): boolean
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- event: U
- Rest...args: Parameters<TypedDisTubeEvents[U]>
Returns boolean
Inherited from TypedEmitter.emit
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:19

emitError

emitError(error, queue, song?): void
Emit error event
Parameters
- error: Error
 error
- queue: Queue
 The queue encountered the error
- Optionalsong: Song<unknown>
 The playing song when encountered the error
Returns void
- Defined in src/DisTube.ts:441

eventNames

eventNames(): U[]
Type Parameters
- U extends keyof DisTubeEvents
Returns U[]
Inherited from TypedEmitter.eventNames
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:20

getMaxListeners

getMaxListeners(): number
Returns number
Inherited from TypedEmitter.getMaxListeners
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:24

getQueue

getQueue(guild): undefined | Queue
Get the guild queue
Parameters
- guild: GuildIdResolvable
  The type can be resolved to give a Queue
Returns undefined | Queue
- Defined in src/DisTube.ts:308

jump

jump(guild, num): Promise<Song<unknown>>
Jump to the song number in the queue. The next one is 1, 2,... The previous one is -1, -2,...
Parameters
- guild: GuildIdResolvable
 The type can be resolved to give a Queue
- num: number
 The song number to play
Returns Promise<Song<unknown>>
The new Song will be played
- Defined in src/DisTube.ts:390

listenerCount

listenerCount(type): number
Parameters
- type: keyof DisTubeEvents
Returns number
Inherited from TypedEmitter.listenerCount
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:21

listeners

listeners(type): TypedDisTubeEvents[U][]
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- type: U
Returns TypedDisTubeEvents[U][]
Inherited from TypedEmitter.listeners
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:22

off

off(event, listener): this
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- event: U
- listener: TypedDisTubeEvents[U]
Returns this
Inherited from TypedEmitter.off
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:18

on

on(event, listener): this
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- event: U
- listener: TypedDisTubeEvents[U]
Returns this
Inherited from TypedEmitter.on
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:17

once

once(event, listener): this
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- event: U
- listener: TypedDisTubeEvents[U]
Returns this
Inherited from TypedEmitter.once
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:16

pause

pause(guild): Promise<Queue>
Pause the guild stream
Parameters
- guild: GuildIdResolvable
 The type can be resolved to give a Queue
Returns Promise<Queue>
The guild queue
- Defined in src/DisTube.ts:323

play

play<T>(voiceChannel, song, options?): Promise<void>
Play / add a song or playlist from url. Search and play a song (with ExtractorPlugin) if it is not a valid url.
Type Parameters
- T = unknown
Parameters
- voiceChannel: VoiceBasedChannel
 The channel will be joined if the bot isn't in any channels, the bot will be moved to this channel if DisTubeOptions.joinNewVoiceChannel is true
- song: string | Playlist<unknown> | Song<unknown>
 URL | Search string | Song | Playlist
- options: PlayOptions<T> = {}
 Optional options
Returns Promise<void>
Throws
DisTubeError
- Defined in src/DisTube.ts:193

prependListener

prependListener(event, listener): this
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- event: U
- listener: TypedDisTubeEvents[U]
Returns this
Inherited from TypedEmitter.prependListener
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:12

prependOnceListener

prependOnceListener(event, listener): this
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- event: U
- listener: TypedDisTubeEvents[U]
Returns this
Inherited from TypedEmitter.prependOnceListener
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:13

previous(guild): Promise<Song<unknown>>
Play the previous song
Parameters
- guild: GuildIdResolvable
 The type can be resolved to give a Queue
Returns Promise<Song<unknown>>
The new Song will be played
- Defined in src/DisTube.ts:370

rawListeners

rawListeners(type): TypedDisTubeEvents[U][]
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- type: U
Returns TypedDisTubeEvents[U][]
Inherited from TypedEmitter.rawListeners
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:23

removeAllListeners

removeAllListeners(event?): this
Parameters
- Optionalevent: keyof DisTubeEvents
Returns this
Inherited from TypedEmitter.removeAllListeners
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:15

removeListener

removeListener(event, listener): this
Type Parameters
- U extends keyof DisTubeEvents
Parameters
- event: U
- listener: TypedDisTubeEvents[U]
Returns this
Inherited from TypedEmitter.removeListener
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:14

resume

resume(guild): Promise<Queue>
Resume the guild stream
Parameters
- guild: GuildIdResolvable
 The type can be resolved to give a Queue
Returns Promise<Queue>
The guild queue
- Defined in src/DisTube.ts:332

seek

seek(guild, time): Queue
Set the playing time to another position
Parameters
- guild: GuildIdResolvable
  The type can be resolved to give a Queue
- time: number
  Time in seconds
Returns Queue
Seeked queue
- Defined in src/DisTube.ts:431

setMaxListeners

setMaxListeners(n): this
Parameters
- n: number
Returns this
Inherited from TypedEmitter.setMaxListeners
- Defined in node_modules/.pnpm/tiny-typed-emitter@2.1.0/node_modules/tiny-typed-emitter/lib/index.d.ts:25

setRepeatMode

setRepeatMode(guild, mode?): RepeatMode
Set the repeat mode of the guild queue. Toggle mode (Disabled -> Song -> Queue -> Disabled ->...) if mode is undefined
Parameters
- guild: GuildIdResolvable
  The type can be resolved to give a Queue
- Optionalmode: RepeatMode
  The repeat modes (toggle if undefined)
Returns RepeatMode
The new repeat mode
- Defined in src/DisTube.ts:401

setVolume

setVolume(guild, percent): Queue
Set the guild stream's volume
Parameters
- guild: GuildIdResolvable
  The type can be resolved to give a Queue
- percent: number
  The percentage of volume you want to set
Returns Queue
The guild queue
- Defined in src/DisTube.ts:350

shuffle

shuffle(guild): Promise<Queue>
Shuffle the guild queue songs
Parameters
- guild: GuildIdResolvable
 The type can be resolved to give a Queue
Returns Promise<Queue>
The guild queue
- Defined in src/DisTube.ts:379

skip

skip(guild): Promise<Song<unknown>>
Skip the playing song if there is a next song in the queue. If Queue#autoplay is true and there is no up next song, DisTube will add and play a related song.
Parameters
- guild: GuildIdResolvable
 The type can be resolved to give a Queue
Returns Promise<Song<unknown>>
The new Song will be played
- Defined in src/DisTube.ts:361

stop

stop(guild): Promise<void>
Stop the guild stream
Parameters
- guild: GuildIdResolvable
 The type can be resolved to give a Queue
Returns Promise<void>
- Defined in src/DisTube.ts:340

toggleAutoplay

toggleAutoplay(guild): boolean
Toggle autoplay mode
Parameters
- guild: GuildIdResolvable
  The type can be resolved to give a Queue
Returns boolean
Autoplay mode state
- Defined in src/DisTube.ts:410

Events

`Static` `Readonly`addList

addList: ((queue: Queue, playlist: Playlist<unknown>) => any)

Emitted after DisTube add a new playlist to the playing Queue.

Type declaration

- (queue, playlist): any
- Parameters
 - queue: Queue
 The guild queue
 - playlist: Playlist<unknown>
 Playlist info
 Returns any

`Static` `Readonly`addSong

addSong: ((queue: Queue, song: Song<unknown>) => any)

Emitted after DisTube add a new song to the playing Queue.

Type declaration

- (queue, song): any
- Parameters
 - queue: Queue
 The guild queue
 - song: Song<unknown>
 Added song
 Returns any

`Static` `Readonly`debug

debug: ((debug: string) => any)

Emitted to provide debug information from DisTube's operation. Useful for troubleshooting or logging purposes.

Type declaration

- (debug): any
- Parameters
  - debug: string
    Debug message string.
  Returns any

`Static` `Readonly`deleteQueue

deleteQueue: ((queue: Queue) => any)

Emitted when a Queue is deleted with any reasons.

Type declaration

- (queue): any
- Parameters
  - queue: Queue
    The guild queue
  Returns any

`Static` `Readonly`disconnect

disconnect: ((queue: Queue) => any)

Emitted when the bot is disconnected to a voice channel.

Type declaration

- (queue): any
- Parameters
  - queue: Queue
    The guild queue
  Returns any

`Static` `Readonly`error

error: ((error: Error, queue: Queue, song?: Song<unknown>) => any)

Emitted when DisTube encounters an error while playing songs.

Type declaration

- (error, queue, song?): any
- Parameters
 - error: Error
 error
 - queue: Queue
 The queue encountered the error
 - Optionalsong: Song<unknown>
 The playing song when encountered the error
 Returns any

`Static` `Readonly`ffmpegDebug

ffmpegDebug: ((debug: string) => any)

Emitted for logging FFmpeg debug information.

Type declaration

- (debug): any
- Parameters
  - debug: string
    Debug message string.
  Returns any

`Static` `Readonly`finish

finish: ((queue: Queue) => any)

Emitted when there is no more song in the queue and Queue#autoplay is false.

Type declaration

- (queue): any
- Parameters
  - queue: Queue
    The guild queue
  Returns any

`Static` `Readonly`finishSong

finishSong: ((queue: Queue, song: Song<unknown>) => any)

Emitted when DisTube finished a song.

Type declaration

- (queue, song): any
- Parameters
 - queue: Queue
 The guild queue
 - song: Song<unknown>
 Finished song
 Returns any

`Static` `Readonly`initQueue

initQueue: ((queue: Queue) => any)

Emitted when DisTube initialize a queue to change queue default properties.

Type declaration

- (queue): any
- Parameters
  - queue: Queue
    The guild queue
  Returns any

`Static` `Readonly`noRelated

noRelated: ((queue: Queue) => any)

Emitted when Queue#autoplay is true, Queue#songs is empty, and DisTube cannot find related songs to play.

Type declaration

- (queue): any
- Parameters
  - queue: Queue
    The guild queue
  Returns any

`Static` `Readonly`playSong

playSong: ((queue: Queue, song: Song<unknown>) => any)

Emitted when DisTube play a song. If DisTubeOptions.emitNewSongOnly is true, this event is not emitted when looping a song or next song is the previous one.

Type declaration

- (queue, song): any
- Parameters
 - queue: Queue
 The guild queue
 - song: Song<unknown>
 Playing song
 Returns any

Class DisTube

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Events

Constructors

constructor

Parameters

Returns DisTube

Throws

Properties

Readonlyclient

Readonlyfilters

Readonlyhandler

Readonlyoptions

Readonlyplugins

Readonlyqueues

Readonlyvoices

StaticdefaultMaxListeners

Accessors

version

Returns string

Staticversion

Returns string

Methods

addListener

Type Parameters

Parameters

Returns this

addRelatedSong

Parameters

Returns Promise<Song<unknown>>

createCustomPlaylist

Parameters

Returns Promise<Playlist<unknown>>

debug

Parameters

Returns void

emit

Type Parameters

Parameters

Returns boolean

emitError

Parameters

Returns void

eventNames

Type Parameters

Returns U[]

getMaxListeners

Returns number

getQueue

Parameters

Returns undefined | Queue

jump

Parameters

Returns Promise<Song<unknown>>

listenerCount

Parameters

Returns number

listeners

Type Parameters

Parameters

Returns TypedDisTubeEvents[U][]

off

Type Parameters

Parameters

Returns this

on

Type Parameters

Parameters

Returns this

once

Type Parameters

Parameters

Returns this

pause

Parameters

`Readonly`client

`Readonly`filters

`Readonly`handler

`Readonly`options

`Readonly`plugins

`Readonly`queues

`Readonly`voices

`Static`defaultMaxListeners

`Static`version

`Static` `Readonly`addList

`Static` `Readonly`addSong

`Static` `Readonly`debug

`Static` `Readonly`deleteQueue