Music
Play music in voice channels with queue management and playback controls.
Zagreus can play music in voice channels from YouTube and Spotify. The music system includes a per-server queue, playback controls, and auto-disconnect on inactivity.
Music is disabled by default. The server owner must set MUSIC_ENABLED=true in the bot configuration to enable it.
Commands
| Command | Description |
|---|---|
/music play <query> | Play a song or add it to the queue (YouTube URL, Spotify URL, or search query) |
/music skip | Skip the current track |
/music stop | Stop playback and clear the queue |
/music pause | Pause the current track |
/music resume | Resume paused playback |
/music queue | View the current queue (now playing + next 10 tracks) |
/music nowplaying | Show details of the currently playing track |
/music disconnect | Disconnect the bot from voice |
How It Works
Join a voice channel
You must be in a voice channel before using any music command.
Play a track
Use /music play with a YouTube URL, Spotify URL, or search query. The bot joins your channel and starts playing.
Manage the queue
Tracks are queued in order. Use /music skip to advance, /music queue to see what's coming, or /music stop to clear everything.
Bot auto-disconnects
The bot automatically leaves the voice channel when the queue is empty or when everyone else leaves.
Supported Sources
- YouTube — direct video URLs and search queries
- Spotify — track and playlist URLs (resolved to YouTube for playback)
Behavior
- One active queue per server
- Bot follows the user who started playback into their voice channel
- Queue shows "...and X more" when there are more than 10 tracks
/music nowplayingshows the track title, duration, and who requested it