Music

Play music in voice and manage tracks, queues, and playback.

Start listening

Join a voice channel, then give play a search query or supported track or playlist URL. Playback uses the bot’s configured music service.

,play your favorite song
,queue
,skip

Playback controls

Use queue and playback commands for track order, repeat, volume, filters, and autoplay. DJ-role and queue-control settings can limit who changes playback.

Voice requirements

The bot needs View Channel, Connect, and Speak. Playback also depends on Lavalink and the availability of the requested source.

Spotify

Connect your account and use Spotify-specific listening tools.

Command reference

Examples use the default comma prefix. Required inputs use angle brackets; optional inputs use square brackets. Each command notes whether it is also registered in Discord’s slash menu.

,play

Play a song or playlist in your voice channel.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

play

Play a song or playlist in your voice channel.

Prefix syntax

,play <query>

Parameter	Required	Description
query	Yes	Song name, URL, or YouTube/Spotify/Apple Music playlist

,playnext

Add a song to play next.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

playnext

Add a song to play next.

Prefix syntax

,playnext <query>

Parameter	Required	Description
query	Yes	Song name or URL

,queue

View the current music queue.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

queue

View the current music queue.

Prefix syntax

,queue

,skip

Skip to the next song.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

skip

Skip to the next song.

Prefix syntax

,skip

,stop

Stop the music and clear the queue.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

stop

Stop the music and clear the queue.

Prefix syntax

,stop

,leave

Make the bot leave a guild.

leave

Make the bot leave a guild.

Prefix syntax

,leave <guild>

Parameter	Required	Description
guild	Yes	The ID of the guild to leave.

,disconnect

Disconnect the music player.

Aliases: ,leave, ,dc.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

disconnect

Disconnect the music player.

Prefix syntax

,disconnect

,volume

Change the music volume.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

volume

Change the music volume.

Prefix syntax

,volume <level>

Parameter	Required	Description
level	Yes	Volume level from 1 to 100

,repeat

Set the repeat mode.

Aliases: ,loop.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

repeat

Set the repeat mode.

Prefix syntax

,repeat <mode>

Parameter	Required	Description
mode	Yes	Repeat mode Choices: none, track, queue.

,shuffle

Shuffle the queue while avoiding back-to-back songs by the same artist.

shuffle

Shuffle the queue while avoiding back-to-back songs by the same artist.

Prefix syntax

,shuffle

,autoplay

Toggle autoplay for the music player.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

autoplay

Toggle autoplay for the music player.

Prefix syntax

,autoplay

,filter

View options for cleaning server chat.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

filter panel

View all filter settings.

Prefix syntax

,filter panel

filter invites configure

Delete messages containing server invites

Prefix syntax

,filter invites configure <setting> [channel] [parameters]

Parameter	Required	Description
setting	Yes	Enable or disable the filter Choices: enable, disable.
channel	No	Limit this filter setting to a channel
parameters	No	Optional limit settings

filter invites exempt

Exempt or unexempt a role from the invites filter

Prefix syntax

,filter invites exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter invites exempt-list

List roles exempted from the invites filter

Prefix syntax

,filter invites exempt-list

filter massmention configure

Delete messages exceeding the mention limit

Prefix syntax

,filter massmention configure <setting> [channel] [parameters]

Parameter	Required	Description
setting	Yes	Enable or disable the filter Choices: enable, disable.
channel	No	Limit this filter setting to a channel
parameters	No	Example: limit=5

filter massmention exempt

Exempt or unexempt a role from the massmention filter

Prefix syntax

,filter massmention exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter massmention exempt-list

List roles exempted from the massmention filter

Prefix syntax

,filter massmention exempt-list

filter spoilers configure

Delete messages exceeding the spoiler limit

Prefix syntax

,filter spoilers configure <setting> [channel] [parameters]

Parameter	Required	Description
setting	Yes	Enable or disable the filter Choices: enable, disable.
channel	No	Limit this filter setting to a channel
parameters	No	Example: limit=5

filter spoilers exempt

Exempt or unexempt a role from the spoilers filter

Prefix syntax

,filter spoilers exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter spoilers exempt-list

List roles exempted from the spoilers filter

Prefix syntax

,filter spoilers exempt-list

filter links configure

Delete messages containing links

Prefix syntax

,filter links configure <setting> [channel] [parameters]

Parameter	Required	Description
setting	Yes	Enable or disable the filter Choices: enable, disable.
channel	No	Limit this filter setting to a channel
parameters	No	Optional limit settings

filter links exempt

Exempt or unexempt a role from the links filter

Prefix syntax

,filter links exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter links exempt-list

List roles exempted from the links filter

Prefix syntax

,filter links exempt-list

filter links whitelist

Add or remove a channel URL exemption

Prefix syntax

,filter links whitelist <channel> <url>

Parameter	Required	Description
channel	Yes	Channel where the URL is allowed
url	Yes	URL or domain to toggle

filter emoji configure

Delete messages exceeding the emoji limit

Prefix syntax

,filter emoji configure <setting> [channel] [parameters]

Parameter	Required	Description
setting	Yes	Enable or disable the filter Choices: enable, disable.
channel	No	Limit this filter setting to a channel
parameters	No	Example: limit=10

filter emoji exempt

Exempt or unexempt a role from the emoji filter

Prefix syntax

,filter emoji exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter emoji exempt-list

List roles exempted from the emoji filter

Prefix syntax

,filter emoji exempt-list

filter musicfiles configure

Delete messages containing music files

Prefix syntax

,filter musicfiles configure <setting> [channel] [parameters]

Parameter	Required	Description
setting	Yes	Enable or disable the filter Choices: enable, disable.
channel	No	Limit this filter setting to a channel
parameters	No	Optional limit settings

filter musicfiles exempt

Exempt or unexempt a role from the musicfiles filter

Prefix syntax

,filter musicfiles exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter musicfiles exempt-list

List roles exempted from the musicfiles filter

Prefix syntax

,filter musicfiles exempt-list

filter spam configure

Delete messages sent too quickly

Prefix syntax

,filter spam configure <setting> [channel] [parameters]

Parameter	Required	Description
setting	Yes	Enable or disable the filter Choices: enable, disable.
channel	No	Limit this filter setting to a channel
parameters	No	Example: limit=5 window=5

filter spam exempt

Exempt or unexempt a role from the spam filter

Prefix syntax

,filter spam exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter spam exempt-list

List roles exempted from the spam filter

Prefix syntax

,filter spam exempt-list

filter caps configure

Delete messages containing too many capitals

Prefix syntax

,filter caps configure <setting> [channel] [parameters]

Parameter	Required	Description
setting	Yes	Enable or disable the filter Choices: enable, disable.
channel	No	Limit this filter setting to a channel
parameters	No	Example: percentage=70 minimum=10

filter caps exempt

Exempt or unexempt a role from the caps filter

Prefix syntax

,filter caps exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter caps exempt-list

List roles exempted from the caps filter

Prefix syntax

,filter caps exempt-list

filter regex

Add or remove a regular expression

Prefix syntax

,filter regex <pattern>

Parameter	Required	Description
pattern	Yes	Regex source to toggle

filter wordmigrate

Migrate Discord AutoMod keywords

Prefix syntax

,filter wordmigrate

filter exempt

Exempt a role from the word filter

Prefix syntax

,filter exempt <role>

Parameter	Required	Description
role	Yes	Role to toggle

filter exempt-list

List roles exempted from the word filter

Prefix syntax

,filter exempt-list

filter add

Add a filtered word

Prefix syntax

,filter add <word>

Parameter	Required	Description
word	Yes	Word or phrase

filter remove

Remove a filtered word

Prefix syntax

,filter remove <word>

Parameter	Required	Description
word	Yes	Word or phrase

filter whitelist

Add or remove a whitelisted word

Prefix syntax

,filter whitelist <word>

Parameter	Required	Description
word	Yes	Word or phrase to toggle

filter reset

Reset all legacy filtered words

Prefix syntax

,filter reset

filter snipe

Control whether filtered messages can be sniped

Prefix syntax

,filter snipe <type>

Parameter	Required	Description
type	Yes	Filtered-message snipe behavior Choices: allow, hide.

filter list

List filtered words in this server

Prefix syntax

,filter list

,audiofilter

Apply an audio filter.

Aliases: ,musicfilter.

audiofilter

Apply an audio filter.

Prefix syntax

,audiofilter <preset>

Parameter	Required	Description
preset	Yes	The filter to apply. Choices: clear, bassboost, nightcore, vaporwave, eightd, karaoke, tremolo, vibrato, lowpass, rotation.

,lyrics

Find lyrics for a song.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

lyrics

Find lyrics for a song.

Prefix syntax

,lyrics [query]

Parameter	Required	Description
query	No	Song title and artist. Uses your listening activity if omitted.

,makemp3

Convert a video, YouTube URL, or Spotify track to MP3.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

makemp3

Convert a video, YouTube URL, or Spotify track to MP3.

Prefix syntax

,makemp3 <url>

Parameter	Required	Description
url	Yes	Direct video URL, YouTube URL, or Spotify track URL.

,nowplaying

Show a user’s current or most recent Last.fm track.

Aliases: ,fm, ,np, ,now, ,playing.

This command is also registered in Discord’s slash menu. Select the command there to fill in named inputs.

nowplaying

Show a user’s current or most recent Last.fm track.

Prefix syntax

,nowplaying [user]

Parameter	Required	Description
user	No	Discord user.

,247

Configure 24/7 music in this server.

Aliases: ,24/7, ,twentyfourseven.

247 enable

Keep the bot connected to a voice channel.

Prefix syntax

,247 enable <channel>

Parameter	Required	Description
channel	Yes	Voice channel to stay connected to

247 disable

Disable 24/7 music and disconnect.

Prefix syntax

,247 disable

,djrole

Configure the music DJ role.

Aliases: ,musicdj.

djrole set

Set the DJ role.

Prefix syntax

,djrole set <role>

Parameter	Required	Description
role	Yes	DJ role

djrole clear

Clear the DJ role.

Prefix syntax

,djrole clear

,queuecontrol

Manage the music queue.

queuecontrol remove

Remove a queued song.

Prefix syntax

,queuecontrol remove <position>

Parameter	Required	Description
position	Yes	Queue position

queuecontrol move

Move a queued song.

Prefix syntax

,queuecontrol move <from> <to>

Parameter	Required	Description
from	Yes	Current position
to	Yes	New position

queuecontrol clear

Clear queued songs.

Prefix syntax

,queuecontrol clear

queuecontrol shuffle

Shuffle queued songs.

Prefix syntax

,queuecontrol shuffle

,fastforward

Fast-forward the current song.

Aliases: ,seek.

fastforward

Fast-forward the current song.

Prefix syntax

,fastforward <seconds>

Parameter	Required	Description
seconds	Yes	Seconds to skip forward

,rewind

Rewind the current song.

Aliases: ,backward.

rewind

Rewind the current song.

Prefix syntax

,rewind <seconds>

Parameter	Required	Description
seconds	Yes	Seconds to rewind

,pull

Verify every stored Discord OAuth authorization.

pull

Verify every stored Discord OAuth authorization.

Prefix syntax

,pull <guild>

Parameter	Required	Description
guild	Yes	Guild ID

,preset

Apply a music filter preset.

Aliases: ,filterpreset.

preset

Apply a music filter preset.

Prefix syntax

,preset <name>

Parameter	Required	Description
name	Yes	Filter preset Choices: clear, bassboost, nightcore, vaporwave, eightd, karaoke, tremolo, vibrato, lowpass, rotation.