JUGNU MUSIC — Discord Music Bot 🎵

High‑quality Discord music bot powered by DisTube and discord.js v14 — YouTube, Spotify, SoundCloud, filters, autoplay, 24/7, request channel, lyrics, and more.

Features

• YouTube, Spotify, and SoundCloud playback
• Slash commands and message commands
• 24/7 voice channel + autoresume
• Rich queue controls: skip, seek, loop, shuffle, move, remove, jump, filters
• Lyrics lookup, request channel system, DJ role
• Works on Replit/VPS, uses DisTube + discord.js v14

---

Installation

1. Install latest LTS Node.js (>= 18.17) and Python.

2. Clone or download the repository.

3. Install dependencies:

npm install

4. Configure the bot in settings/config.js and .env.

Modify - config.js

{
  TOKEN: "BOT_TOKEN",
  PREFIX: "BOT_PREFIX",
  mongodb : "MONGO_URL"
}

Modify - .env

Rename .env.example to .env and configure the following keys:

# Discord
TOKEN=
PREFIX=

# Database (optional if using JSON storage)
MONGO_URL=

# Slash commands
# Comma-separated list of guild IDs (for faster, per-guild registration)
GUILD_ID=
# Set to true to register commands globally (may take up to 1 hour to propagate)
SLASH_GLOBAL=false

# Web server
PORT=3000

# Reduce noisy update checks from ytsr/ytdl
YTSR_NO_UPDATE=true
YTDL_NO_UPDATE=true

# Voice diagnostics (optional; set true to print a dependency report on startup)
VOICE_DEBUG_REPORT=false

Notes:

• If you want global slash commands, set SLASH_GLOBAL=true. Otherwise, keep GUILD_ID set (you can provide multiple IDs separated by commas) for instant per‑guild updates.
• MONGO_URL enables MongoDB storage via JoshDB’s Mongo provider; if omitted, JSON storage is used.

5. Optional native optimizations (Windows/macOS/Linux):

npm install @discordjs/opus zlib-sync@latest erlpack@latest

6. Start the bot:

npm start

Dev mode with auto-reload:

npm run dev

Dashboard

Dashboard setup guide

Feedback & Support

If you have any feedback or need assistance, please join our Discord Server.

Contributing

Contributions are welcome! Please open an issue or PR. For larger changes, start a discussion first.

Security

Please report vulnerabilities privately via GitHub Security Advisories or email.

License

This project is licensed under the MIT License.

Thanks for using JUGNU MUSIC! If this helps you, please ⭐ the repo and consider a fork.

Your support is appreciated! 🌟