distube 5.0.7 → 5.1.0

package/dist/index.mjs

@@ -1,37 +1,8 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
-// src/type.ts
-var Events = /* @__PURE__ */ ((Events2) => {
-  Events2["ERROR"] = "error";
-  Events2["ADD_LIST"] = "addList";
-  Events2["ADD_SONG"] = "addSong";
-  Events2["PLAY_SONG"] = "playSong";
-  Events2["FINISH_SONG"] = "finishSong";
-  Events2["EMPTY"] = "empty";
-  Events2["FINISH"] = "finish";
-  Events2["INIT_QUEUE"] = "initQueue";
-  Events2["NO_RELATED"] = "noRelated";
-  Events2["DISCONNECT"] = "disconnect";
-  Events2["DELETE_QUEUE"] = "deleteQueue";
-  Events2["FFMPEG_DEBUG"] = "ffmpegDebug";
-  Events2["DEBUG"] = "debug";
-  return Events2;
-})(Events || {});
-var RepeatMode = /* @__PURE__ */ ((RepeatMode2) => {
-  RepeatMode2[RepeatMode2["DISABLED"] = 0] = "DISABLED";
-  RepeatMode2[RepeatMode2["SONG"] = 1] = "SONG";
-  RepeatMode2[RepeatMode2["QUEUE"] = 2] = "QUEUE";
-  return RepeatMode2;
-})(RepeatMode || {});
-var PluginType = /* @__PURE__ */ ((PluginType2) => {
-  PluginType2["EXTRACTOR"] = "extractor";
-  PluginType2["INFO_EXTRACTOR"] = "info-extractor";
-  PluginType2["PLAYABLE_EXTRACTOR"] = "playable-extractor";
-  return PluginType2;
-})(PluginType || {});
-
 // src/constant.ts
+var version = "5.1.0";
 var defaultFilters = {
   "3d": "apulsator=hz=0.125",
   bassboost: "bass=g=10",
@@ -59,8 +30,82 @@ var defaultOptions = {
   joinNewVoiceChannel: true
 };
 
+// src/core/DisTubeBase.ts
+var DisTubeBase = class {
+  static {
+    __name(this, "DisTubeBase");
+  }
+  distube;
+  constructor(distube) {
+    this.distube = distube;
+  }
+  /**
+   * Emit the {@link DisTube} of this base
+   * @param eventName - Event name
+   * @param args      - arguments
+   */
+  emit(eventName, ...args) {
+    return this.distube.emit(eventName, ...args);
+  }
+  /**
+   * Emit error event
+   * @param error   - error
+   * @param queue   - The queue encountered the error
+   * @param song    - The playing song when encountered the error
+   */
+  emitError(error, queue, song) {
+    this.distube.emitError(error, queue, song);
+  }
+  /**
+   * Emit debug event
+   * @param message - debug message
+   */
+  debug(message) {
+    this.distube.debug(message);
+  }
+  /**
+   * The queue manager
+   */
+  get queues() {
+    return this.distube.queues;
+  }
+  /**
+   * The voice manager
+   */
+  get voices() {
+    return this.distube.voices;
+  }
+  /**
+   * Discord.js client
+   */
+  get client() {
+    return this.distube.client;
+  }
+  /**
+   * DisTube options
+   */
+  get options() {
+    return this.distube.options;
+  }
+  /**
+   * DisTube handler
+   */
+  get handler() {
+    return this.distube.handler;
+  }
+  /**
+   * DisTube plugins
+   */
+  get plugins() {
+    return this.distube.plugins;
+  }
+};
+
+// src/core/DisTubeHandler.ts
+import { request } from "undici";
+
 // src/struct/DisTubeError.ts
-import { inspect } from "node:util";
+import { inspect } from "util";
 var ERROR_MESSAGES = {
   INVALID_TYPE: /* @__PURE__ */ __name((expected, got, name) => `Expected ${Array.isArray(expected) ? expected.map((e) => typeof e === "number" ? e : `'${e}'`).join(" or ") : `'${expected}'`}${name ? ` for '${name}'` : ""}, but got ${inspect(got)} (${typeof got})`, "INVALID_TYPE"),
   NUMBER_COMPARE: /* @__PURE__ */ __name((name, expected, value) => `'${name}' must be ${expected} ${value}`, "NUMBER_COMPARE"),
@@ -131,1919 +176,1838 @@ var DisTubeError = class _DisTubeError extends Error {
   }
 };
 
-// src/struct/TaskQueue.ts
-var Task = class {
+// src/util.ts
+import { URL as URL2 } from "url";
+import { Constants as Constants2, GatewayIntentBits, IntentsBitField, SnowflakeUtil } from "discord.js";
+
+// src/core/DisTubeVoice.ts
+import {
+  AudioPlayerStatus,
+  createAudioPlayer,
+  entersState,
+  joinVoiceChannel,
+  VoiceConnectionDisconnectReason,
+  VoiceConnectionStatus
+} from "@discordjs/voice";
+import { Constants } from "discord.js";
+import { TypedEmitter } from "tiny-typed-emitter";
+var DisTubeVoice = class extends TypedEmitter {
   static {
-    __name(this, "Task");
+    __name(this, "DisTubeVoice");
   }
-  resolve;
-  promise;
-  isPlay;
-  constructor(isPlay) {
-    this.isPlay = isPlay;
-    this.promise = new Promise((res) => {
-      this.resolve = res;
+  id;
+  voices;
+  audioPlayer;
+  connection;
+  emittedError;
+  isDisconnected = false;
+  stream;
+  pausingStream;
+  #channel;
+  #volume = 100;
+  constructor(voiceManager, channel) {
+    super();
+    this.voices = voiceManager;
+    this.id = channel.guildId;
+    this.channel = channel;
+    this.voices.add(this.id, this);
+    this.audioPlayer = createAudioPlayer().on(AudioPlayerStatus.Idle, (oldState) => {
+      if (oldState.status !== AudioPlayerStatus.Idle) this.emit("finish");
+    }).on("error", (error) => {
+      if (this.emittedError) return;
+      this.emittedError = true;
+      this.emit("error", error);
     });
+    this.connection.on(VoiceConnectionStatus.Disconnected, (_, newState) => {
+      if (newState.reason === VoiceConnectionDisconnectReason.Manual) {
+        this.leave();
+      } else if (newState.reason === VoiceConnectionDisconnectReason.WebSocketClose && newState.closeCode === 4014) {
+        entersState(this.connection, VoiceConnectionStatus.Connecting, 5e3).catch(() => {
+          if (![VoiceConnectionStatus.Ready, VoiceConnectionStatus.Connecting].includes(this.connection.state.status)) {
+            this.leave();
+          }
+        });
+      } else if (this.connection.rejoinAttempts < 5) {
+        setTimeout(
+          () => {
+            this.connection.rejoin();
+          },
+          (this.connection.rejoinAttempts + 1) * 5e3
+        ).unref();
+      } else if (this.connection.state.status !== VoiceConnectionStatus.Destroyed) {
+        this.leave(new DisTubeError("VOICE_RECONNECT_FAILED"));
+      }
+    }).on(VoiceConnectionStatus.Destroyed, () => {
+      this.leave();
+    }).on("error", () => void 0);
+    this.connection.subscribe(this.audioPlayer);
   }
-};
-var TaskQueue = class {
-  static {
-    __name(this, "TaskQueue");
-  }
-  /**
-   * The task array
-   */
-  #tasks = [];
   /**
-   * Waits for last task finished and queues a new task
+   * The voice channel id the bot is in
    */
-  queuing(isPlay = false) {
-    const next = this.remaining ? this.#tasks[this.#tasks.length - 1].promise : Promise.resolve();
-    this.#tasks.push(new Task(isPlay));
-    return next;
+  get channelId() {
+    return this.connection?.joinConfig?.channelId ?? void 0;
+  }
+  get channel() {
+    if (!this.channelId) return this.#channel;
+    if (this.#channel?.id === this.channelId) return this.#channel;
+    const channel = this.voices.client.channels.cache.get(this.channelId);
+    if (!channel) return this.#channel;
+    for (const type of Constants.VoiceBasedChannelTypes) {
+      if (channel.type === type) {
+        this.#channel = channel;
+        return channel;
+      }
+    }
+    return this.#channel;
+  }
+  set channel(channel) {
+    if (!isSupportedVoiceChannel(channel)) {
+      throw new DisTubeError("INVALID_TYPE", "BaseGuildVoiceChannel", channel, "DisTubeVoice#channel");
+    }
+    if (channel.guildId !== this.id) throw new DisTubeError("VOICE_DIFFERENT_GUILD");
+    if (channel.client.user?.id !== this.voices.client.user?.id) throw new DisTubeError("VOICE_DIFFERENT_CLIENT");
+    if (channel.id === this.channelId) return;
+    if (!channel.joinable) {
+      if (channel.full) throw new DisTubeError("VOICE_FULL");
+      else throw new DisTubeError("VOICE_MISSING_PERMS");
+    }
+    this.connection = this.#join(channel);
+    this.#channel = channel;
+  }
+  #join(channel) {
+    return joinVoiceChannel({
+      channelId: channel.id,
+      guildId: this.id,
+      adapterCreator: channel.guild.voiceAdapterCreator,
+      group: channel.client.user?.id
+    });
   }
   /**
-   * Removes the finished task and processes the next task
+   * Join a voice channel with this connection
+   * @param channel - A voice channel
    */
-  resolve() {
-    this.#tasks.shift()?.resolve();
+  async join(channel) {
+    const TIMEOUT = 3e4;
+    if (channel) this.channel = channel;
+    try {
+      await entersState(this.connection, VoiceConnectionStatus.Ready, TIMEOUT);
+    } catch {
+      if (this.connection.state.status === VoiceConnectionStatus.Ready) return this;
+      if (this.connection.state.status !== VoiceConnectionStatus.Destroyed) this.connection.destroy();
+      this.voices.remove(this.id);
+      throw new DisTubeError("VOICE_CONNECT_FAILED", TIMEOUT / 1e3);
+    }
+    return this;
   }
   /**
-   * The remaining number of tasks
+   * Leave the voice channel of this connection
+   * @param error - Optional, an error to emit with 'error' event.
    */
-  get remaining() {
-    return this.#tasks.length;
+  leave(error) {
+    this.stop(true);
+    if (!this.isDisconnected) {
+      this.emit("disconnect", error);
+      this.isDisconnected = true;
+    }
+    if (this.connection.state.status !== VoiceConnectionStatus.Destroyed) this.connection.destroy();
+    this.voices.remove(this.id);
   }
   /**
-   * Whether or not having a play task
+   * Stop the playing stream
+   * @param force - If true, will force the {@link DisTubeVoice#audioPlayer} to enter the Idle state even
+   *                if the {@link DisTubeStream#audioResource} has silence padding frames.
    */
-  get hasPlayTask() {
-    return this.#tasks.some((t) => t.isPlay);
-  }
-};
-
-// src/struct/Playlist.ts
-var Playlist = class {
-  static {
-    __name(this, "Playlist");
+  stop(force = false) {
+    this.audioPlayer.stop(force);
   }
   /**
-   * Playlist source.
-   */
-  source;
-  /**
-   * Songs in the playlist.
-   */
-  songs;
-  /**
-   * Playlist ID.
+   * Play a {@link DisTubeStream}
+   * @param dtStream - DisTubeStream
    */
-  id;
+  async play(dtStream) {
+    if (!await checkEncryptionLibraries()) {
+      dtStream.kill();
+      throw new DisTubeError("ENCRYPTION_LIBRARIES_MISSING");
+    }
+    this.emittedError = false;
+    dtStream.on("error", (error) => {
+      if (this.emittedError || error.code === "ERR_STREAM_PREMATURE_CLOSE") return;
+      this.emittedError = true;
+      this.emit("error", error);
+    });
+    if (this.audioPlayer.state.status !== AudioPlayerStatus.Paused) {
+      this.audioPlayer.play(dtStream.audioResource);
+      this.stream?.kill();
+      dtStream.spawn();
+    } else if (!this.pausingStream) {
+      this.pausingStream = this.stream;
+    }
+    this.stream = dtStream;
+    this.volume = this.#volume;
+  }
+  set volume(volume) {
+    if (typeof volume !== "number" || Number.isNaN(volume)) {
+      throw new DisTubeError("INVALID_TYPE", "number", volume, "volume");
+    }
+    if (volume < 0) {
+      throw new DisTubeError("NUMBER_COMPARE", "Volume", "bigger or equal to", 0);
+    }
+    this.#volume = volume;
+    this.stream?.setVolume((this.#volume / 100) ** (0.5 / Math.log10(2)));
+  }
   /**
-   * Playlist name.
+   * Get or set the volume percentage
    */
-  name;
+  get volume() {
+    return this.#volume;
+  }
   /**
-   * Playlist URL.
+   * Playback duration of the audio resource in seconds
    */
-  url;
+  get playbackDuration() {
+    return (this.stream?.audioResource?.playbackDuration ?? 0) / 1e3;
+  }
+  pause() {
+    this.audioPlayer.pause();
+  }
+  unpause() {
+    const state = this.audioPlayer.state;
+    if (state.status !== AudioPlayerStatus.Paused) return;
+    if (this.stream?.audioResource && state.resource !== this.stream.audioResource) {
+      this.audioPlayer.play(this.stream.audioResource);
+      this.stream.spawn();
+      this.pausingStream?.kill();
+      delete this.pausingStream;
+    } else {
+      this.audioPlayer.unpause();
+    }
+  }
   /**
-   * Playlist thumbnail.
+   * Whether the bot is self-deafened
    */
-  thumbnail;
-  #metadata;
-  #member;
+  get selfDeaf() {
+    return this.connection.joinConfig.selfDeaf;
+  }
   /**
-   * Create a Playlist
-   * @param playlist  - Raw playlist info
-   * @param options   - Optional data
+   * Whether the bot is self-muted
    */
-  constructor(playlist, { member, metadata } = {}) {
-    if (!Array.isArray(playlist.songs) || !playlist.songs.length) throw new DisTubeError("EMPTY_PLAYLIST");
-    this.source = playlist.source.toLowerCase();
-    this.songs = playlist.songs;
-    this.name = playlist.name;
-    this.id = playlist.id;
-    this.url = playlist.url;
-    this.thumbnail = playlist.thumbnail;
-    this.member = member;
-    this.songs.forEach((s) => s.playlist = this);
-    this.metadata = metadata;
+  get selfMute() {
+    return this.connection.joinConfig.selfMute;
   }
   /**
-   * Playlist duration in second.
+   * Self-deafens/undeafens the bot.
+   * @param selfDeaf - Whether or not the bot should be self-deafened
+   * @returns true if the voice state was successfully updated, otherwise false
    */
-  get duration() {
-    return this.songs.reduce((prev, next) => prev + next.duration, 0);
+  setSelfDeaf(selfDeaf) {
+    if (typeof selfDeaf !== "boolean") {
+      throw new DisTubeError("INVALID_TYPE", "boolean", selfDeaf, "selfDeaf");
+    }
+    return this.connection.rejoin({
+      ...this.connection.joinConfig,
+      selfDeaf
+    });
   }
   /**
-   * Formatted duration string `hh:mm:ss`.
+   * Self-mutes/unmutes the bot.
+   * @param selfMute - Whether or not the bot should be self-muted
+   * @returns true if the voice state was successfully updated, otherwise false
    */
-  get formattedDuration() {
-    return formatDuration(this.duration);
+  setSelfMute(selfMute) {
+    if (typeof selfMute !== "boolean") {
+      throw new DisTubeError("INVALID_TYPE", "boolean", selfMute, "selfMute");
+    }
+    return this.connection.rejoin({
+      ...this.connection.joinConfig,
+      selfMute
+    });
   }
   /**
-   * User requested.
+   * The voice state of this connection
    */
-  get member() {
-    return this.#member;
+  get voiceState() {
+    return this.channel?.guild?.members?.me?.voice;
   }
-  set member(member) {
-    if (!isMemberInstance(member)) return;
-    this.#member = member;
-    this.songs.forEach((s) => s.member = this.member);
+};
+
+// src/core/manager/BaseManager.ts
+import { Collection } from "discord.js";
+var BaseManager = class extends DisTubeBase {
+  static {
+    __name(this, "BaseManager");
   }
   /**
-   * User requested.
+   * The collection of items for this manager.
    */
-  get user() {
-    return this.member?.user;
-  }
+  collection = new Collection();
   /**
-   * Optional metadata that can be used to identify the playlist.
+   * The size of the collection.
    */
-  get metadata() {
-    return this.#metadata;
-  }
-  set metadata(metadata) {
-    this.#metadata = metadata;
-    this.songs.forEach((s) => s.metadata = metadata);
-  }
-  toString() {
-    return `${this.name} (${this.songs.length} songs)`;
+  get size() {
+    return this.collection.size;
   }
 };
 
-// src/struct/Song.ts
-var Song = class {
+// src/core/manager/FilterManager.ts
+var FilterManager = class extends BaseManager {
   static {
-    __name(this, "Song");
+    __name(this, "FilterManager");
   }
   /**
-   * The source of this song info
+   * The queue to manage
    */
-  source;
+  queue;
+  constructor(queue) {
+    super(queue.distube);
+    this.queue = queue;
+  }
+  #resolve(filter) {
+    if (typeof filter === "object" && typeof filter.name === "string" && typeof filter.value === "string") {
+      return filter;
+    }
+    if (typeof filter === "string" && Object.hasOwn(this.distube.filters, filter)) {
+      return {
+        name: filter,
+        value: this.distube.filters[filter]
+      };
+    }
+    throw new DisTubeError("INVALID_TYPE", "FilterResolvable", filter, "filter");
+  }
+  #apply() {
+    this.queue._beginTime = this.queue.currentTime;
+    this.queue.play(false);
+  }
   /**
-   * Song ID.
+   * Enable a filter or multiple filters to the manager
+   * @param filterOrFilters - The filter or filters to enable
+   * @param override        - Wether or not override the applied filter with new filter value
    */
-  id;
+  add(filterOrFilters, override = false) {
+    if (Array.isArray(filterOrFilters)) {
+      for (const filter of filterOrFilters) {
+        const ft = this.#resolve(filter);
+        if (override || !this.has(ft)) this.collection.set(ft.name, ft);
+      }
+    } else {
+      const ft = this.#resolve(filterOrFilters);
+      if (override || !this.has(ft)) this.collection.set(ft.name, ft);
+    }
+    this.#apply();
+    return this;
+  }
   /**
-   * Song name.
+   * Clear enabled filters of the manager
    */
-  name;
+  clear() {
+    return this.set([]);
+  }
   /**
-   * Indicates if the song is an active live.
+   * Set the filters applied to the manager
+   * @param filters - The filters to apply
    */
-  isLive;
+  set(filters) {
+    if (!Array.isArray(filters)) throw new DisTubeError("INVALID_TYPE", "Array<FilterResolvable>", filters, "filters");
+    this.collection.clear();
+    for (const f of filters) {
+      const filter = this.#resolve(f);
+      this.collection.set(filter.name, filter);
+    }
+    this.#apply();
+    return this;
+  }
+  #removeFn(f) {
+    return this.collection.delete(this.#resolve(f).name);
+  }
   /**
-   * Song duration.
+   * Disable a filter or multiple filters
+   * @param filterOrFilters - The filter or filters to disable
    */
-  duration;
+  remove(filterOrFilters) {
+    if (Array.isArray(filterOrFilters)) filterOrFilters.forEach((f) => this.#removeFn(f));
+    else this.#removeFn(filterOrFilters);
+    this.#apply();
+    return this;
+  }
   /**
-   * Formatted duration string (`hh:mm:ss`, `mm:ss` or `Live`).
+   * Check whether a filter enabled or not
+   * @param filter - The filter to check
    */
-  formattedDuration;
+  has(filter) {
+    return this.collection.has(typeof filter === "string" ? filter : this.#resolve(filter).name);
+  }
   /**
-   * Song URL.
+   * Array of enabled filter names
    */
-  url;
+  get names() {
+    return [...this.collection.keys()];
+  }
   /**
-   * Song thumbnail.
+   * Array of enabled filters
    */
-  thumbnail;
+  get values() {
+    return [...this.collection.values()];
+  }
+  get ffmpegArgs() {
+    return this.size ? { af: this.values.map((f) => f.value).join(",") } : {};
+  }
+  toString() {
+    return this.names.toString();
+  }
+};
+
+// src/type.ts
+var Events = /* @__PURE__ */ ((Events2) => {
+  Events2["ERROR"] = "error";
+  Events2["ADD_LIST"] = "addList";
+  Events2["ADD_SONG"] = "addSong";
+  Events2["PLAY_SONG"] = "playSong";
+  Events2["FINISH_SONG"] = "finishSong";
+  Events2["EMPTY"] = "empty";
+  Events2["FINISH"] = "finish";
+  Events2["INIT_QUEUE"] = "initQueue";
+  Events2["NO_RELATED"] = "noRelated";
+  Events2["DISCONNECT"] = "disconnect";
+  Events2["DELETE_QUEUE"] = "deleteQueue";
+  Events2["FFMPEG_DEBUG"] = "ffmpegDebug";
+  Events2["DEBUG"] = "debug";
+  return Events2;
+})(Events || {});
+var RepeatMode = /* @__PURE__ */ ((RepeatMode2) => {
+  RepeatMode2[RepeatMode2["DISABLED"] = 0] = "DISABLED";
+  RepeatMode2[RepeatMode2["SONG"] = 1] = "SONG";
+  RepeatMode2[RepeatMode2["QUEUE"] = 2] = "QUEUE";
+  return RepeatMode2;
+})(RepeatMode || {});
+var PluginType = /* @__PURE__ */ ((PluginType2) => {
+  PluginType2["EXTRACTOR"] = "extractor";
+  PluginType2["INFO_EXTRACTOR"] = "info-extractor";
+  PluginType2["PLAYABLE_EXTRACTOR"] = "playable-extractor";
+  return PluginType2;
+})(PluginType || {});
+
+// src/struct/TaskQueue.ts
+var Task = class {
+  static {
+    __name(this, "Task");
+  }
+  resolve;
+  promise;
+  isPlay;
+  constructor(isPlay) {
+    this.isPlay = isPlay;
+    this.promise = new Promise((res) => {
+      this.resolve = res;
+    });
+  }
+};
+var TaskQueue = class {
+  static {
+    __name(this, "TaskQueue");
+  }
   /**
-   * Song view count
+   * The task array
    */
-  views;
+  #tasks = [];
   /**
-   * Song like count
+   * Waits for last task finished and queues a new task
    */
-  likes;
+  queuing(isPlay = false) {
+    const next = this.remaining ? this.#tasks[this.#tasks.length - 1].promise : Promise.resolve();
+    this.#tasks.push(new Task(isPlay));
+    return next;
+  }
   /**
-   * Song dislike count
+   * Removes the finished task and processes the next task
    */
-  dislikes;
+  resolve() {
+    this.#tasks.shift()?.resolve();
+  }
   /**
-   * Song repost (share) count
+   * The remaining number of tasks
    */
-  reposts;
+  get remaining() {
+    return this.#tasks.length;
+  }
   /**
-   * Song uploader
+   * Whether or not having a play task
    */
-  uploader;
+  get hasPlayTask() {
+    return this.#tasks.some((t) => t.isPlay);
+  }
+};
+
+// src/struct/Queue.ts
+var Queue = class extends DisTubeBase {
+  static {
+    __name(this, "Queue");
+  }
   /**
-   * Whether or not an age-restricted content
+   * Queue id (Guild id)
    */
-  ageRestricted;
+  id;
   /**
-   * Stream info
+   * Voice connection of this queue.
    */
-  stream;
+  voice;
   /**
-   * The plugin that created this song
+   * List of songs in the queue (The first one is the playing song)
    */
-  plugin;
-  #metadata;
-  #member;
-  #playlist;
+  songs;
   /**
-   * Create a Song
-   *
-   * @param info      - Raw song info
-   * @param options   - Optional data
+   * List of the previous songs.
    */
-  constructor(info, { member, metadata } = {}) {
-    this.source = info.source.toLowerCase();
-    this.metadata = metadata;
-    this.member = member;
-    this.id = info.id;
-    this.name = info.name;
-    this.isLive = info.isLive;
-    this.duration = this.isLive || !info.duration ? 0 : info.duration;
-    this.formattedDuration = this.isLive ? "Live" : formatDuration(this.duration);
-    this.url = info.url;
-    this.thumbnail = info.thumbnail;
-    this.views = info.views;
-    this.likes = info.likes;
-    this.dislikes = info.dislikes;
-    this.reposts = info.reposts;
-    this.uploader = {
-      name: info.uploader?.name,
-      url: info.uploader?.url
-    };
-    this.ageRestricted = info.ageRestricted;
-    this.stream = { playFromSource: info.playFromSource };
-    this.plugin = info.plugin;
-  }
+  previousSongs;
   /**
-   * The playlist this song belongs to
+   * Whether stream is currently stopped.
    */
-  get playlist() {
-    return this.#playlist;
-  }
-  set playlist(playlist) {
-    if (!(playlist instanceof Playlist)) throw new DisTubeError("INVALID_TYPE", "Playlist", playlist, "Song#playlist");
-    this.#playlist = playlist;
-    this.member = playlist.member;
-  }
+  stopped;
   /**
-   * User requested to play this song.
+   * Whether or not the stream is currently playing.
    */
-  get member() {
-    return this.#member;
-  }
-  set member(member) {
-    if (isMemberInstance(member)) this.#member = member;
-  }
+  playing;
   /**
-   * User requested to play this song.
+   * Whether or not the stream is currently paused.
    */
-  get user() {
-    return this.member?.user;
-  }
+  paused;
   /**
-   * Optional metadata that can be used to identify the song. This is attached by the
-   * {@link DisTube#play} method.
+   * Type of repeat mode (`0` is disabled, `1` is repeating a song, `2` is repeating
+   * all the queue). Default value: `0` (disabled)
    */
-  get metadata() {
-    return this.#metadata;
-  }
-  set metadata(metadata) {
-    this.#metadata = metadata;
-  }
-  toString() {
-    return this.name || this.url || this.id || "Unknown";
-  }
-};
-
-// src/core/DisTubeBase.ts
-var DisTubeBase = class {
-  static {
-    __name(this, "DisTubeBase");
-  }
-  distube;
-  constructor(distube) {
-    this.distube = distube;
-  }
+  repeatMode;
   /**
-   * Emit the {@link DisTube} of this base
-   * @param eventName - Event name
-   * @param args      - arguments
+   * Whether or not the autoplay mode is enabled. Default value: `false`
    */
-  emit(eventName, ...args) {
-    return this.distube.emit(eventName, ...args);
-  }
+  autoplay;
   /**
-   * Emit error event
-   * @param error   - error
-   * @param queue   - The queue encountered the error
-   * @param song    - The playing song when encountered the error
+   * FFmpeg arguments for the current queue. Default value is defined with {@link DisTubeOptions}.ffmpeg.args.
+   * `af` output argument will be replaced with {@link Queue#filters} manager
    */
-  emitError(error, queue, song) {
-    this.distube.emitError(error, queue, song);
-  }
+  ffmpegArgs;
   /**
-   * Emit debug event
-   * @param message - debug message
+   * The text channel of the Queue. (Default: where the first command is called).
    */
-  debug(message) {
-    this.distube.debug(message);
-  }
+  textChannel;
   /**
-   * The queue manager
+   * What time in the song to begin (in seconds).
    */
-  get queues() {
-    return this.distube.queues;
-  }
+  _beginTime;
+  #filters;
   /**
-   * The voice manager
+   * Whether or not the queue is being updated manually (skip, jump, previous)
    */
-  get voices() {
-    return this.distube.voices;
-  }
+  _manualUpdate;
   /**
-   * Discord.js client
+   * Task queuing system
    */
-  get client() {
-    return this.distube.client;
-  }
+  _taskQueue;
   /**
-   * DisTube options
+   * {@link DisTubeVoice} listener
    */
-  get options() {
-    return this.distube.options;
-  }
+  _listeners;
   /**
-   * DisTube handler
-   */
-  get handler() {
-    return this.distube.handler;
-  }
-  /**
-   * DisTube plugins
-   */
-  get plugins() {
-    return this.distube.plugins;
-  }
-};
-
-// src/core/DisTubeVoice.ts
-import { Constants } from "discord.js";
-import { TypedEmitter } from "tiny-typed-emitter";
-import {
-  AudioPlayerStatus,
-  VoiceConnectionDisconnectReason,
-  VoiceConnectionStatus,
-  createAudioPlayer,
-  entersState,
-  joinVoiceChannel
-} from "@discordjs/voice";
-var DisTubeVoice = class extends TypedEmitter {
-  static {
-    __name(this, "DisTubeVoice");
-  }
-  id;
-  voices;
-  audioPlayer;
-  connection;
-  emittedError;
-  isDisconnected = false;
-  stream;
-  pausingStream;
-  #channel;
-  #volume = 100;
-  constructor(voiceManager, channel) {
-    super();
-    this.voices = voiceManager;
-    this.id = channel.guildId;
-    this.channel = channel;
-    this.voices.add(this.id, this);
-    this.audioPlayer = createAudioPlayer().on(AudioPlayerStatus.Idle, (oldState) => {
-      if (oldState.status !== AudioPlayerStatus.Idle) this.emit("finish");
-    }).on("error", (error) => {
-      if (this.emittedError) return;
-      this.emittedError = true;
-      this.emit("error", error);
-    });
-    this.connection.on(VoiceConnectionStatus.Disconnected, (_, newState) => {
-      if (newState.reason === VoiceConnectionDisconnectReason.Manual) {
-        this.leave();
-      } else if (newState.reason === VoiceConnectionDisconnectReason.WebSocketClose && newState.closeCode === 4014) {
-        entersState(this.connection, VoiceConnectionStatus.Connecting, 5e3).catch(() => {
-          if (![VoiceConnectionStatus.Ready, VoiceConnectionStatus.Connecting].includes(this.connection.state.status)) {
-            this.leave();
-          }
-        });
-      } else if (this.connection.rejoinAttempts < 5) {
-        setTimeout(
-          () => {
-            this.connection.rejoin();
-          },
-          (this.connection.rejoinAttempts + 1) * 5e3
-        ).unref();
-      } else if (this.connection.state.status !== VoiceConnectionStatus.Destroyed) {
-        this.leave(new DisTubeError("VOICE_RECONNECT_FAILED"));
-      }
-    }).on(VoiceConnectionStatus.Destroyed, () => {
-      this.leave();
-    }).on("error", () => void 0);
-    this.connection.subscribe(this.audioPlayer);
-  }
-  /**
-   * The voice channel id the bot is in
+   * Create a queue for the guild
+   * @param distube     - DisTube
+   * @param voice       - Voice connection
+   * @param textChannel - Default text channel
    */
-  get channelId() {
-    return this.connection?.joinConfig?.channelId ?? void 0;
+  constructor(distube, voice, textChannel) {
+    super(distube);
+    this.voice = voice;
+    this.id = voice.id;
+    this.volume = 50;
+    this.songs = [];
+    this.previousSongs = [];
+    this.stopped = false;
+    this._manualUpdate = false;
+    this.playing = false;
+    this.paused = false;
+    this.repeatMode = 0 /* DISABLED */;
+    this.autoplay = false;
+    this.#filters = new FilterManager(this);
+    this._beginTime = 0;
+    this.textChannel = textChannel;
+    this._taskQueue = new TaskQueue();
+    this._listeners = void 0;
+    this.ffmpegArgs = {
+      global: { ...this.options.ffmpeg.args.global },
+      input: { ...this.options.ffmpeg.args.input },
+      output: { ...this.options.ffmpeg.args.output }
+    };
   }
-  get channel() {
-    if (!this.channelId) return this.#channel;
-    if (this.#channel?.id === this.channelId) return this.#channel;
-    const channel = this.voices.client.channels.cache.get(this.channelId);
-    if (!channel) return this.#channel;
-    for (const type of Constants.VoiceBasedChannelTypes) {
-      if (channel.type === type) {
-        this.#channel = channel;
-        return channel;
+  #addToPreviousSongs(songs) {
+    if (Array.isArray(songs)) {
+      if (this.options.savePreviousSongs) {
+        this.previousSongs.push(...songs);
+      } else {
+        this.previousSongs.push(...songs.map((s) => ({ id: s.id })));
       }
+    } else if (this.options.savePreviousSongs) {
+      this.previousSongs.push(songs);
+    } else {
+      this.previousSongs.push({ id: songs.id });
     }
-    return this.#channel;
-  }
-  set channel(channel) {
-    if (!isSupportedVoiceChannel(channel)) {
-      throw new DisTubeError("INVALID_TYPE", "BaseGuildVoiceChannel", channel, "DisTubeVoice#channel");
-    }
-    if (channel.guildId !== this.id) throw new DisTubeError("VOICE_DIFFERENT_GUILD");
-    if (channel.client.user?.id !== this.voices.client.user?.id) throw new DisTubeError("VOICE_DIFFERENT_CLIENT");
-    if (channel.id === this.channelId) return;
-    if (!channel.joinable) {
-      if (channel.full) throw new DisTubeError("VOICE_FULL");
-      else throw new DisTubeError("VOICE_MISSING_PERMS");
-    }
-    this.connection = this.#join(channel);
-    this.#channel = channel;
   }
-  #join(channel) {
-    return joinVoiceChannel({
-      channelId: channel.id,
-      guildId: this.id,
-      adapterCreator: channel.guild.voiceAdapterCreator,
-      group: channel.client.user?.id
-    });
+  #stop() {
+    this._manualUpdate = true;
+    this.voice.stop();
   }
   /**
-   * Join a voice channel with this connection
-   * @param channel - A voice channel
+   * The client user as a `GuildMember` of this queue's guild
    */
-  async join(channel) {
-    const TIMEOUT = 3e4;
-    if (channel) this.channel = channel;
-    try {
-      await entersState(this.connection, VoiceConnectionStatus.Ready, TIMEOUT);
-    } catch {
-      if (this.connection.state.status === VoiceConnectionStatus.Ready) return this;
-      if (this.connection.state.status !== VoiceConnectionStatus.Destroyed) this.connection.destroy();
-      this.voices.remove(this.id);
-      throw new DisTubeError("VOICE_CONNECT_FAILED", TIMEOUT / 1e3);
-    }
-    return this;
+  get clientMember() {
+    return this.voice.channel.guild.members.me ?? void 0;
   }
   /**
-   * Leave the voice channel of this connection
-   * @param error - Optional, an error to emit with 'error' event.
+   * The filter manager of the queue
    */
-  leave(error) {
-    this.stop(true);
-    if (!this.isDisconnected) {
-      this.emit("disconnect", error);
-      this.isDisconnected = true;
-    }
-    if (this.connection.state.status !== VoiceConnectionStatus.Destroyed) this.connection.destroy();
-    this.voices.remove(this.id);
+  get filters() {
+    return this.#filters;
   }
   /**
-   * Stop the playing stream
-   * @param force - If true, will force the {@link DisTubeVoice#audioPlayer} to enter the Idle state even
-   *                if the {@link DisTubeStream#audioResource} has silence padding frames.
+   * Formatted duration string.
    */
-  stop(force = false) {
-    this.audioPlayer.stop(force);
+  get formattedDuration() {
+    return formatDuration(this.duration);
   }
   /**
-   * Play a {@link DisTubeStream}
-   * @param dtStream - DisTubeStream
+   * Queue's duration.
    */
-  async play(dtStream) {
-    if (!await checkEncryptionLibraries()) {
-      dtStream.kill();
-      throw new DisTubeError("ENCRYPTION_LIBRARIES_MISSING");
-    }
-    this.emittedError = false;
-    dtStream.on("error", (error) => {
-      if (this.emittedError || error.code === "ERR_STREAM_PREMATURE_CLOSE") return;
-      this.emittedError = true;
-      this.emit("error", error);
-    });
-    if (this.audioPlayer.state.status !== AudioPlayerStatus.Paused) {
-      this.audioPlayer.play(dtStream.audioResource);
-      this.stream?.kill();
-      dtStream.spawn();
-    } else if (!this.pausingStream) {
-      this.pausingStream = this.stream;
-    }
-    this.stream = dtStream;
-    this.volume = this.#volume;
-  }
-  set volume(volume) {
-    if (typeof volume !== "number" || isNaN(volume)) {
-      throw new DisTubeError("INVALID_TYPE", "number", volume, "volume");
-    }
-    if (volume < 0) {
-      throw new DisTubeError("NUMBER_COMPARE", "Volume", "bigger or equal to", 0);
-    }
-    this.#volume = volume;
-    this.stream?.setVolume(Math.pow(this.#volume / 100, 0.5 / Math.log10(2)));
+  get duration() {
+    return this.songs.length ? this.songs.reduce((prev, next) => prev + next.duration, 0) : 0;
   }
   /**
-   * Get or set the volume percentage
+   * What time in the song is playing (in seconds).
    */
-  get volume() {
-    return this.#volume;
+  get currentTime() {
+    return this.voice.playbackDuration + this._beginTime;
   }
   /**
-   * Playback duration of the audio resource in seconds
+   * Formatted {@link Queue#currentTime} string.
    */
-  get playbackDuration() {
-    return (this.stream?.audioResource?.playbackDuration ?? 0) / 1e3;
-  }
-  pause() {
-    this.audioPlayer.pause();
-  }
-  unpause() {
-    const state = this.audioPlayer.state;
-    if (state.status !== AudioPlayerStatus.Paused) return;
-    if (this.stream?.audioResource && state.resource !== this.stream.audioResource) {
-      this.audioPlayer.play(this.stream.audioResource);
-      this.stream.spawn();
-      this.pausingStream?.kill();
-      delete this.pausingStream;
-    } else {
-      this.audioPlayer.unpause();
-    }
+  get formattedCurrentTime() {
+    return formatDuration(this.currentTime);
   }
   /**
-   * Whether the bot is self-deafened
+   * The voice channel playing in.
    */
-  get selfDeaf() {
-    return this.connection.joinConfig.selfDeaf;
+  get voiceChannel() {
+    return this.clientMember?.voice?.channel ?? null;
   }
   /**
-   * Whether the bot is self-muted
+   * Get or set the stream volume. Default value: `50`.
    */
-  get selfMute() {
-    return this.connection.joinConfig.selfMute;
+  get volume() {
+    return this.voice.volume;
+  }
+  set volume(value) {
+    this.voice.volume = value;
   }
   /**
-   * Self-deafens/undeafens the bot.
-   * @param selfDeaf - Whether or not the bot should be self-deafened
-   * @returns true if the voice state was successfully updated, otherwise false
+   * @throws {DisTubeError}
+   * @param song     - Song to add
+   * @param position - Position to add, \<= 0 to add to the end of the queue
+   * @returns The guild queue
    */
-  setSelfDeaf(selfDeaf) {
-    if (typeof selfDeaf !== "boolean") {
-      throw new DisTubeError("INVALID_TYPE", "boolean", selfDeaf, "selfDeaf");
-    }
-    return this.connection.rejoin({
-      ...this.connection.joinConfig,
-      selfDeaf
-    });
+  addToQueue(song, position = 0) {
+    if (this.stopped) throw new DisTubeError("QUEUE_STOPPED");
+    if (!song || Array.isArray(song) && !song.length) {
+      throw new DisTubeError("INVALID_TYPE", ["Song", "Array<Song>"], song, "song");
+    }
+    if (typeof position !== "number" || !Number.isInteger(position)) {
+      throw new DisTubeError("INVALID_TYPE", "integer", position, "position");
+    }
+    if (position <= 0) {
+      if (Array.isArray(song)) this.songs.push(...song);
+      else this.songs.push(song);
+    } else if (Array.isArray(song)) {
+      this.songs.splice(position, 0, ...song);
+    } else {
+      this.songs.splice(position, 0, song);
+    }
+    return this;
   }
   /**
-   * Self-mutes/unmutes the bot.
-   * @param selfMute - Whether or not the bot should be self-muted
-   * @returns true if the voice state was successfully updated, otherwise false
+   * @returns `true` if the queue is playing
    */
-  setSelfMute(selfMute) {
-    if (typeof selfMute !== "boolean") {
-      throw new DisTubeError("INVALID_TYPE", "boolean", selfMute, "selfMute");
-    }
-    return this.connection.rejoin({
-      ...this.connection.joinConfig,
-      selfMute
-    });
+  isPlaying() {
+    return this.playing;
   }
   /**
-   * The voice state of this connection
+   * @returns `true` if the queue is paused
    */
-  get voiceState() {
-    return this.channel?.guild?.members?.me?.voice;
-  }
-};
-
-// src/core/DisTubeStream.ts
-import { Transform } from "stream";
-import { spawn, spawnSync } from "child_process";
-import { TypedEmitter as TypedEmitter2 } from "tiny-typed-emitter";
-import { StreamType, createAudioResource } from "@discordjs/voice";
-var checked = process.env.NODE_ENV === "test";
-var checkFFmpeg = /* @__PURE__ */ __name((distube) => {
-  if (checked) return;
-  const path = distube.options.ffmpeg.path;
-  const debug = /* @__PURE__ */ __name((str) => distube.emit("ffmpegDebug" /* FFMPEG_DEBUG */, str), "debug");
-  try {
-    debug(`[test] spawn ffmpeg at '${path}' path`);
-    const process2 = spawnSync(path, ["-h"], { windowsHide: true, shell: true, encoding: "utf-8" });
-    if (process2.error) throw process2.error;
-    if (process2.stderr && !process2.stdout) throw new Error(process2.stderr);
-    const result = process2.output.join("\n");
-    const version2 = /ffmpeg version (\S+)/iu.exec(result)?.[1];
-    if (!version2) throw new Error("Invalid FFmpeg version");
-    debug(`[test] ffmpeg version: ${version2}`);
-  } catch (e) {
-    debug(`[test] failed to spawn ffmpeg at '${path}': ${e?.stack ?? e}`);
-    throw new DisTubeError("FFMPEG_NOT_INSTALLED", path);
-  }
-  checked = true;
-}, "checkFFmpeg");
-var DisTubeStream = class extends TypedEmitter2 {
-  static {
-    __name(this, "DisTubeStream");
+  isPaused() {
+    return this.paused;
   }
-  #ffmpegPath;
-  #opts;
-  process;
-  stream;
-  audioResource;
   /**
-   * Create a DisTubeStream to play with {@link DisTubeVoice}
-   * @param url     - Stream URL
-   * @param options - Stream options
+   * Pause the guild stream
+   * @returns The guild queue
    */
-  constructor(url, options) {
-    super();
-    const { ffmpeg, seek } = options;
-    const opts = {
-      reconnect: 1,
-      reconnect_streamed: 1,
-      reconnect_delay_max: 5,
-      analyzeduration: 0,
-      hide_banner: true,
-      ...ffmpeg.args.global,
-      ...ffmpeg.args.input,
-      i: url,
-      ar: 48e3,
-      ac: 2,
-      ...ffmpeg.args.output,
-      f: "s16le"
-    };
-    if (typeof seek === "number" && seek > 0) opts.ss = seek.toString();
-    const fileUrl = new URL(url);
-    if (fileUrl.protocol === "file:") {
-      opts.reconnect = null;
-      opts.reconnect_streamed = null;
-      opts.reconnect_delay_max = null;
-      opts.i = fileUrl.hostname + fileUrl.pathname;
+  async pause() {
+    await this._taskQueue.queuing();
+    try {
+      if (this.paused) throw new DisTubeError("PAUSED");
+      this.paused = true;
+      this.voice.pause();
+      return this;
+    } finally {
+      this._taskQueue.resolve();
     }
-    this.#ffmpegPath = ffmpeg.path;
-    this.#opts = [
-      ...Object.entries(opts).flatMap(
-        ([key, value]) => Array.isArray(value) ? value.filter(Boolean).map((v) => [`-${key}`, String(v)]) : value == null || value === false ? [] : [value === true ? `-${key}` : [`-${key}`, String(value)]]
-      ).flat(),
-      "pipe:1"
-    ];
-    this.stream = new VolumeTransformer();
-    this.stream.on("close", () => this.kill()).on("error", (err) => {
-      this.debug(`[stream] error: ${err.message}`);
-      this.emit("error", err);
-    }).on("finish", () => this.debug("[stream] log: stream finished"));
-    this.audioResource = createAudioResource(this.stream, { inputType: StreamType.Raw, inlineVolume: false });
   }
-  spawn() {
-    this.debug(`[process] spawn: ${this.#ffmpegPath} ${this.#opts.join(" ")}`);
-    this.process = spawn(this.#ffmpegPath, this.#opts, {
-      stdio: ["ignore", "pipe", "pipe"],
-      shell: false,
-      windowsHide: true
-    }).on("error", (err) => {
-      this.debug(`[process] error: ${err.message}`);
-      this.emit("error", err);
-    }).on("exit", (code, signal) => {
-      this.debug(`[process] exit: code=${code ?? "unknown"} signal=${signal ?? "unknown"}`);
-      if (!code || [0, 255].includes(code)) return;
-      this.debug(`[process] error: ffmpeg exited with code ${code}`);
-      this.emit("error", new DisTubeError("FFMPEG_EXITED", code));
-    });
-    if (!this.process.stdout || !this.process.stderr) {
-      this.kill();
-      throw new Error("Failed to create ffmpeg process");
+  /**
+   * Resume the guild stream
+   * @returns The guild queue
+   */
+  async resume() {
+    await this._taskQueue.queuing();
+    try {
+      if (!this.paused) throw new DisTubeError("RESUMED");
+      this.paused = false;
+      this.voice.unpause();
+      return this;
+    } finally {
+      this._taskQueue.resolve();
     }
-    this.process.stdout.pipe(this.stream);
-    this.process.stderr.setEncoding("utf8")?.on("data", (data) => {
-      const lines = data.split(/\r\n|\r|\n/u);
-      for (const line of lines) {
-        if (/^\s*$/.test(line)) continue;
-        this.debug(`[ffmpeg] log: ${line}`);
-      }
-    });
-  }
-  debug(debug) {
-    this.emit("debug", debug);
-  }
-  setVolume(volume) {
-    this.stream.vol = volume;
-  }
-  kill() {
-    if (!this.stream.destroyed) this.stream.destroy();
-    if (this.process && !this.process.killed) this.process.kill("SIGKILL");
-  }
-};
-var VolumeTransformer = class extends Transform {
-  static {
-    __name(this, "VolumeTransformer");
   }
-  buffer = Buffer.allocUnsafe(0);
-  extrema = [-Math.pow(2, 16 - 1), Math.pow(2, 16 - 1) - 1];
-  vol = 1;
-  _transform(newChunk, _encoding, done) {
-    const { vol } = this;
-    if (vol === 1) {
-      this.push(newChunk);
-      done();
-      return;
-    }
-    const bytes = 2;
-    const chunk = Buffer.concat([this.buffer, newChunk]);
-    const readableLength = Math.floor(chunk.length / bytes) * bytes;
-    for (let i = 0; i < readableLength; i += bytes) {
-      const value = chunk.readInt16LE(i);
-      const clampedValue = Math.min(this.extrema[1], Math.max(this.extrema[0], value * vol));
-      chunk.writeInt16LE(clampedValue, i);
-    }
-    this.buffer = chunk.subarray(readableLength);
-    this.push(chunk.subarray(0, readableLength));
-    done();
+  /**
+   * Set the guild stream's volume
+   * @param percent - The percentage of volume you want to set
+   * @returns The guild queue
+   */
+  setVolume(percent) {
+    this.volume = percent;
+    return this;
   }
-};
-
-// src/core/DisTubeHandler.ts
-import { request } from "undici";
-var REDIRECT_CODES = /* @__PURE__ */ new Set([301, 302, 303, 307, 308]);
-var DisTubeHandler = class extends DisTubeBase {
-  static {
-    __name(this, "DisTubeHandler");
+  /**
+   * Skip the playing song if there is a next song in the queue. <info>If {@link
+   * Queue#autoplay} is `true` and there is no up next song, DisTube will add and
+   * play a related song.</info>
+   * @param options - Skip options
+   * @returns The song will skip to
+   */
+  async skip(options) {
+    return this.jump(1, options);
   }
   /**
-   * Resolve a url or a supported object to a {@link Song} or {@link Playlist}
-   * @throws {@link DisTubeError}
-   * @param input   - Resolvable input
-   * @param options - Optional options
-   * @returns Resolved
+   * Play the previous song if exists
+   * @returns The guild queue
    */
-  async resolve(input, options = {}) {
-    if (input instanceof Song || input instanceof Playlist) {
-      if ("metadata" in options) input.metadata = options.metadata;
-      if ("member" in options) input.member = options.member;
-      return input;
-    }
-    if (typeof input === "string") {
-      if (isURL(input)) {
-        const plugin = await this._getPluginFromURL(input) || await this._getPluginFromURL(input = await this.followRedirectLink(input));
-        if (!plugin) throw new DisTubeError("NOT_SUPPORTED_URL");
-        this.debug(`[${plugin.constructor.name}] Resolving from url: ${input}`);
-        return plugin.resolve(input, options);
-      }
-      try {
-        const song = await this.#searchSong(input, options);
-        if (song) return song;
-      } catch {
-        throw new DisTubeError("NO_RESULT", input);
+  async previous() {
+    await this._taskQueue.queuing();
+    try {
+      if (!this.options.savePreviousSongs) throw new DisTubeError("DISABLED_OPTION", "savePreviousSongs");
+      if (this.previousSongs.length === 0 && this.repeatMode !== 2 /* QUEUE */) {
+        throw new DisTubeError("NO_PREVIOUS");
       }
+      const song = this.repeatMode === 2 /* QUEUE */ && this.previousSongs.length === 0 ? this.songs[this.songs.length - 1] : this.previousSongs.pop();
+      this.songs.unshift(song);
+      this.#stop();
+      return song;
+    } finally {
+      this._taskQueue.resolve();
     }
-    throw new DisTubeError("CANNOT_RESOLVE_SONG", input);
   }
-  async _getPluginFromURL(url) {
-    for (const plugin of this.plugins) if (await plugin.validate(url)) return plugin;
-    return null;
-  }
-  async _getPluginFromSong(song, types, validate = true) {
-    if (!types || types.includes(song.plugin?.type)) return song.plugin;
-    if (!song.url) return null;
-    for (const plugin of this.plugins) {
-      if ((!types || types.includes(plugin?.type)) && (!validate || await plugin.validate(song.url))) {
-        return plugin;
-      }
-    }
-    return null;
-  }
-  async #searchSong(query, options = {}, getStreamURL = false) {
-    const plugins = this.plugins.filter((p) => p.type === "extractor" /* EXTRACTOR */);
-    if (!plugins.length) throw new DisTubeError("NO_EXTRACTOR_PLUGIN");
-    for (const plugin of plugins) {
-      this.debug(`[${plugin.constructor.name}] Searching for song: ${query}`);
-      const result = await plugin.searchSong(query, options);
-      if (result) {
-        if (getStreamURL && result.stream.playFromSource) result.stream.url = await plugin.getStreamURL(result);
-        return result;
+  /**
+   * Shuffle the queue's songs
+   * @returns The guild queue
+   */
+  async shuffle() {
+    await this._taskQueue.queuing();
+    try {
+      const playing = this.songs.shift();
+      if (playing === void 0) return this;
+      for (let i = this.songs.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [this.songs[i], this.songs[j]] = [this.songs[j], this.songs[i]];
       }
+      this.songs.unshift(playing);
+      return this;
+    } finally {
+      this._taskQueue.resolve();
     }
-    return null;
   }
   /**
-   * Get {@link Song}'s stream info and attach it to the song.
-   * @param song - A Song
+   * Jump to the song position in the queue. The next one is 1, 2,... The previous
+   * one is -1, -2,...
+   * if `num` is invalid number
+   * @param position - The song position to play
+   * @param options  - Skip options
+   * @returns The new Song will be played
    */
-  async attachStreamInfo(song) {
-    if (song.stream.playFromSource) {
-      if (song.stream.url) return;
-      this.debug(`[DisTubeHandler] Getting stream info: ${song}`);
-      const plugin = await this._getPluginFromSong(song, ["extractor" /* EXTRACTOR */, "playable-extractor" /* PLAYABLE_EXTRACTOR */]);
-      if (!plugin) throw new DisTubeError("NOT_SUPPORTED_SONG", song.toString());
-      this.debug(`[${plugin.constructor.name}] Getting stream URL: ${song}`);
-      song.stream.url = await plugin.getStreamURL(song);
-      if (!song.stream.url) throw new DisTubeError("CANNOT_GET_STREAM_URL", song.toString());
-    } else {
-      if (song.stream.song?.stream?.playFromSource && song.stream.song.stream.url) return;
-      this.debug(`[DisTubeHandler] Getting stream info: ${song}`);
-      const plugin = await this._getPluginFromSong(song, ["info-extractor" /* INFO_EXTRACTOR */]);
-      if (!plugin) throw new DisTubeError("NOT_SUPPORTED_SONG", song.toString());
-      this.debug(`[${plugin.constructor.name}] Creating search query for: ${song}`);
-      const query = await plugin.createSearchQuery(song);
-      if (!query) throw new DisTubeError("CANNOT_GET_SEARCH_QUERY", song.toString());
-      const altSong = await this.#searchSong(query, { metadata: song.metadata, member: song.member }, true);
-      if (!altSong || !altSong.stream.playFromSource) throw new DisTubeError("NO_RESULT", query || song.toString());
-      song.stream.song = altSong;
-    }
-  }
-  async followRedirectLink(url, maxRedirect = 5) {
-    if (maxRedirect === 0) return url;
-    const res = await request(url, {
-      method: "HEAD",
-      headers: {
-        "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.3"
+  async jump(position, options) {
+    await this._taskQueue.queuing();
+    try {
+      if (typeof position !== "number") throw new DisTubeError("INVALID_TYPE", "number", position, "position");
+      if (!position || position > this.songs.length || -position > this.previousSongs.length) {
+        throw new DisTubeError("NO_SONG_POSITION");
       }
-    });
-    if (REDIRECT_CODES.has(res.statusCode ?? 200)) {
-      let location = res.headers.location;
-      if (typeof location !== "string") location = location?.[0] ?? url;
-      return this.followRedirectLink(location, --maxRedirect);
-    }
-    return url;
-  }
-};
-
-// src/core/DisTubeOptions.ts
-var Options = class {
-  static {
-    __name(this, "Options");
-  }
-  plugins;
-  emitNewSongOnly;
-  savePreviousSongs;
-  customFilters;
-  nsfw;
-  emitAddSongWhenCreatingQueue;
-  emitAddListWhenCreatingQueue;
-  joinNewVoiceChannel;
-  ffmpeg;
-  constructor(options) {
-    if (typeof options !== "object" || Array.isArray(options)) {
-      throw new DisTubeError("INVALID_TYPE", "object", options, "DisTubeOptions");
-    }
-    const opts = { ...defaultOptions, ...options };
-    this.plugins = opts.plugins;
-    this.emitNewSongOnly = opts.emitNewSongOnly;
-    this.savePreviousSongs = opts.savePreviousSongs;
-    this.customFilters = opts.customFilters;
-    this.nsfw = opts.nsfw;
-    this.emitAddSongWhenCreatingQueue = opts.emitAddSongWhenCreatingQueue;
-    this.emitAddListWhenCreatingQueue = opts.emitAddListWhenCreatingQueue;
-    this.joinNewVoiceChannel = opts.joinNewVoiceChannel;
-    this.ffmpeg = this.#ffmpegOption(options);
-    checkInvalidKey(opts, this, "DisTubeOptions");
-    this.#validateOptions();
-  }
-  #validateOptions(options = this) {
-    const booleanOptions = /* @__PURE__ */ new Set([
-      "emitNewSongOnly",
-      "savePreviousSongs",
-      "joinNewVoiceChannel",
-      "nsfw",
-      "emitAddSongWhenCreatingQueue",
-      "emitAddListWhenCreatingQueue"
-    ]);
-    const numberOptions = /* @__PURE__ */ new Set();
-    const stringOptions = /* @__PURE__ */ new Set();
-    const objectOptions = /* @__PURE__ */ new Set(["customFilters", "ffmpeg"]);
-    const optionalOptions = /* @__PURE__ */ new Set(["customFilters"]);
-    for (const [key, value] of Object.entries(options)) {
-      if (value === void 0 && optionalOptions.has(key)) continue;
-      if (key === "plugins" && !Array.isArray(value)) {
-        throw new DisTubeError("INVALID_TYPE", "Array<Plugin>", value, `DisTubeOptions.${key}`);
-      } else if (booleanOptions.has(key)) {
-        if (typeof value !== "boolean") {
-          throw new DisTubeError("INVALID_TYPE", "boolean", value, `DisTubeOptions.${key}`);
-        }
-      } else if (numberOptions.has(key)) {
-        if (typeof value !== "number" || isNaN(value)) {
-          throw new DisTubeError("INVALID_TYPE", "number", value, `DisTubeOptions.${key}`);
-        }
-      } else if (stringOptions.has(key)) {
-        if (typeof value !== "string") {
-          throw new DisTubeError("INVALID_TYPE", "string", value, `DisTubeOptions.${key}`);
-        }
-      } else if (objectOptions.has(key)) {
-        if (typeof value !== "object" || Array.isArray(value)) {
-          throw new DisTubeError("INVALID_TYPE", "object", value, `DisTubeOptions.${key}`);
+      if (position > 0) {
+        if (position >= this.songs.length) {
+          if (this.autoplay) {
+            await this.addRelatedSong();
+          } else {
+            throw new DisTubeError("NO_UP_NEXT");
+          }
         }
-      }
-    }
-  }
-  #ffmpegOption(opts) {
-    const args = { global: {}, input: {}, output: {} };
-    if (opts.ffmpeg?.args) {
-      if (opts.ffmpeg.args.global) args.global = opts.ffmpeg.args.global;
-      if (opts.ffmpeg.args.input) args.input = opts.ffmpeg.args.input;
-      if (opts.ffmpeg.args.output) args.output = opts.ffmpeg.args.output;
-    }
-    const path = opts.ffmpeg?.path ?? "ffmpeg";
-    if (typeof path !== "string") {
-      throw new DisTubeError("INVALID_TYPE", "string", path, "DisTubeOptions.ffmpeg.path");
-    }
-    for (const [key, value] of Object.entries(args)) {
-      if (typeof value !== "object" || Array.isArray(value)) {
-        throw new DisTubeError("INVALID_TYPE", "object", value, `DisTubeOptions.ffmpeg.${key}`);
-      }
-      for (const [k, v] of Object.entries(value)) {
-        if (typeof v !== "string" && typeof v !== "number" && typeof v !== "boolean" && !Array.isArray(v) && v !== null && v !== void 0) {
-          throw new DisTubeError(
-            "INVALID_TYPE",
-            ["string", "number", "boolean", "Array<string | null | undefined>", "null", "undefined"],
-            v,
-            `DisTubeOptions.ffmpeg.${key}.${k}`
-          );
+        const skipped = this.songs.splice(0, position);
+        if (options?.requeue) {
+          this.songs.push(...skipped);
+        } else {
+          this.#addToPreviousSongs(skipped);
         }
+      } else if (!this.options.savePreviousSongs) {
+        throw new DisTubeError("DISABLED_OPTION", "savePreviousSongs");
+      } else {
+        const skipped = this.previousSongs.splice(position);
+        this.songs.unshift(...skipped);
       }
+      this.#stop();
+      return this.songs[0];
+    } finally {
+      this._taskQueue.resolve();
     }
-    return { path, args };
-  }
-};
-
-// src/core/manager/BaseManager.ts
-import { Collection } from "discord.js";
-var BaseManager = class extends DisTubeBase {
-  static {
-    __name(this, "BaseManager");
   }
   /**
-   * The collection of items for this manager.
+   * Set the repeat mode of the guild queue.
+   * Toggle mode `(Disabled -> Song -> Queue -> Disabled ->...)` if `mode` is `undefined`
+   * @param mode - The repeat modes (toggle if `undefined`)
+   * @returns The new repeat mode
    */
-  collection = new Collection();
+  setRepeatMode(mode) {
+    if (mode !== void 0 && !Object.values(RepeatMode).includes(mode)) {
+      throw new DisTubeError("INVALID_TYPE", ["RepeatMode", "undefined"], mode, "mode");
+    }
+    if (mode === void 0) this.repeatMode = (this.repeatMode + 1) % 3;
+    else if (this.repeatMode === mode) this.repeatMode = 0 /* DISABLED */;
+    else this.repeatMode = mode;
+    return this.repeatMode;
+  }
   /**
-   * The size of the collection.
+   * Set the playing time to another position
+   * @param time - Time in seconds
+   * @returns The guild queue
    */
-  get size() {
-    return this.collection.size;
-  }
-};
-
-// src/core/manager/GuildIdManager.ts
-var GuildIdManager = class extends BaseManager {
-  static {
-    __name(this, "GuildIdManager");
-  }
-  add(idOrInstance, data) {
-    const id = resolveGuildId(idOrInstance);
-    const existing = this.get(id);
-    if (existing) return this;
-    this.collection.set(id, data);
+  seek(time) {
+    if (typeof time !== "number") throw new DisTubeError("INVALID_TYPE", "number", time, "time");
+    if (Number.isNaN(time) || time < 0) throw new DisTubeError("NUMBER_COMPARE", "time", "bigger or equal to", 0);
+    this._beginTime = time;
+    this.play(false);
     return this;
   }
-  get(idOrInstance) {
-    return this.collection.get(resolveGuildId(idOrInstance));
-  }
-  remove(idOrInstance) {
-    return this.collection.delete(resolveGuildId(idOrInstance));
-  }
-  has(idOrInstance) {
-    return this.collection.has(resolveGuildId(idOrInstance));
-  }
-};
-
-// src/core/manager/DisTubeVoiceManager.ts
-import { VoiceConnectionStatus as VoiceConnectionStatus2, getVoiceConnection } from "@discordjs/voice";
-var DisTubeVoiceManager = class extends GuildIdManager {
-  static {
-    __name(this, "DisTubeVoiceManager");
+  async #getRelatedSong(current) {
+    const plugin = await this.handler._getPluginFromSong(current);
+    if (plugin) return plugin.getRelatedSongs(current);
+    return [];
   }
   /**
-   * Create a {@link DisTubeVoice} instance
-   * @param channel - A voice channel to join
+   * Add a related song of the playing song to the queue
+   * @returns The added song
    */
-  create(channel) {
-    const existing = this.get(channel.guildId);
-    if (existing) {
-      existing.channel = channel;
-      return existing;
+  async addRelatedSong() {
+    const current = this.songs?.[0];
+    if (!current) throw new DisTubeError("NO_PLAYING_SONG");
+    const prevIds = this.previousSongs.map((p) => p.id);
+    const relatedSongs = (await this.#getRelatedSong(current)).filter((s) => !prevIds.includes(s.id));
+    this.debug(`[${this.id}] Getting related songs from: ${current}`);
+    if (!relatedSongs.length && !current.stream.playFromSource) {
+      const altSong = current.stream.song;
+      if (altSong) relatedSongs.push(...(await this.#getRelatedSong(altSong)).filter((s) => !prevIds.includes(s.id)));
+      this.debug(`[${this.id}] Getting related songs from streamed song: ${altSong}`);
     }
-    if (getVoiceConnection(resolveGuildId(channel), this.client.user?.id) || getVoiceConnection(resolveGuildId(channel))) {
-      throw new DisTubeError("VOICE_ALREADY_CREATED");
+    const song = relatedSongs[0];
+    if (!song) throw new DisTubeError("NO_RELATED");
+    song.metadata = current.metadata;
+    song.member = this.clientMember;
+    this.addToQueue(song);
+    return song;
+  }
+  /**
+   * Stop the guild stream and delete the queue
+   */
+  async stop() {
+    await this._taskQueue.queuing();
+    try {
+      this.voice.stop();
+      this.remove();
+    } finally {
+      this._taskQueue.resolve();
     }
-    return new DisTubeVoice(this, channel);
   }
   /**
-   * Join a voice channel and wait until the connection is ready
-   * @param channel - A voice channel to join
+   * Remove the queue from the manager
    */
-  join(channel) {
-    const existing = this.get(channel.guildId);
-    if (existing) return existing.join(channel);
-    return this.create(channel).join();
+  remove() {
+    this.playing = false;
+    this.paused = false;
+    this.stopped = true;
+    this.songs = [];
+    this.previousSongs = [];
+    if (this._listeners) for (const event of objectKeys(this._listeners)) this.voice.off(event, this._listeners[event]);
+    this.queues.remove(this.id);
+    this.emit("deleteQueue" /* DELETE_QUEUE */, this);
   }
   /**
-   * Leave the connected voice channel in a guild
-   * @param guild - Queue Resolvable
+   * Toggle autoplay mode
+   * @returns Autoplay mode state
    */
-  leave(guild) {
-    const voice = this.get(guild);
-    if (voice) {
-      voice.leave();
-    } else {
-      const connection = getVoiceConnection(resolveGuildId(guild), this.client.user?.id) ?? getVoiceConnection(resolveGuildId(guild));
-      if (connection && connection.state.status !== VoiceConnectionStatus2.Destroyed) {
-        connection.destroy();
-      }
-    }
+  toggleAutoplay() {
+    this.autoplay = !this.autoplay;
+    return this.autoplay;
+  }
+  /**
+   * Play the first song in the queue
+   * @param emitPlaySong - Whether or not emit {@link Events.PLAY_SONG} event
+   */
+  play(emitPlaySong = true) {
+    if (this.stopped) throw new DisTubeError("QUEUE_STOPPED");
+    this.playing = true;
+    return this.queues.playSong(this, emitPlaySong);
   }
 };
 
-// src/core/manager/FilterManager.ts
-var FilterManager = class extends BaseManager {
-  static {
-    __name(this, "FilterManager");
+// src/util.ts
+var formatInt = /* @__PURE__ */ __name((int) => int < 10 ? `0${int}` : int, "formatInt");
+function formatDuration(sec) {
+  if (!sec || !Number(sec)) return "00:00";
+  const seconds = Math.floor(sec % 60);
+  const minutes = Math.floor(sec % 3600 / 60);
+  const hours = Math.floor(sec / 3600);
+  if (hours > 0) return `${formatInt(hours)}:${formatInt(minutes)}:${formatInt(seconds)}`;
+  if (minutes > 0) return `${formatInt(minutes)}:${formatInt(seconds)}`;
+  return `00:${formatInt(seconds)}`;
+}
+__name(formatDuration, "formatDuration");
+var SUPPORTED_PROTOCOL = ["https:", "http:", "file:"];
+function isURL(input) {
+  if (typeof input !== "string" || input.includes(" ")) return false;
+  try {
+    const url = new URL2(input);
+    if (!SUPPORTED_PROTOCOL.some((p) => p === url.protocol)) return false;
+  } catch {
+    return false;
   }
-  /**
-   * The queue to manage
-   */
-  queue;
-  constructor(queue) {
-    super(queue.distube);
-    this.queue = queue;
+  return true;
+}
+__name(isURL, "isURL");
+function checkIntents(options) {
+  const intents = options.intents instanceof IntentsBitField ? options.intents : new IntentsBitField(options.intents);
+  if (!intents.has(GatewayIntentBits.GuildVoiceStates)) throw new DisTubeError("MISSING_INTENTS", "GuildVoiceStates");
+}
+__name(checkIntents, "checkIntents");
+function isVoiceChannelEmpty(voiceState) {
+  const guild = voiceState.guild;
+  const clientId = voiceState.client.user?.id;
+  if (!guild || !clientId) return false;
+  const voiceChannel = guild.members.me?.voice?.channel;
+  if (!voiceChannel) return false;
+  const members = voiceChannel.members.filter((m) => !m.user.bot);
+  return !members.size;
+}
+__name(isVoiceChannelEmpty, "isVoiceChannelEmpty");
+function isSnowflake(id) {
+  try {
+    return SnowflakeUtil.deconstruct(id).timestamp > SnowflakeUtil.epoch;
+  } catch {
+    return false;
   }
-  #resolve(filter) {
-    if (typeof filter === "object" && typeof filter.name === "string" && typeof filter.value === "string") {
-      return filter;
+}
+__name(isSnowflake, "isSnowflake");
+function isMemberInstance(member) {
+  return Boolean(member) && isSnowflake(member.id) && isSnowflake(member.guild?.id) && isSnowflake(member.user?.id) && member.id === member.user.id;
+}
+__name(isMemberInstance, "isMemberInstance");
+function isTextChannelInstance(channel) {
+  return Boolean(channel) && isSnowflake(channel.id) && isSnowflake(channel.guildId || channel.guild?.id) && Constants2.TextBasedChannelTypes.includes(channel.type) && typeof channel.send === "function" && (typeof channel.nsfw === "boolean" || typeof channel.parent?.nsfw === "boolean");
+}
+__name(isTextChannelInstance, "isTextChannelInstance");
+function isMessageInstance(message) {
+  return Boolean(message) && isSnowflake(message.id) && isSnowflake(message.guildId || message.guild?.id) && isMemberInstance(message.member) && isTextChannelInstance(message.channel) && Constants2.NonSystemMessageTypes.includes(message.type) && message.member.id === message.author?.id;
+}
+__name(isMessageInstance, "isMessageInstance");
+function isSupportedVoiceChannel(channel) {
+  return Boolean(channel) && isSnowflake(channel.id) && isSnowflake(channel.guildId || channel.guild?.id) && Constants2.VoiceBasedChannelTypes.includes(channel.type);
+}
+__name(isSupportedVoiceChannel, "isSupportedVoiceChannel");
+function isGuildInstance(guild) {
+  return Boolean(guild) && isSnowflake(guild.id) && isSnowflake(guild.ownerId) && typeof guild.name === "string";
+}
+__name(isGuildInstance, "isGuildInstance");
+function resolveGuildId(resolvable) {
+  let guildId;
+  if (typeof resolvable === "string") {
+    guildId = resolvable;
+  } else if (isObject(resolvable)) {
+    if ("guildId" in resolvable && resolvable.guildId) {
+      guildId = resolvable.guildId;
+    } else if (resolvable instanceof Queue || resolvable instanceof DisTubeVoice || isGuildInstance(resolvable)) {
+      guildId = resolvable.id;
+    } else if ("guild" in resolvable && isGuildInstance(resolvable.guild)) {
+      guildId = resolvable.guild.id;
     }
-    if (typeof filter === "string" && Object.prototype.hasOwnProperty.call(this.distube.filters, filter)) {
-      return {
-        name: filter,
-        value: this.distube.filters[filter]
-      };
+  }
+  if (!isSnowflake(guildId)) throw new DisTubeError("INVALID_TYPE", "GuildIdResolvable", resolvable);
+  return guildId;
+}
+__name(resolveGuildId, "resolveGuildId");
+function isClientInstance(client) {
+  return Boolean(client) && typeof client.login === "function";
+}
+__name(isClientInstance, "isClientInstance");
+function checkInvalidKey(target, source, sourceName) {
+  if (!isObject(target)) throw new DisTubeError("INVALID_TYPE", "object", target, sourceName);
+  const sourceKeys = Array.isArray(source) ? source : objectKeys(source);
+  const invalidKey = objectKeys(target).find((key) => !sourceKeys.includes(key));
+  if (invalidKey) throw new DisTubeError("INVALID_KEY", sourceName, invalidKey);
+}
+__name(checkInvalidKey, "checkInvalidKey");
+function isObject(obj) {
+  return typeof obj === "object" && obj !== null && !Array.isArray(obj);
+}
+__name(isObject, "isObject");
+function objectKeys(obj) {
+  if (!isObject(obj)) return [];
+  return Object.keys(obj);
+}
+__name(objectKeys, "objectKeys");
+function isNsfwChannel(channel) {
+  if (!isTextChannelInstance(channel)) return false;
+  if (channel.isThread()) return channel.parent?.nsfw ?? false;
+  return channel.nsfw;
+}
+__name(isNsfwChannel, "isNsfwChannel");
+var isTruthy = /* @__PURE__ */ __name((x) => Boolean(x), "isTruthy");
+var checkEncryptionLibraries = /* @__PURE__ */ __name(async () => {
+  if (await import("crypto").then((m) => m.getCiphers().includes("aes-256-gcm"))) return true;
+  for (const lib of [
+    "@noble/ciphers",
+    "@stablelib/xchacha20poly1305",
+    "sodium-native",
+    "sodium",
+    "libsodium-wrappers",
+    "tweetnacl"
+  ]) {
+    try {
+      await import(lib);
+      return true;
+    } catch {
     }
-    throw new DisTubeError("INVALID_TYPE", "FilterResolvable", filter, "filter");
   }
-  #apply() {
-    this.queue._beginTime = this.queue.currentTime;
-    this.queue.play(false);
+  return false;
+}, "checkEncryptionLibraries");
+
+// src/struct/Playlist.ts
+var Playlist = class {
+  static {
+    __name(this, "Playlist");
   }
   /**
-   * Enable a filter or multiple filters to the manager
-   * @param filterOrFilters - The filter or filters to enable
-   * @param override        - Wether or not override the applied filter with new filter value
+   * Playlist source.
    */
-  add(filterOrFilters, override = false) {
-    if (Array.isArray(filterOrFilters)) {
-      for (const filter of filterOrFilters) {
-        const ft = this.#resolve(filter);
-        if (override || !this.has(ft)) this.collection.set(ft.name, ft);
-      }
-    } else {
-      const ft = this.#resolve(filterOrFilters);
-      if (override || !this.has(ft)) this.collection.set(ft.name, ft);
-    }
-    this.#apply();
-    return this;
-  }
+  source;
   /**
-   * Clear enabled filters of the manager
+   * Songs in the playlist.
    */
-  clear() {
-    return this.set([]);
-  }
+  songs;
   /**
-   * Set the filters applied to the manager
-   * @param filters - The filters to apply
+   * Playlist ID.
    */
-  set(filters) {
-    if (!Array.isArray(filters)) throw new DisTubeError("INVALID_TYPE", "Array<FilterResolvable>", filters, "filters");
-    this.collection.clear();
-    for (const f of filters) {
-      const filter = this.#resolve(f);
-      this.collection.set(filter.name, filter);
-    }
-    this.#apply();
-    return this;
-  }
-  #removeFn(f) {
-    return this.collection.delete(this.#resolve(f).name);
-  }
+  id;
   /**
-   * Disable a filter or multiple filters
-   * @param filterOrFilters - The filter or filters to disable
+   * Playlist name.
    */
-  remove(filterOrFilters) {
-    if (Array.isArray(filterOrFilters)) filterOrFilters.forEach((f) => this.#removeFn(f));
-    else this.#removeFn(filterOrFilters);
-    this.#apply();
-    return this;
-  }
+  name;
   /**
-   * Check whether a filter enabled or not
-   * @param filter - The filter to check
+   * Playlist URL.
    */
-  has(filter) {
-    return this.collection.has(typeof filter === "string" ? filter : this.#resolve(filter).name);
-  }
+  url;
   /**
-   * Array of enabled filter names
+   * Playlist thumbnail.
    */
-  get names() {
-    return [...this.collection.keys()];
-  }
+  thumbnail;
+  #metadata;
+  #member;
   /**
-   * Array of enabled filters
+   * Create a Playlist
+   * @param playlist  - Raw playlist info
+   * @param options   - Optional data
    */
-  get values() {
-    return [...this.collection.values()];
-  }
-  get ffmpegArgs() {
-    return this.size ? { af: this.values.map((f) => f.value).join(",") } : {};
-  }
-  toString() {
-    return this.names.toString();
-  }
-};
-
-// src/core/manager/QueueManager.ts
-var QueueManager = class extends GuildIdManager {
-  static {
-    __name(this, "QueueManager");
+  constructor(playlist, { member, metadata } = {}) {
+    if (!Array.isArray(playlist.songs) || !playlist.songs.length) throw new DisTubeError("EMPTY_PLAYLIST");
+    this.source = playlist.source.toLowerCase();
+    this.songs = playlist.songs;
+    this.name = playlist.name;
+    this.id = playlist.id;
+    this.url = playlist.url;
+    this.thumbnail = playlist.thumbnail;
+    this.member = member;
+    this.songs.forEach((s) => s.playlist = this);
+    this.metadata = metadata;
   }
   /**
-   * Create a {@link Queue}
-   * @param channel     - A voice channel
-   * @param textChannel - Default text channel
-   * @returns Returns `true` if encounter an error
+   * Playlist duration in second.
    */
-  async create(channel, textChannel) {
-    if (this.has(channel.guildId)) throw new DisTubeError("QUEUE_EXIST");
-    this.debug(`[QueueManager] Creating queue for guild: ${channel.guildId}`);
-    const voice = this.voices.create(channel);
-    const queue = new Queue(this.distube, voice, textChannel);
-    await queue._taskQueue.queuing();
-    try {
-      checkFFmpeg(this.distube);
-      this.debug(`[QueueManager] Joining voice channel: ${channel.id}`);
-      await voice.join();
-      this.#voiceEventHandler(queue);
-      this.add(queue.id, queue);
-      this.emit("initQueue" /* INIT_QUEUE */, queue);
-      return queue;
-    } finally {
-      queue._taskQueue.resolve();
-    }
+  get duration() {
+    return this.songs.reduce((prev, next) => prev + next.duration, 0);
   }
   /**
-   * Listen to DisTubeVoice events and handle the Queue
-   * @param queue - Queue
+   * Formatted duration string `hh:mm:ss`.
    */
-  #voiceEventHandler(queue) {
-    queue._listeners = {
-      disconnect: /* @__PURE__ */ __name((error) => {
-        queue.remove();
-        this.emit("disconnect" /* DISCONNECT */, queue);
-        if (error) this.emitError(error, queue, queue.songs?.[0]);
-      }, "disconnect"),
-      error: /* @__PURE__ */ __name((error) => this.#handlePlayingError(queue, error), "error"),
-      finish: /* @__PURE__ */ __name(() => this.#handleSongFinish(queue), "finish")
-    };
-    for (const event of objectKeys(queue._listeners)) {
-      queue.voice.on(event, queue._listeners[event]);
-    }
+  get formattedDuration() {
+    return formatDuration(this.duration);
   }
   /**
-   * Whether or not emit playSong event
-   * @param queue - Queue
+   * User requested.
    */
-  #emitPlaySong(queue) {
-    if (!this.options.emitNewSongOnly) return true;
-    if (queue.repeatMode === 1 /* SONG */) return queue._next || queue._prev;
-    return queue.songs[0].id !== queue.songs[1].id;
+  get member() {
+    return this.#member;
   }
-  /**
-   * Handle the queue when a Song finish
-   * @param queue - queue
-   */
-  async #handleSongFinish(queue) {
-    this.debug(`[QueueManager] Handling song finish: ${queue.id}`);
-    const song = queue.songs[0];
-    this.emit("finishSong" /* FINISH_SONG */, queue, queue.songs[0]);
-    await queue._taskQueue.queuing();
-    try {
-      if (queue.stopped) return;
-      if (queue.repeatMode === 2 /* QUEUE */ && !queue._prev) queue.songs.push(song);
-      if (queue._prev) {
-        if (queue.repeatMode === 2 /* QUEUE */) queue.songs.unshift(queue.songs.pop());
-        else queue.songs.unshift(queue.previousSongs.pop());
-      }
-      if (queue.songs.length <= 1 && (queue._next || queue.repeatMode === 0 /* DISABLED */)) {
-        if (queue.autoplay) {
-          try {
-            this.debug(`[QueueManager] Adding related song: ${queue.id}`);
-            await queue.addRelatedSong();
-          } catch (e) {
-            this.debug(`[${queue.id}] Add related song error: ${e.message}`);
-            this.emit("noRelated" /* NO_RELATED */, queue, e);
-          }
-        }
-        if (queue.songs.length <= 1) {
-          this.debug(`[${queue.id}] Queue is empty, stopping...`);
-          if (!queue.autoplay) this.emit("finish" /* FINISH */, queue);
-          queue.remove();
-          return;
-        }
-      }
-      const emitPlaySong = this.#emitPlaySong(queue);
-      if (!queue._prev && (queue.repeatMode !== 1 /* SONG */ || queue._next)) {
-        const prev = queue.songs.shift();
-        if (this.options.savePreviousSongs) queue.previousSongs.push(prev);
-        else queue.previousSongs.push({ id: prev.id });
-      }
-      queue._next = queue._prev = false;
-      queue._beginTime = 0;
-      if (song !== queue.songs[0]) {
-        const playedSong = song.stream.playFromSource ? song : song.stream.song;
-        if (playedSong?.stream.playFromSource) delete playedSong.stream.url;
-      }
-      await this.playSong(queue, emitPlaySong);
-    } finally {
-      queue._taskQueue.resolve();
-    }
+  set member(member) {
+    if (!isMemberInstance(member)) return;
+    this.#member = member;
+    this.songs.forEach((s) => s.member = this.member);
   }
   /**
-   * Handle error while playing
-   * @param queue - queue
-   * @param error - error
+   * User requested.
    */
-  #handlePlayingError(queue, error) {
-    const song = queue.songs.shift();
-    try {
-      error.name = "PlayingError";
-    } catch {
-    }
-    this.debug(`[${queue.id}] Error while playing: ${error.stack || error.message}`);
-    this.emitError(error, queue, song);
-    if (queue.songs.length > 0) {
-      this.debug(`[${queue.id}] Playing next song: ${queue.songs[0]}`);
-      queue._next = queue._prev = false;
-      queue._beginTime = 0;
-      this.playSong(queue);
-    } else {
-      this.debug(`[${queue.id}] Queue is empty, stopping...`);
-      queue.stop();
-    }
+  get user() {
+    return this.member?.user;
   }
   /**
-   * Play a song on voice connection with queue properties
-   * @param queue         - The guild queue to play
-   * @param emitPlaySong  - Whether or not emit {@link Events.PLAY_SONG} event
+   * Optional metadata that can be used to identify the playlist.
    */
-  async playSong(queue, emitPlaySong = true) {
-    if (!queue) return;
-    if (queue.stopped || !queue.songs.length) {
-      queue.stop();
-      return;
-    }
-    try {
-      const song = queue.songs[0];
-      this.debug(`[${queue.id}] Getting stream from: ${song}`);
-      await this.handler.attachStreamInfo(song);
-      const willPlaySong = song.stream.playFromSource ? song : song.stream.song;
-      const stream = willPlaySong?.stream;
-      if (!willPlaySong || !stream?.playFromSource || !stream.url) throw new DisTubeError("NO_STREAM_URL", `${song}`);
-      this.debug(`[${queue.id}] Creating DisTubeStream for: ${willPlaySong}`);
-      const streamOptions = {
-        ffmpeg: {
-          path: this.options.ffmpeg.path,
-          args: {
-            global: { ...queue.ffmpegArgs.global },
-            input: { ...queue.ffmpegArgs.input },
-            output: { ...queue.ffmpegArgs.output, ...queue.filters.ffmpegArgs }
-          }
-        },
-        seek: willPlaySong.duration ? queue._beginTime : void 0
-      };
-      const dtStream = new DisTubeStream(stream.url, streamOptions);
-      dtStream.on("debug", (data) => this.emit("ffmpegDebug" /* FFMPEG_DEBUG */, `[${queue.id}] ${data}`));
-      this.debug(`[${queue.id}] Started playing: ${willPlaySong}`);
-      await queue.voice.play(dtStream);
-      if (emitPlaySong) this.emit("playSong" /* PLAY_SONG */, queue, song);
-    } catch (e) {
-      this.#handlePlayingError(queue, e);
-    }
+  get metadata() {
+    return this.#metadata;
+  }
+  set metadata(metadata) {
+    this.#metadata = metadata;
+    this.songs.forEach((s) => s.metadata = metadata);
+  }
+  toString() {
+    return `${this.name} (${this.songs.length} songs)`;
   }
 };
 
-// src/struct/Queue.ts
-var Queue = class extends DisTubeBase {
+// src/struct/Song.ts
+var Song = class {
   static {
-    __name(this, "Queue");
+    __name(this, "Song");
   }
   /**
-   * Queue id (Guild id)
+   * The source of this song info
    */
-  id;
+  source;
   /**
-   * Voice connection of this queue.
+   * Song ID.
    */
-  voice;
+  id;
   /**
-   * List of songs in the queue (The first one is the playing song)
+   * Song name.
    */
-  songs;
+  name;
   /**
-   * List of the previous songs.
+   * Indicates if the song is an active live.
    */
-  previousSongs;
+  isLive;
   /**
-   * Whether stream is currently stopped.
+   * Song duration.
    */
-  stopped;
+  duration;
   /**
-   * Whether or not the stream is currently playing.
+   * Formatted duration string (`hh:mm:ss`, `mm:ss` or `Live`).
    */
-  playing;
+  formattedDuration;
   /**
-   * Whether or not the stream is currently paused.
+   * Song URL.
    */
-  paused;
+  url;
   /**
-   * Type of repeat mode (`0` is disabled, `1` is repeating a song, `2` is repeating
-   * all the queue). Default value: `0` (disabled)
+   * Song thumbnail.
    */
-  repeatMode;
+  thumbnail;
   /**
-   * Whether or not the autoplay mode is enabled. Default value: `false`
+   * Song view count
    */
-  autoplay;
+  views;
   /**
-   * FFmpeg arguments for the current queue. Default value is defined with {@link DisTubeOptions}.ffmpeg.args.
-   * `af` output argument will be replaced with {@link Queue#filters} manager
+   * Song like count
    */
-  ffmpegArgs;
+  likes;
   /**
-   * The text channel of the Queue. (Default: where the first command is called).
+   * Song dislike count
    */
-  textChannel;
-  #filters;
+  dislikes;
   /**
-   * What time in the song to begin (in seconds).
+   * Song repost (share) count
    */
-  _beginTime;
+  reposts;
   /**
-   * Whether or not the last song was skipped to next song.
+   * Song uploader
    */
-  _next;
+  uploader;
   /**
-   * Whether or not the last song was skipped to previous song.
+   * Whether or not an age-restricted content
    */
-  _prev;
+  ageRestricted;
   /**
-   * Task queuing system
+   * Stream info
    */
-  _taskQueue;
+  stream;
   /**
-   * {@link DisTubeVoice} listener
+   * The plugin that created this song
    */
-  _listeners;
+  plugin;
+  #metadata;
+  #member;
+  #playlist;
   /**
-   * Create a queue for the guild
-   * @param distube     - DisTube
-   * @param voice       - Voice connection
-   * @param textChannel - Default text channel
+   * Create a Song
+   *
+   * @param info      - Raw song info
+   * @param options   - Optional data
    */
-  constructor(distube, voice, textChannel) {
-    super(distube);
-    this.voice = voice;
-    this.id = voice.id;
-    this.volume = 50;
-    this.songs = [];
-    this.previousSongs = [];
-    this.stopped = false;
-    this._next = false;
-    this._prev = false;
-    this.playing = false;
-    this.paused = false;
-    this.repeatMode = 0 /* DISABLED */;
-    this.autoplay = false;
-    this.#filters = new FilterManager(this);
-    this._beginTime = 0;
-    this.textChannel = textChannel;
-    this._taskQueue = new TaskQueue();
-    this._listeners = void 0;
-    this.ffmpegArgs = {
-      global: { ...this.options.ffmpeg.args.global },
-      input: { ...this.options.ffmpeg.args.input },
-      output: { ...this.options.ffmpeg.args.output }
+  constructor(info, { member, metadata } = {}) {
+    this.source = info.source.toLowerCase();
+    this.metadata = metadata;
+    this.member = member;
+    this.id = info.id;
+    this.name = info.name;
+    this.isLive = info.isLive;
+    this.duration = this.isLive || !info.duration ? 0 : info.duration;
+    this.formattedDuration = this.isLive ? "Live" : formatDuration(this.duration);
+    this.url = info.url;
+    this.thumbnail = info.thumbnail;
+    this.views = info.views;
+    this.likes = info.likes;
+    this.dislikes = info.dislikes;
+    this.reposts = info.reposts;
+    this.uploader = {
+      name: info.uploader?.name,
+      url: info.uploader?.url
     };
+    this.ageRestricted = info.ageRestricted;
+    this.stream = { playFromSource: info.playFromSource };
+    this.plugin = info.plugin;
   }
   /**
-   * The client user as a `GuildMember` of this queue's guild
+   * The playlist this song belongs to
    */
-  get clientMember() {
-    return this.voice.channel.guild.members.me ?? void 0;
+  get playlist() {
+    return this.#playlist;
   }
-  /**
-   * The filter manager of the queue
-   */
-  get filters() {
-    return this.#filters;
+  set playlist(playlist) {
+    if (!(playlist instanceof Playlist)) throw new DisTubeError("INVALID_TYPE", "Playlist", playlist, "Song#playlist");
+    this.#playlist = playlist;
+    this.member = playlist.member;
   }
   /**
-   * Formatted duration string.
+   * User requested to play this song.
    */
-  get formattedDuration() {
-    return formatDuration(this.duration);
+  get member() {
+    return this.#member;
   }
-  /**
-   * Queue's duration.
-   */
-  get duration() {
-    return this.songs.length ? this.songs.reduce((prev, next) => prev + next.duration, 0) : 0;
+  set member(member) {
+    if (isMemberInstance(member)) this.#member = member;
   }
   /**
-   * What time in the song is playing (in seconds).
+   * User requested to play this song.
    */
-  get currentTime() {
-    return this.voice.playbackDuration + this._beginTime;
+  get user() {
+    return this.member?.user;
   }
   /**
-   * Formatted {@link Queue#currentTime} string.
+   * Optional metadata that can be used to identify the song. This is attached by the
+   * {@link DisTube#play} method.
    */
-  get formattedCurrentTime() {
-    return formatDuration(this.currentTime);
+  get metadata() {
+    return this.#metadata;
   }
-  /**
-   * The voice channel playing in.
-   */
-  get voiceChannel() {
-    return this.clientMember?.voice?.channel ?? null;
+  set metadata(metadata) {
+    this.#metadata = metadata;
   }
-  /**
-   * Get or set the stream volume. Default value: `50`.
-   */
-  get volume() {
-    return this.voice.volume;
+  toString() {
+    return this.name || this.url || this.id || "Unknown";
   }
-  set volume(value) {
-    this.voice.volume = value;
+};
+
+// src/core/DisTubeHandler.ts
+var REDIRECT_CODES = /* @__PURE__ */ new Set([301, 302, 303, 307, 308]);
+var DisTubeHandler = class extends DisTubeBase {
+  static {
+    __name(this, "DisTubeHandler");
   }
   /**
-   * @throws {DisTubeError}
-   * @param song     - Song to add
-   * @param position - Position to add, \<= 0 to add to the end of the queue
-   * @returns The guild queue
+   * Resolve a url or a supported object to a {@link Song} or {@link Playlist}
+   * @throws {@link DisTubeError}
+   * @param input   - Resolvable input
+   * @param options - Optional options
+   * @returns Resolved
    */
-  addToQueue(song, position = 0) {
-    if (this.stopped) throw new DisTubeError("QUEUE_STOPPED");
-    if (!song || Array.isArray(song) && !song.length) {
-      throw new DisTubeError("INVALID_TYPE", ["Song", "Array<Song>"], song, "song");
-    }
-    if (typeof position !== "number" || !Number.isInteger(position)) {
-      throw new DisTubeError("INVALID_TYPE", "integer", position, "position");
+  async resolve(input, options = {}) {
+    if (input instanceof Song || input instanceof Playlist) {
+      if ("metadata" in options) input.metadata = options.metadata;
+      if ("member" in options) input.member = options.member;
+      return input;
     }
-    if (position <= 0) {
-      if (Array.isArray(song)) this.songs.push(...song);
-      else this.songs.push(song);
-    } else if (Array.isArray(song)) {
-      this.songs.splice(position, 0, ...song);
-    } else {
-      this.songs.splice(position, 0, song);
+    if (typeof input === "string") {
+      if (isURL(input)) {
+        const plugin = await this._getPluginFromURL(input) || await this._getPluginFromURL(input = await this.followRedirectLink(input));
+        if (!plugin) throw new DisTubeError("NOT_SUPPORTED_URL");
+        this.debug(`[${plugin.constructor.name}] Resolving from url: ${input}`);
+        return plugin.resolve(input, options);
+      }
+      try {
+        const song = await this.#searchSong(input, options);
+        if (song) return song;
+      } catch {
+        throw new DisTubeError("NO_RESULT", input);
+      }
     }
-    return this;
-  }
-  /**
-   * @returns `true` if the queue is playing
-   */
-  isPlaying() {
-    return this.playing;
+    throw new DisTubeError("CANNOT_RESOLVE_SONG", input);
   }
-  /**
-   * @returns `true` if the queue is paused
-   */
-  isPaused() {
-    return this.paused;
+  async _getPluginFromURL(url) {
+    for (const plugin of this.plugins) if (await plugin.validate(url)) return plugin;
+    return null;
   }
-  /**
-   * Pause the guild stream
-   * @returns The guild queue
-   */
-  async pause() {
-    await this._taskQueue.queuing();
-    try {
-      if (this.paused) throw new DisTubeError("PAUSED");
-      this.paused = true;
-      this.voice.pause();
-      return this;
-    } finally {
-      this._taskQueue.resolve();
+  async _getPluginFromSong(song, types, validate = true) {
+    if (!types || types.includes(song.plugin?.type)) return song.plugin;
+    if (!song.url) return null;
+    for (const plugin of this.plugins) {
+      if ((!types || types.includes(plugin?.type)) && (!validate || await plugin.validate(song.url))) {
+        return plugin;
+      }
     }
+    return null;
   }
-  /**
-   * Resume the guild stream
-   * @returns The guild queue
-   */
-  async resume() {
-    await this._taskQueue.queuing();
-    try {
-      if (!this.paused) throw new DisTubeError("RESUMED");
-      this.paused = false;
-      this.voice.unpause();
-      return this;
-    } finally {
-      this._taskQueue.resolve();
+  async #searchSong(query, options = {}, getStreamURL = false) {
+    const plugins = this.plugins.filter((p) => p.type === "extractor" /* EXTRACTOR */);
+    if (!plugins.length) throw new DisTubeError("NO_EXTRACTOR_PLUGIN");
+    for (const plugin of plugins) {
+      this.debug(`[${plugin.constructor.name}] Searching for song: ${query}`);
+      const result = await plugin.searchSong(query, options);
+      if (result) {
+        if (getStreamURL && result.stream.playFromSource) result.stream.url = await plugin.getStreamURL(result);
+        return result;
+      }
     }
+    return null;
   }
   /**
-   * Set the guild stream's volume
-   * @param percent - The percentage of volume you want to set
-   * @returns The guild queue
+   * Get {@link Song}'s stream info and attach it to the song.
+   * @param song - A Song
    */
-  setVolume(percent) {
-    this.volume = percent;
-    return this;
+  async attachStreamInfo(song) {
+    if (song.stream.playFromSource) {
+      if (song.stream.url) return;
+      this.debug(`[DisTubeHandler] Getting stream info: ${song}`);
+      const plugin = await this._getPluginFromSong(song, ["extractor" /* EXTRACTOR */, "playable-extractor" /* PLAYABLE_EXTRACTOR */]);
+      if (!plugin) throw new DisTubeError("NOT_SUPPORTED_SONG", song.toString());
+      this.debug(`[${plugin.constructor.name}] Getting stream URL: ${song}`);
+      song.stream.url = await plugin.getStreamURL(song);
+      if (!song.stream.url) throw new DisTubeError("CANNOT_GET_STREAM_URL", song.toString());
+    } else {
+      if (song.stream.song?.stream?.playFromSource && song.stream.song.stream.url) return;
+      this.debug(`[DisTubeHandler] Getting stream info: ${song}`);
+      const plugin = await this._getPluginFromSong(song, ["info-extractor" /* INFO_EXTRACTOR */]);
+      if (!plugin) throw new DisTubeError("NOT_SUPPORTED_SONG", song.toString());
+      this.debug(`[${plugin.constructor.name}] Creating search query for: ${song}`);
+      const query = await plugin.createSearchQuery(song);
+      if (!query) throw new DisTubeError("CANNOT_GET_SEARCH_QUERY", song.toString());
+      const altSong = await this.#searchSong(query, { metadata: song.metadata, member: song.member }, true);
+      if (!altSong || !altSong.stream.playFromSource) throw new DisTubeError("NO_RESULT", query || song.toString());
+      song.stream.song = altSong;
+    }
   }
-  /**
-   * Skip the playing song if there is a next song in the queue. <info>If {@link
-   * Queue#autoplay} is `true` and there is no up next song, DisTube will add and
-   * play a related song.</info>
-   * @returns The song will skip to
-   */
-  async skip() {
-    await this._taskQueue.queuing();
-    try {
-      if (this.songs.length <= 1) {
-        if (this.autoplay) await this.addRelatedSong();
-        else throw new DisTubeError("NO_UP_NEXT");
+  async followRedirectLink(url, maxRedirect = 5) {
+    if (maxRedirect === 0) return url;
+    const res = await request(url, {
+      method: "HEAD",
+      headers: {
+        "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.3"
       }
-      const song = this.songs[1];
-      this._next = true;
-      this.voice.stop();
-      return song;
-    } finally {
-      this._taskQueue.resolve();
+    });
+    if (REDIRECT_CODES.has(res.statusCode ?? 200)) {
+      let location = res.headers.location;
+      if (typeof location !== "string") location = location?.[0] ?? url;
+      return this.followRedirectLink(location, --maxRedirect);
     }
+    return url;
   }
-  /**
-   * Play the previous song if exists
-   * @returns The guild queue
-   */
-  async previous() {
-    await this._taskQueue.queuing();
-    try {
-      if (!this.options.savePreviousSongs) throw new DisTubeError("DISABLED_OPTION", "savePreviousSongs");
-      if (this.previousSongs?.length === 0 && this.repeatMode !== 2 /* QUEUE */) {
-        throw new DisTubeError("NO_PREVIOUS");
-      }
-      const song = this.repeatMode === 2 ? this.songs[this.songs.length - 1] : this.previousSongs[this.previousSongs.length - 1];
-      this._prev = true;
-      this.voice.stop();
-      return song;
-    } finally {
-      this._taskQueue.resolve();
+};
+
+// src/core/DisTubeOptions.ts
+var Options = class {
+  static {
+    __name(this, "Options");
+  }
+  plugins;
+  emitNewSongOnly;
+  savePreviousSongs;
+  customFilters;
+  nsfw;
+  emitAddSongWhenCreatingQueue;
+  emitAddListWhenCreatingQueue;
+  joinNewVoiceChannel;
+  ffmpeg;
+  constructor(options) {
+    if (typeof options !== "object" || Array.isArray(options)) {
+      throw new DisTubeError("INVALID_TYPE", "object", options, "DisTubeOptions");
     }
+    const opts = { ...defaultOptions, ...options };
+    this.plugins = opts.plugins;
+    this.emitNewSongOnly = opts.emitNewSongOnly;
+    this.savePreviousSongs = opts.savePreviousSongs;
+    this.customFilters = opts.customFilters;
+    this.nsfw = opts.nsfw;
+    this.emitAddSongWhenCreatingQueue = opts.emitAddSongWhenCreatingQueue;
+    this.emitAddListWhenCreatingQueue = opts.emitAddListWhenCreatingQueue;
+    this.joinNewVoiceChannel = opts.joinNewVoiceChannel;
+    this.ffmpeg = this.#ffmpegOption(options);
+    checkInvalidKey(opts, this, "DisTubeOptions");
+    this.#validateOptions();
   }
-  /**
-   * Shuffle the queue's songs
-   * @returns The guild queue
-   */
-  async shuffle() {
-    await this._taskQueue.queuing();
-    try {
-      const playing = this.songs.shift();
-      if (playing === void 0) return this;
-      for (let i = this.songs.length - 1; i > 0; i--) {
-        const j = Math.floor(Math.random() * (i + 1));
-        [this.songs[i], this.songs[j]] = [this.songs[j], this.songs[i]];
+  #validateOptions(options = this) {
+    const booleanOptions = /* @__PURE__ */ new Set([
+      "emitNewSongOnly",
+      "savePreviousSongs",
+      "joinNewVoiceChannel",
+      "nsfw",
+      "emitAddSongWhenCreatingQueue",
+      "emitAddListWhenCreatingQueue"
+    ]);
+    const numberOptions = /* @__PURE__ */ new Set();
+    const stringOptions = /* @__PURE__ */ new Set();
+    const objectOptions = /* @__PURE__ */ new Set(["customFilters", "ffmpeg"]);
+    const optionalOptions = /* @__PURE__ */ new Set(["customFilters"]);
+    for (const [key, value] of Object.entries(options)) {
+      if (value === void 0 && optionalOptions.has(key)) continue;
+      if (key === "plugins" && !Array.isArray(value)) {
+        throw new DisTubeError("INVALID_TYPE", "Array<Plugin>", value, `DisTubeOptions.${key}`);
+      } else if (booleanOptions.has(key)) {
+        if (typeof value !== "boolean") {
+          throw new DisTubeError("INVALID_TYPE", "boolean", value, `DisTubeOptions.${key}`);
+        }
+      } else if (numberOptions.has(key)) {
+        if (typeof value !== "number" || Number.isNaN(value)) {
+          throw new DisTubeError("INVALID_TYPE", "number", value, `DisTubeOptions.${key}`);
+        }
+      } else if (stringOptions.has(key)) {
+        if (typeof value !== "string") {
+          throw new DisTubeError("INVALID_TYPE", "string", value, `DisTubeOptions.${key}`);
+        }
+      } else if (objectOptions.has(key)) {
+        if (typeof value !== "object" || Array.isArray(value)) {
+          throw new DisTubeError("INVALID_TYPE", "object", value, `DisTubeOptions.${key}`);
+        }
       }
-      this.songs.unshift(playing);
-      return this;
-    } finally {
-      this._taskQueue.resolve();
     }
   }
-  /**
-   * Jump to the song position in the queue. The next one is 1, 2,... The previous
-   * one is -1, -2,...
-   * if `num` is invalid number
-   * @param position - The song position to play
-   * @returns The new Song will be played
-   */
-  async jump(position) {
-    await this._taskQueue.queuing();
-    try {
-      if (typeof position !== "number") throw new DisTubeError("INVALID_TYPE", "number", position, "position");
-      if (!position || position > this.songs.length || -position > this.previousSongs.length) {
-        throw new DisTubeError("NO_SONG_POSITION");
+  #ffmpegOption(opts) {
+    const args = { global: {}, input: {}, output: {} };
+    if (opts.ffmpeg?.args) {
+      if (opts.ffmpeg.args.global) args.global = opts.ffmpeg.args.global;
+      if (opts.ffmpeg.args.input) args.input = opts.ffmpeg.args.input;
+      if (opts.ffmpeg.args.output) args.output = opts.ffmpeg.args.output;
+    }
+    const path = opts.ffmpeg?.path ?? "ffmpeg";
+    if (typeof path !== "string") {
+      throw new DisTubeError("INVALID_TYPE", "string", path, "DisTubeOptions.ffmpeg.path");
+    }
+    for (const [key, value] of Object.entries(args)) {
+      if (typeof value !== "object" || Array.isArray(value)) {
+        throw new DisTubeError("INVALID_TYPE", "object", value, `DisTubeOptions.ffmpeg.${key}`);
       }
-      let nextSong;
-      if (position > 0) {
-        const nextSongs = this.songs.splice(position - 1);
-        if (this.options.savePreviousSongs) {
-          this.previousSongs.push(...this.songs);
-        } else {
-          this.previousSongs.push(...this.songs.map((s) => ({ id: s.id })));
+      for (const [k, v] of Object.entries(value)) {
+        if (typeof v !== "string" && typeof v !== "number" && typeof v !== "boolean" && !Array.isArray(v) && v !== null && v !== void 0) {
+          throw new DisTubeError(
+            "INVALID_TYPE",
+            ["string", "number", "boolean", "Array<string | null | undefined>", "null", "undefined"],
+            v,
+            `DisTubeOptions.ffmpeg.${key}.${k}`
+          );
         }
-        this.songs = nextSongs;
-        this._next = true;
-        nextSong = nextSongs[1];
-      } else if (!this.options.savePreviousSongs) {
-        throw new DisTubeError("DISABLED_OPTION", "savePreviousSongs");
-      } else {
-        this._prev = true;
-        if (position !== -1) this.songs.unshift(...this.previousSongs.splice(position + 1));
-        nextSong = this.previousSongs[this.previousSongs.length - 1];
       }
-      this.voice.stop();
-      return nextSong;
-    } finally {
-      this._taskQueue.resolve();
     }
+    return { path, args };
   }
-  /**
-   * Set the repeat mode of the guild queue.
-   * Toggle mode `(Disabled -> Song -> Queue -> Disabled ->...)` if `mode` is `undefined`
-   * @param mode - The repeat modes (toggle if `undefined`)
-   * @returns The new repeat mode
-   */
-  setRepeatMode(mode) {
-    if (mode !== void 0 && !Object.values(RepeatMode).includes(mode)) {
-      throw new DisTubeError("INVALID_TYPE", ["RepeatMode", "undefined"], mode, "mode");
-    }
-    if (mode === void 0) this.repeatMode = (this.repeatMode + 1) % 3;
-    else if (this.repeatMode === mode) this.repeatMode = 0 /* DISABLED */;
-    else this.repeatMode = mode;
-    return this.repeatMode;
-  }
-  /**
-   * Set the playing time to another position
-   * @param time - Time in seconds
-   * @returns The guild queue
-   */
-  seek(time) {
-    if (typeof time !== "number") throw new DisTubeError("INVALID_TYPE", "number", time, "time");
-    if (isNaN(time) || time < 0) throw new DisTubeError("NUMBER_COMPARE", "time", "bigger or equal to", 0);
-    this._beginTime = time;
-    this.play(false);
-    return this;
-  }
-  async #getRelatedSong(current) {
-    const plugin = await this.handler._getPluginFromSong(current);
-    if (plugin) return plugin.getRelatedSongs(current);
-    return [];
+};
+
+// src/core/DisTubeStream.ts
+import { spawn, spawnSync } from "child_process";
+import { Transform } from "stream";
+import { createAudioResource, StreamType } from "@discordjs/voice";
+import { TypedEmitter as TypedEmitter2 } from "tiny-typed-emitter";
+var checked = process.env.NODE_ENV === "test";
+var checkFFmpeg = /* @__PURE__ */ __name((distube) => {
+  if (checked) return;
+  const path = distube.options.ffmpeg.path;
+  const debug = /* @__PURE__ */ __name((str) => distube.emit("ffmpegDebug" /* FFMPEG_DEBUG */, str), "debug");
+  try {
+    debug(`[test] spawn ffmpeg at '${path}' path`);
+    const process2 = spawnSync(path, ["-h"], {
+      windowsHide: true,
+      encoding: "utf-8"
+    });
+    if (process2.error) throw process2.error;
+    if (process2.stderr && !process2.stdout) throw new Error(process2.stderr);
+    const result = process2.output.join("\n");
+    const version2 = /ffmpeg version (\S+)/iu.exec(result)?.[1];
+    if (!version2) throw new Error("Invalid FFmpeg version");
+    debug(`[test] ffmpeg version: ${version2}`);
+  } catch (e) {
+    debug(`[test] failed to spawn ffmpeg at '${path}': ${e?.stack ?? e}`);
+    throw new DisTubeError("FFMPEG_NOT_INSTALLED", path);
   }
-  /**
-   * Add a related song of the playing song to the queue
-   * @returns The added song
-   */
-  async addRelatedSong() {
-    const current = this.songs?.[0];
-    if (!current) throw new DisTubeError("NO_PLAYING_SONG");
-    const prevIds = this.previousSongs.map((p) => p.id);
-    const relatedSongs = (await this.#getRelatedSong(current)).filter((s) => !prevIds.includes(s.id));
-    this.debug(`[${this.id}] Getting related songs from: ${current}`);
-    if (!relatedSongs.length && !current.stream.playFromSource) {
-      const altSong = current.stream.song;
-      if (altSong) relatedSongs.push(...(await this.#getRelatedSong(altSong)).filter((s) => !prevIds.includes(s.id)));
-      this.debug(`[${this.id}] Getting related songs from streamed song: ${altSong}`);
-    }
-    const song = relatedSongs[0];
-    if (!song) throw new DisTubeError("NO_RELATED");
-    song.metadata = current.metadata;
-    song.member = this.clientMember;
-    this.addToQueue(song);
-    return song;
+  checked = true;
+}, "checkFFmpeg");
+var DisTubeStream = class extends TypedEmitter2 {
+  static {
+    __name(this, "DisTubeStream");
   }
+  #ffmpegPath;
+  #opts;
+  process;
+  stream;
+  audioResource;
   /**
-   * Stop the guild stream and delete the queue
+   * Create a DisTubeStream to play with {@link DisTubeVoice}
+   * @param url     - Stream URL
+   * @param options - Stream options
    */
-  async stop() {
-    await this._taskQueue.queuing();
-    try {
-      this.voice.stop();
-      this.remove();
-    } finally {
-      this._taskQueue.resolve();
+  constructor(url, options) {
+    super();
+    const { ffmpeg, seek } = options;
+    const opts = {
+      reconnect: 1,
+      reconnect_streamed: 1,
+      reconnect_delay_max: 5,
+      analyzeduration: 0,
+      hide_banner: true,
+      ...ffmpeg.args.global,
+      ...ffmpeg.args.input,
+      i: url,
+      ar: 48e3,
+      ac: 2,
+      ...ffmpeg.args.output,
+      f: "s16le"
+    };
+    if (typeof seek === "number" && seek > 0) opts.ss = seek.toString();
+    const fileUrl = new URL(url);
+    if (fileUrl.protocol === "file:") {
+      opts.reconnect = null;
+      opts.reconnect_streamed = null;
+      opts.reconnect_delay_max = null;
+      opts.i = fileUrl.hostname + fileUrl.pathname;
     }
+    this.#ffmpegPath = ffmpeg.path;
+    this.#opts = [
+      ...Object.entries(opts).flatMap(
+        ([key, value]) => Array.isArray(value) ? value.filter(Boolean).map((v) => [`-${key}`, String(v)]) : value == null || value === false ? [] : [value === true ? `-${key}` : [`-${key}`, String(value)]]
+      ).flat(),
+      "pipe:1"
+    ];
+    this.stream = new VolumeTransformer();
+    this.stream.on("close", () => this.kill()).on("error", (err) => {
+      this.debug(`[stream] error: ${err.message}`);
+      this.emit("error", err);
+    }).on("finish", () => this.debug("[stream] log: stream finished"));
+    this.audioResource = createAudioResource(this.stream, {
+      inputType: StreamType.Raw,
+      inlineVolume: false
+    });
   }
-  /**
-   * Remove the queue from the manager
-   */
-  remove() {
-    this.playing = false;
-    this.paused = false;
-    this.stopped = true;
-    this.songs = [];
-    this.previousSongs = [];
-    if (this._listeners) for (const event of objectKeys(this._listeners)) this.voice.off(event, this._listeners[event]);
-    this.queues.remove(this.id);
-    this.emit("deleteQueue" /* DELETE_QUEUE */, this);
+  spawn() {
+    this.debug(`[process] spawn: ${this.#ffmpegPath} ${this.#opts.join(" ")}`);
+    this.process = spawn(this.#ffmpegPath, this.#opts, {
+      stdio: ["ignore", "pipe", "pipe"],
+      shell: false,
+      windowsHide: true
+    }).on("error", (err) => {
+      this.debug(`[process] error: ${err.message}`);
+      this.emit("error", err);
+    }).on("exit", (code, signal) => {
+      this.debug(`[process] exit: code=${code ?? "unknown"} signal=${signal ?? "unknown"}`);
+      if (!code || [0, 255].includes(code)) return;
+      this.debug(`[process] error: ffmpeg exited with code ${code}`);
+      this.emit("error", new DisTubeError("FFMPEG_EXITED", code));
+    });
+    if (!this.process.stdout || !this.process.stderr) {
+      this.kill();
+      throw new Error("Failed to create ffmpeg process");
+    }
+    this.process.stdout.pipe(this.stream);
+    this.process.stderr.setEncoding("utf8")?.on("data", (data) => {
+      const lines = data.split(/\r\n|\r|\n/u);
+      for (const line of lines) {
+        if (/^\s*$/.test(line)) continue;
+        this.debug(`[ffmpeg] log: ${line}`);
+      }
+    });
   }
-  /**
-   * Toggle autoplay mode
-   * @returns Autoplay mode state
-   */
-  toggleAutoplay() {
-    this.autoplay = !this.autoplay;
-    return this.autoplay;
+  debug(debug) {
+    this.emit("debug", debug);
   }
-  /**
-   * Play the first song in the queue
-   * @param emitPlaySong - Whether or not emit {@link Events.PLAY_SONG} event
-   */
-  play(emitPlaySong = true) {
-    if (this.stopped) throw new DisTubeError("QUEUE_STOPPED");
-    this.playing = true;
-    return this.queues.playSong(this, emitPlaySong);
+  setVolume(volume) {
+    this.stream.vol = volume;
+  }
+  kill() {
+    if (!this.stream.destroyed) this.stream.destroy();
+    if (this.process && !this.process.killed) this.process.kill("SIGKILL");
   }
 };
-
-// src/struct/Plugin.ts
-var Plugin = class {
+var VolumeTransformer = class extends Transform {
   static {
-    __name(this, "Plugin");
+    __name(this, "VolumeTransformer");
   }
-  /**
-   * DisTube
-   */
-  distube;
-  init(distube) {
-    this.distube = distube;
+  buffer = Buffer.allocUnsafe(0);
+  extrema = [-(2 ** (16 - 1)), 2 ** (16 - 1) - 1];
+  vol = 1;
+  _transform(newChunk, _encoding, done) {
+    const { vol } = this;
+    if (vol === 1) {
+      this.push(newChunk);
+      done();
+      return;
+    }
+    const bytes = 2;
+    const chunk = Buffer.concat([this.buffer, newChunk]);
+    const readableLength = Math.floor(chunk.length / bytes) * bytes;
+    for (let i = 0; i < readableLength; i += bytes) {
+      const value = chunk.readInt16LE(i);
+      const clampedValue = Math.min(this.extrema[1], Math.max(this.extrema[0], value * vol));
+      chunk.writeInt16LE(clampedValue, i);
+    }
+    this.buffer = chunk.subarray(readableLength);
+    this.push(chunk.subarray(0, readableLength));
+    done();
   }
 };
 
-// src/struct/ExtractorPlugin.ts
-var ExtractorPlugin = class extends Plugin {
+// src/core/manager/DisTubeVoiceManager.ts
+import { getVoiceConnection, VoiceConnectionStatus as VoiceConnectionStatus2 } from "@discordjs/voice";
+
+// src/core/manager/GuildIdManager.ts
+var GuildIdManager = class extends BaseManager {
   static {
-    __name(this, "ExtractorPlugin");
+    __name(this, "GuildIdManager");
+  }
+  add(idOrInstance, data) {
+    const id = resolveGuildId(idOrInstance);
+    const existing = this.get(id);
+    if (existing) return this;
+    this.collection.set(id, data);
+    return this;
+  }
+  get(idOrInstance) {
+    return this.collection.get(resolveGuildId(idOrInstance));
+  }
+  remove(idOrInstance) {
+    return this.collection.delete(resolveGuildId(idOrInstance));
+  }
+  has(idOrInstance) {
+    return this.collection.has(resolveGuildId(idOrInstance));
   }
-  type = "extractor" /* EXTRACTOR */;
 };
 
-// src/struct/InfoExtratorPlugin.ts
-var InfoExtractorPlugin = class extends Plugin {
+// src/core/manager/DisTubeVoiceManager.ts
+var DisTubeVoiceManager = class extends GuildIdManager {
   static {
-    __name(this, "InfoExtractorPlugin");
+    __name(this, "DisTubeVoiceManager");
+  }
+  /**
+   * Create a {@link DisTubeVoice} instance
+   * @param channel - A voice channel to join
+   */
+  create(channel) {
+    const existing = this.get(channel.guildId);
+    if (existing) {
+      existing.channel = channel;
+      return existing;
+    }
+    if (getVoiceConnection(resolveGuildId(channel), this.client.user?.id) || getVoiceConnection(resolveGuildId(channel))) {
+      throw new DisTubeError("VOICE_ALREADY_CREATED");
+    }
+    return new DisTubeVoice(this, channel);
+  }
+  /**
+   * Join a voice channel and wait until the connection is ready
+   * @param channel - A voice channel to join
+   */
+  join(channel) {
+    const existing = this.get(channel.guildId);
+    if (existing) return existing.join(channel);
+    return this.create(channel).join();
+  }
+  /**
+   * Leave the connected voice channel in a guild
+   * @param guild - Queue Resolvable
+   */
+  leave(guild) {
+    const voice = this.get(guild);
+    if (voice) {
+      voice.leave();
+    } else {
+      const connection = getVoiceConnection(resolveGuildId(guild), this.client.user?.id) ?? getVoiceConnection(resolveGuildId(guild));
+      if (connection && connection.state.status !== VoiceConnectionStatus2.Destroyed) {
+        connection.destroy();
+      }
+    }
   }
-  type = "info-extractor" /* INFO_EXTRACTOR */;
 };
 
-// src/struct/PlayableExtratorPlugin.ts
-var PlayableExtractorPlugin = class extends Plugin {
+// src/core/manager/QueueManager.ts
+var QueueManager = class extends GuildIdManager {
   static {
-    __name(this, "PlayableExtractorPlugin");
+    __name(this, "QueueManager");
   }
-  type = "playable-extractor" /* PLAYABLE_EXTRACTOR */;
-};
-
-// src/util.ts
-import { URL as URL2 } from "url";
-import { Constants as Constants2, GatewayIntentBits, IntentsBitField, SnowflakeUtil } from "discord.js";
-var formatInt = /* @__PURE__ */ __name((int) => int < 10 ? `0${int}` : int, "formatInt");
-function formatDuration(sec) {
-  if (!sec || !Number(sec)) return "00:00";
-  const seconds = Math.floor(sec % 60);
-  const minutes = Math.floor(sec % 3600 / 60);
-  const hours = Math.floor(sec / 3600);
-  if (hours > 0) return `${formatInt(hours)}:${formatInt(minutes)}:${formatInt(seconds)}`;
-  if (minutes > 0) return `${formatInt(minutes)}:${formatInt(seconds)}`;
-  return `00:${formatInt(seconds)}`;
-}
-__name(formatDuration, "formatDuration");
-var SUPPORTED_PROTOCOL = ["https:", "http:", "file:"];
-function isURL(input) {
-  if (typeof input !== "string" || input.includes(" ")) return false;
-  try {
-    const url = new URL2(input);
-    if (!SUPPORTED_PROTOCOL.some((p) => p === url.protocol)) return false;
-  } catch {
-    return false;
+  /**
+   * Create a {@link Queue}
+   * @param channel     - A voice channel
+   * @param textChannel - Default text channel
+   * @returns Returns `true` if encounter an error
+   */
+  async create(channel, textChannel) {
+    if (this.has(channel.guildId)) throw new DisTubeError("QUEUE_EXIST");
+    this.debug(`[QueueManager] Creating queue for guild: ${channel.guildId}`);
+    const voice = this.voices.create(channel);
+    const queue = new Queue(this.distube, voice, textChannel);
+    await queue._taskQueue.queuing();
+    try {
+      checkFFmpeg(this.distube);
+      this.debug(`[QueueManager] Joining voice channel: ${channel.id}`);
+      await voice.join();
+      this.#voiceEventHandler(queue);
+      this.add(queue.id, queue);
+      this.emit("initQueue" /* INIT_QUEUE */, queue);
+      return queue;
+    } finally {
+      queue._taskQueue.resolve();
+    }
   }
-  return true;
-}
-__name(isURL, "isURL");
-function checkIntents(options) {
-  const intents = options.intents instanceof IntentsBitField ? options.intents : new IntentsBitField(options.intents);
-  if (!intents.has(GatewayIntentBits.GuildVoiceStates)) throw new DisTubeError("MISSING_INTENTS", "GuildVoiceStates");
-}
-__name(checkIntents, "checkIntents");
-function isVoiceChannelEmpty(voiceState) {
-  const guild = voiceState.guild;
-  const clientId = voiceState.client.user?.id;
-  if (!guild || !clientId) return false;
-  const voiceChannel = guild.members.me?.voice?.channel;
-  if (!voiceChannel) return false;
-  const members = voiceChannel.members.filter((m) => !m.user.bot);
-  return !members.size;
-}
-__name(isVoiceChannelEmpty, "isVoiceChannelEmpty");
-function isSnowflake(id) {
-  try {
-    return SnowflakeUtil.deconstruct(id).timestamp > SnowflakeUtil.epoch;
-  } catch {
-    return false;
+  /**
+   * Listen to DisTubeVoice events and handle the Queue
+   * @param queue - Queue
+   */
+  #voiceEventHandler(queue) {
+    queue._listeners = {
+      disconnect: /* @__PURE__ */ __name((error) => {
+        queue.remove();
+        this.emit("disconnect" /* DISCONNECT */, queue);
+        if (error) this.emitError(error, queue, queue.songs?.[0]);
+      }, "disconnect"),
+      error: /* @__PURE__ */ __name((error) => this.#handlePlayingError(queue, error), "error"),
+      finish: /* @__PURE__ */ __name(() => this.handleSongFinish(queue), "finish")
+    };
+    for (const event of objectKeys(queue._listeners)) {
+      queue.voice.on(event, queue._listeners[event]);
+    }
   }
-}
-__name(isSnowflake, "isSnowflake");
-function isMemberInstance(member) {
-  return Boolean(member) && isSnowflake(member.id) && isSnowflake(member.guild?.id) && isSnowflake(member.user?.id) && member.id === member.user.id;
-}
-__name(isMemberInstance, "isMemberInstance");
-function isTextChannelInstance(channel) {
-  return Boolean(channel) && isSnowflake(channel.id) && isSnowflake(channel.guildId || channel.guild?.id) && Constants2.TextBasedChannelTypes.includes(channel.type) && typeof channel.send === "function" && (typeof channel.nsfw === "boolean" || typeof channel.parent?.nsfw === "boolean");
-}
-__name(isTextChannelInstance, "isTextChannelInstance");
-function isMessageInstance(message) {
-  return Boolean(message) && isSnowflake(message.id) && isSnowflake(message.guildId || message.guild?.id) && isMemberInstance(message.member) && isTextChannelInstance(message.channel) && Constants2.NonSystemMessageTypes.includes(message.type) && message.member.id === message.author?.id;
-}
-__name(isMessageInstance, "isMessageInstance");
-function isSupportedVoiceChannel(channel) {
-  return Boolean(channel) && isSnowflake(channel.id) && isSnowflake(channel.guildId || channel.guild?.id) && Constants2.VoiceBasedChannelTypes.includes(channel.type);
-}
-__name(isSupportedVoiceChannel, "isSupportedVoiceChannel");
-function isGuildInstance(guild) {
-  return Boolean(guild) && isSnowflake(guild.id) && isSnowflake(guild.ownerId) && typeof guild.name === "string";
-}
-__name(isGuildInstance, "isGuildInstance");
-function resolveGuildId(resolvable) {
-  let guildId;
-  if (typeof resolvable === "string") {
-    guildId = resolvable;
-  } else if (isObject(resolvable)) {
-    if ("guildId" in resolvable && resolvable.guildId) {
-      guildId = resolvable.guildId;
-    } else if (resolvable instanceof Queue || resolvable instanceof DisTubeVoice || isGuildInstance(resolvable)) {
-      guildId = resolvable.id;
-    } else if ("guild" in resolvable && isGuildInstance(resolvable.guild)) {
-      guildId = resolvable.guild.id;
+  /**
+   * Handle the queue when a Song finish
+   * @param queue - queue
+   */
+  async handleSongFinish(queue) {
+    if (queue._manualUpdate) {
+      queue._manualUpdate = false;
+      await this.playSong(queue);
+      return;
+    }
+    this.debug(`[QueueManager] Handling song finish: ${queue.id}`);
+    const song = queue.songs[0];
+    this.emit("finishSong" /* FINISH_SONG */, queue, song);
+    await queue._taskQueue.queuing();
+    try {
+      if (queue.stopped) return;
+      if (queue.repeatMode === 2 /* QUEUE */) queue.songs.push(song);
+      if (queue.repeatMode !== 1 /* SONG */) {
+        const prev = queue.songs.shift();
+        if (this.options.savePreviousSongs) queue.previousSongs.push(prev);
+        else queue.previousSongs.push({ id: prev.id });
+      }
+      if (queue.songs.length === 0 && queue.autoplay) {
+        try {
+          this.debug(`[QueueManager] Adding related song: ${queue.id}`);
+          await queue.addRelatedSong();
+        } catch (e) {
+          this.debug(`[${queue.id}] Add related song error: ${e.message}`);
+          this.emit("noRelated" /* NO_RELATED */, queue, e);
+        }
+      }
+      if (queue.songs.length === 0) {
+        this.debug(`[${queue.id}] Queue is empty, stopping...`);
+        if (!queue.autoplay) this.emit("finish" /* FINISH */, queue);
+        queue.remove();
+        return;
+      }
+      if (song !== queue.songs[0]) {
+        const playedSong = song.stream.playFromSource ? song : song.stream.song;
+        if (playedSong?.stream.playFromSource) delete playedSong.stream.url;
+      }
+      await this.playSong(queue, true);
+    } finally {
+      queue._taskQueue.resolve();
     }
   }
-  if (!isSnowflake(guildId)) throw new DisTubeError("INVALID_TYPE", "GuildIdResolvable", resolvable);
-  return guildId;
-}
-__name(resolveGuildId, "resolveGuildId");
-function isClientInstance(client) {
-  return Boolean(client) && typeof client.login === "function";
-}
-__name(isClientInstance, "isClientInstance");
-function checkInvalidKey(target, source, sourceName) {
-  if (!isObject(target)) throw new DisTubeError("INVALID_TYPE", "object", target, sourceName);
-  const sourceKeys = Array.isArray(source) ? source : objectKeys(source);
-  const invalidKey = objectKeys(target).find((key) => !sourceKeys.includes(key));
-  if (invalidKey) throw new DisTubeError("INVALID_KEY", sourceName, invalidKey);
-}
-__name(checkInvalidKey, "checkInvalidKey");
-function isObject(obj) {
-  return typeof obj === "object" && obj !== null && !Array.isArray(obj);
-}
-__name(isObject, "isObject");
-function objectKeys(obj) {
-  if (!isObject(obj)) return [];
-  return Object.keys(obj);
-}
-__name(objectKeys, "objectKeys");
-function isNsfwChannel(channel) {
-  if (!isTextChannelInstance(channel)) return false;
-  if (channel.isThread()) return channel.parent?.nsfw ?? false;
-  return channel.nsfw;
-}
-__name(isNsfwChannel, "isNsfwChannel");
-var isTruthy = /* @__PURE__ */ __name((x) => Boolean(x), "isTruthy");
-var checkEncryptionLibraries = /* @__PURE__ */ __name(async () => {
-  if (await import("node:crypto").then((m) => m.getCiphers().includes("aes-256-gcm"))) return true;
-  for (const lib of [
-    "@noble/ciphers",
-    "@stablelib/xchacha20poly1305",
-    "sodium-native",
-    "sodium",
-    "libsodium-wrappers",
-    "tweetnacl"
-  ]) {
+  /**
+   * Handle error while playing
+   * @param queue - queue
+   * @param error - error
+   */
+  #handlePlayingError(queue, error) {
+    const song = queue.songs.shift();
     try {
-      await import(lib);
-      return true;
+      error.name = "PlayingError";
     } catch {
     }
+    this.debug(`[${queue.id}] Error while playing: ${error.stack || error.message}`);
+    this.emitError(error, queue, song);
+    if (queue.songs.length > 0) {
+      this.debug(`[${queue.id}] Playing next song: ${queue.songs[0]}`);
+      this.playSong(queue);
+    } else {
+      this.debug(`[${queue.id}] Queue is empty, stopping...`);
+      queue.stop();
+    }
   }
-  return false;
-}, "checkEncryptionLibraries");
+  /**
+   * Play a song on voice connection with queue properties
+   * @param queue         - The guild queue to play
+   * @param emitPlaySong  - Whether or not emit {@link Events.PLAY_SONG} event
+   */
+  async playSong(queue, emitPlaySong = true) {
+    if (!queue) return;
+    if (queue.stopped || !queue.songs.length) {
+      queue.stop();
+      return;
+    }
+    try {
+      const song = queue.songs[0];
+      this.debug(`[${queue.id}] Getting stream from: ${song}`);
+      await this.handler.attachStreamInfo(song);
+      const willPlaySong = song.stream.playFromSource ? song : song.stream.song;
+      const stream = willPlaySong?.stream;
+      if (!willPlaySong || !stream?.playFromSource || !stream.url) throw new DisTubeError("NO_STREAM_URL", `${song}`);
+      this.debug(`[${queue.id}] Creating DisTubeStream for: ${willPlaySong}`);
+      const streamOptions = {
+        ffmpeg: {
+          path: this.options.ffmpeg.path,
+          args: {
+            global: { ...queue.ffmpegArgs.global },
+            input: { ...queue.ffmpegArgs.input },
+            output: { ...queue.ffmpegArgs.output, ...queue.filters.ffmpegArgs }
+          }
+        },
+        seek: willPlaySong.duration ? queue._beginTime : void 0
+      };
+      const dtStream = new DisTubeStream(stream.url, streamOptions);
+      dtStream.on("debug", (data) => this.emit("ffmpegDebug" /* FFMPEG_DEBUG */, `[${queue.id}] ${data}`));
+      this.debug(`[${queue.id}] Started playing: ${willPlaySong}`);
+      await queue.voice.play(dtStream);
+      if (emitPlaySong) this.emit("playSong" /* PLAY_SONG */, queue, song);
+    } catch (e) {
+      this.#handlePlayingError(queue, e);
+    }
+  }
+};
 
 // src/DisTube.ts
 import { TypedEmitter as TypedEmitter3 } from "tiny-typed-emitter";
@@ -2180,7 +2144,7 @@ var DisTube = class extends TypedEmitter3 {
     this.queues = new QueueManager(this);
     this.filters = { ...defaultFilters, ...this.options.customFilters };
     this.plugins = [...this.options.plugins];
-    this.plugins.forEach((p) => p.init(this));
+    for (const p of this.plugins) p.init(this);
   }
   static get version() {
     return version;
@@ -2350,8 +2314,8 @@ ${e.message}`;
    * @param guild - The type can be resolved to give a {@link Queue}
    * @returns The new Song will be played
    */
-  skip(guild) {
-    return this.#getQueue(guild).skip();
+  skip(guild, options) {
+    return this.#getQueue(guild).skip(options);
   }
   /**
    * Play the previous song
@@ -2376,8 +2340,8 @@ ${e.message}`;
    * @param num   - The song number to play
    * @returns The new Song will be played
    */
-  jump(guild, num) {
-    return this.#getQueue(guild).jump(num);
+  jump(guild, num, options) {
+    return this.#getQueue(guild).jump(num, options);
   }
   /**
    * Set the repeat mode of the guild queue.
@@ -2434,8 +2398,43 @@ ${e.message}`;
   }
 };
 
-// src/index.ts
-var version = "5.0.7";
+// src/struct/Plugin.ts
+var Plugin = class {
+  static {
+    __name(this, "Plugin");
+  }
+  /**
+   * DisTube
+   */
+  distube;
+  init(distube) {
+    this.distube = distube;
+  }
+};
+
+// src/struct/ExtractorPlugin.ts
+var ExtractorPlugin = class extends Plugin {
+  static {
+    __name(this, "ExtractorPlugin");
+  }
+  type = "extractor" /* EXTRACTOR */;
+};
+
+// src/struct/InfoExtratorPlugin.ts
+var InfoExtractorPlugin = class extends Plugin {
+  static {
+    __name(this, "InfoExtractorPlugin");
+  }
+  type = "info-extractor" /* INFO_EXTRACTOR */;
+};
+
+// src/struct/PlayableExtratorPlugin.ts
+var PlayableExtractorPlugin = class extends Plugin {
+  static {
+    __name(this, "PlayableExtractorPlugin");
+  }
+  type = "playable-extractor" /* PLAYABLE_EXTRACTOR */;
+};
 export {
   BaseManager,
   DisTube,