Repo brief: jagrosh/MusicBot

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T16:01:30.527Z · commit 859e5c5862de

Verdict

Mixed — Stale — last commit 2y ago

• 14 active contributors
• Apache-2.0 licensed
• CI configured
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against OpenSSF Scorecard

What it is

JMusicBot is a self-hosted Discord music bot written in Java that plays audio from YouTube, SoundCloud, Bandcamp, Twitch, and local files directly in Discord voice channels. It uses the JDA Discord API library and Lavaplayer audio framework to provide fast song loading, queue management, and server-specific DJ role controls without requiring external API keys beyond a Discord token. Monolithic single-module Maven Java project with a clear command pattern architecture: src/main/java/com/jagrosh/jmusicbot/ contains the core Bot.java and BotConfig, while commands are organized into admin/, dj/, music/, owner/, and general/ subdirectories under src/main/java/com/jagrosh/jmusicbot/commands.…

Start here

Open these first:

• src/main/java/com/jagrosh/jmusicbot/JMusicBot.java — Main application entry point that initializes the Discord bot and loads configuration.
• src/main/java/com/jagrosh/jmusicbot/BotConfig.java — Manages bot configuration loading from environment and files, critical for startup.
• src/main/java/com/jagrosh/jmusicbot/audio/PlayerManager.java — Core audio playback manager handling track loading and queue management via LavaLink.
• src/main/java/com/jagrosh/jmusicbot/audio/AudioHandler.java — Manages audio output and queuing logic for Discord voice channels.
• src/main/java/com/jagrosh/jmusicbot/commands/MusicCommand.java — Base class for all music commands with permission and context validation.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone the repository with git clone https://github.com/jagrosh/MusicBot.git && cd MusicBot. Install dependencies and build with mvn clean install (Maven is the package manager, as evidenced by pom.xml). Verify the p…

Daily commands:

Maven builds the JAR (inferred from pom.xml with <packaging>jar</packaging>). Run with java -jar target/JMusicBot-Snapshot.jar after mvn clean package. The bot requires a Discord bot token in configuration (manage…

…shortened for this brief.

Key cautions & unknowns

• Stale — last commit 2y ago
• Concentrated ownership — top contributor handles 61% of recent commits
• Scorecard: marked unmaintained (0/10)
• Discord bot token must be provided in configuration before startup (BotConfig.java handles this, but exact environment variable name is not visible in provided data). Lavaplayer requires native audio libraries on the…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.