Skip to main content
The /music command lets you play music in a voice channel. You must be in a voice channel to use most subcommands. Snowball supports Spotify tracks and albums, Apple Music tracks and albums, SoundCloud links, direct audio file URLs, and uploaded audio files. Music commands are slash-command only — prefix commands are not supported.
Snowball cannot play Spotify or Apple Music playlists, or pre-release tracks. Share individual song or album links instead.

Commands at a glance

SubcommandDescription
/music playSearch for a song or provide a link/file to play
/music nowplayingShow what’s currently playing
/music queueView the current music queue
/music skipSkip the current song
/music pausePause playback
/music resumeResume playback
/music stopStop music and disconnect from the voice channel
/music volumeAdjust the playback volume
/music shuffleShuffle the current queue
/music repeatAdd the current song to play next in the queue
/music timestampSkip to a specific position in the current song

/music play

Searches for a song by name, or plays a link or uploaded audio file. If Snowball is already playing in a different voice channel, it will ask you to confirm before switching.
song
string
A song name to search Spotify, or a direct link from one of the supported sources:
  • Spotify — track URL, album URL, or spotify:track: / spotify:album: URI
  • Apple Music — track or album URL
  • SoundCloud — track URL
  • Direct audio URL — a direct link ending in .mp3, .m4a, .wav, .ogg, .flac, .aac, .opus, or .wma
The song field supports autocomplete: Spotify search results appear as you type.
file
attachment
Upload an audio file directly. Accepted formats: .mp3, .flac, .wav, .ogg, .m4a, .aac, .opus, .wma.
next
boolean
Set to True to add this song to the front of the queue (plays next) instead of the back. Defaults to False.
You must provide either song or file — you cannot use both at the same time.

/music nowplaying

Displays the title, artist, source, and current playback status of the song that’s currently playing. Also shows the next song in the queue if one is queued.

/music queue

Shows the full list of songs in the current queue, including the currently playing track.

/music skip

Skips the current song and plays the next one in the queue.

/music pause

Pauses the current song. Use /music resume to continue.

/music resume

Resumes playback after a pause.

/music stop

Stops all music playback and disconnects Snowball from the voice channel. The queue is cleared.

/music volume

Adjusts the playback volume. You must be in the same voice channel as Snowball to change the volume.
level
integer
required
Volume level from 1 to 100.

/music shuffle

Randomizes the order of songs currently in the queue. The song that is currently playing is not affected.

/music repeat

Adds the currently playing song to the front of the queue so it plays again after the current play-through finishes.

/music timestamp

Seeks to a specific position in the currently playing song. Useful for jumping ahead or replaying a section.
time
string
required
The timestamp to seek to. Accepts formats like 1:30 (minutes:seconds) or 90 (total seconds).