GitHunt
SK

skick1234/DisTube

A comprehensive Discord music bot library built for Discord.js, offering simplified music commands, effortless playback from diverse sources, and integrated audio filters.

GitHub Workflow Status node-current npm peer dependency version Codecov branch
npm GitHub Repo stars Discord

Buy Me a Coffee at ko-fi.com

DisTube

DisTube is a comprehensive Discord music bot library built for Discord.js, offering simplified music commands, effortless playback from diverse sources, and integrated audio filters.

๐ŸŒŸ Key Features

  • Easy Integration: Built on top of discord.js v14 and @discordjs/voice.
  • Voice Management: Robust handling of voice connections and queue management.
  • Audio Filters: Built-in filters (bassboost, echo, karaoke, etc.) and custom filter support.
  • Plugin System: Extensible architecture supporting YouTube, Spotify, SoundCloud, and 700+ other sites.
  • Type Safety: Written in TypeScript for a superior development experience.

๐Ÿ“š Resources

Resource Description
Ask DeepWiki Learn DisTube with AI-powered assistance.
Installation Detailed requirements and setup guide.
API Reference Complete technical documentation.
Discord Support Join our community for help and discussion.

๐Ÿš€ Quick Start

npm install distube @discordjs/voice @discordjs/opus
const { DisTube } = require('distube');
const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildVoiceStates,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

const distube = new DisTube(client, {
  emitNewSongOnly: true,
});

distube.on('playSong', (queue, song) =>
  queue.textChannel.send(`Playing \`${song.name}\` - \`${song.formatDuration()}\``)
);

client.on('messageCreate', message => {
  if (message.content.startsWith('!play')) {
    distube.play(message.member.voice.channel, message.content.slice(6), {
      message,
      textChannel: message.channel,
      member: message.member,
    });
  }
});

client.login('TOKEN');

๐Ÿค Contributing

Contributions are welcome! Please read our Contributing Guidelines before submitting a pull request.

๐Ÿ“„ License

Licensed under MIT License


Support me on Ko-fi

Languages

TypeScript100.0%

Contributors

MIT License
Created July 8, 2020
Updated February 9, 2026
skick1234/DisTube | GitHunt