Serufuhosuto-music-bot

セルフホスト (Self Hosted) Music Bot 🎵

A minimal, high-quality Discord music streaming bot — built for real-time, self-hosted control with near zero bloat.

View the Source »

---

About The Project

セルフホスト (Self Hosted) Music Bot is a modern, sleek Java-based Discord bot built for high-quality music streaming using yt-dlp and ffmpeg. Built to solve the problem of overcomplicated and unreliable self-hosted discord music bots.

✅ No tracking
✅ No third-party APIs
✅ Easy to fix when it inevitably breaks.

---

⚙️ Built With

• ☕ Java 21
• 🎧 JDA 5
• 🧪 yt-dlp
• 🛠 FFmpeg
• 📦 Maven + Shade Plugin

---

Prerequisites

• Java 17+
• ffmpeg installed (in your system path)
• yt-dlp installed and accessible

# Example setup (Windows / Linux)
choco install ffmpeg -y     # or brew install ffmpeg
pip install yt-dlp

---

Installation

⬇️ Download the latest .jar file:

👉 Serufuhosuto-music-bot.jar 📁 In the same folder where the Java executable is run, create a config.json:

{
    "token": "YOUR_DISCORD_BOT_TOKEN",
    "prefix": ".",
    "ffmpegPath": "ffmpeg",
    "ytQuality": "bestaudio[ext=m4a]"
}

Run the bot:

java -jar Serufuhosuto-music-bot-1.0.jar

---

Building from Source

If you want to modify:

git clone https://github.com/JakeTurner616/Serufuhosuto-music-bot.git
cd Serufuhosuto-music-bot
mvn clean package

The final JAR will be in the target/ folder.

---

🎮 Usage

🎧 .play <url>    – stream or queue YouTube audio
⏭ .skip          – skip the current track
⏩ .seek <sec>    – jump to a time in the current track
🧹 .clear         – clear the queue
🛑 .stop          – stop all playback
👋 .leave         – disconnect the bot

---

📜 License

Distributed under the GNU GPL v3.0 License. See the LICENSE file for more information.

---