jagrosh/MusicBot
MusicBot
MusicBot is a self-hosted Discord bot designed for audio playback, enabling server communities to stream music from YouTube, SoundCloud, Bandcamp, Vimeo, Twitch, local files, and online radio stations. It manages per-server audio queues and playback state, isolating audio across different Discord guilds while supporting sequential enqueuing from web playlists and local playlist formats like M3U and PLS.
The bot enforces role-based access control through a configurable DJ role permission system, restricting music moderation commands to designated server members. Its architecture separates command routing, audio decoding via the LavaPlayer engine, and playlist parsing into distinct components, with an OAuth2-based invitation flow that generates scoped invite URLs for authorizing the bot on servers where you have Manage Server permission.
Playback capabilities span multiple sources unified under a single interface, including local audio files in common formats, streaming platform content, and continuous online radio streams. The bot processes both web-based playlists and local playlist files for sequential playback, while the guild-scoped audio manager maintains independent player instances and queue state for each server.
Features
- Discord Audio Streaming Bots - A bot that plays audio from multiple online sources and local files through a Discord voice channel.
- Discord Music Bots - Running a self-hosted Discord music bot with playback from YouTube, SoundCloud, and local files for a server community.
- Playback Queue Managers - A system that organizes and plays songs from web playlists and local playlist files in sequence.
- Sequential Playlist Queueing - Loads and plays both web-based playlists (YouTube, SoundCloud) and local playlist files in sequence.
- Self-Hosted Bot Management - An application designed to be run on your own server infrastructure for full control over the bot instance.
- Audio Playback - Loads and plays audio files in MP3, FLAC, WAV, and other common formats stored on the host machine.
- Guild-Scoped Audio Managers - Maintains per-server audio player instances and queue state, isolating playback across Discord guilds.
- Discord Voice Audio Engines - Decodes and streams audio from multiple sources using a lightweight, event-driven Java library optimized for Discord's voice protocol.
- Multi-Source Audio Playback - Plays audio from YouTube, SoundCloud, Bandcamp, Vimeo, Twitch, local files, and HTTP streams using a unified interface.
- Playlist Queue Managers - Enqueuing and playing web playlists and local playlist files in sequence for continuous music playback.
- Discord Music Bots - An audio playback bot for Discord that streams music from YouTube, SoundCloud, and other sources with queue management.
- Discord Command Listeners - Routes user commands to handler methods through a centralized listener interface that parses arguments and dispatches actions.
- Discord DJ Role Gates - Checks a configurable role assignment before executing moderation commands, delegating access control to Discord's role system.
- Sequential Playlists - Enqueues songs from YouTube playlists, M3U/PLS stream playlists, and local playlist files for sequential playback.
- Internet Radio Streams - Places continuous audio streams from online radio stations and stream playlists (M3U, PLS) into the queue.
- DJ Role Moderation - Restricting music playback commands to users with a designated DJ role for controlled server audio management.
- Discord DJ Role Controllers - A permission system that restricts music moderation commands to users with a designated server role.
- Chat Utilities and Bots - Self-hosted music playback bot for Discord servers.
