# jagrosh/MusicBot

🎶 A Discord music bot that's easy to set up and run yourself!

Repository: https://github.com/jagrosh/MusicBot
Canonical: https://ross.abutalabs.com/products/musicbot
Homepage: https://jmusicbot.com
Language: Java
License: Apache-2.0
License Family: permissive
Topics: discord-bot, music, youtube, soundcloud, music-bot, musicbot, playlist, radio, playlists, jda, java, discord
Last push: 2024-11-16T15:22:38+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3671, "days_push": 655, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5755, forks 2834 (observed 2026-08-28T04:09:29.196817+00:00)

## What it is
JMusicBot is a cross-platform Discord music bot written in Java that is easy to set up and run yourself. It plays music from YouTube, SoundCloud, Bandcamp, Vimeo, Twitch, radio streams, and local files with playlist support and DJ role moderation.

## Use cases
- play music in a discord server
- self-host a discord music bot
- stream youtube playlists to a voice channel
- play local mp3 files in discord
- add a dj role to moderate music requests
- run a 24/7 radio bot on discord

## When to choose
- you want a self-hosted discord music bot with minimal setup
- you need playback from youtube, soundcloud, or local files without external API keys
- you want dj-role moderation and playlist support out of the box

## When to avoid
- you need a general-purpose discord bot beyond music
- you want a hosted solution with no server to run it on
- you need a non-Java runtime or deep customization beyond its plugin points

## Facets
- artifact type: application
- maturity: stable
- function: audio-processing, chatbot
- domain: messaging-platforms, media, entertainment, gaming-tools
- platform: cross-platform, jvm
- tags: discord-bot, music-bot, music-playback, youtube, soundcloud, playlists, java, jda, lavaplayer, self-hosted, discord

## Member repositories
- jagrosh/MusicBot (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:29.196817+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:53:16.781288+00:00, confidence not recorded.
  - readme: https://github.com/jagrosh/MusicBot (fetched 2026-08-28T04:09:29.196817+00:00, sha f1ce91311e53)
  - homepage: https://jmusicbot.com (fetched 2026-08-29T08:48:29.189318+00:00, sha 33adadba9e26)
  - site_page: https://jmusicbot.com/installing-java (fetched 2026-08-29T08:48:29.191849+00:00, sha 1a022587ec7d)
- Data as of 2026-08-30T08:39:29.467469+00:00.