> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremewx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Snowball /music Commands: Play, Queue, and Control

> Complete reference for all /music subcommands in Snowball — play options, queue management, volume, timestamps, and supported sources and formats.

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.

<Note>
  Snowball cannot play Spotify or Apple Music playlists, or pre-release tracks. Share individual song or album links instead.
</Note>

## Commands at a glance

| Subcommand          | Description                                      |
| ------------------- | ------------------------------------------------ |
| `/music play`       | Search for a song or provide a link/file to play |
| `/music nowplaying` | Show what's currently playing                    |
| `/music queue`      | View the current music queue                     |
| `/music skip`       | Skip the current song                            |
| `/music pause`      | Pause playback                                   |
| `/music resume`     | Resume playback                                  |
| `/music stop`       | Stop music and disconnect from the voice channel |
| `/music volume`     | Adjust the playback volume                       |
| `/music shuffle`    | Shuffle the current queue                        |
| `/music repeat`     | Add the current song to play next in the queue   |
| `/music timestamp`  | Skip 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.

<ParamField path="song" type="string" optional>
  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.
</ParamField>

<ParamField path="file" type="attachment" optional>
  Upload an audio file directly. Accepted formats: `.mp3`, `.flac`, `.wav`, `.ogg`, `.m4a`, `.aac`, `.opus`, `.wma`.
</ParamField>

<ParamField path="next" type="boolean" optional>
  Set to `True` to add this song to the front of the queue (plays next) instead of the back. Defaults to `False`.
</ParamField>

<Note>
  You must provide either `song` or `file` — you cannot use both at the same time.
</Note>

***

## `/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.

<ParamField path="level" type="integer" required>
  Volume level from 1 to 100.
</ParamField>

***

## `/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.

<ParamField path="time" type="string" required>
  The timestamp to seek to. Accepts formats like `1:30` (minutes:seconds) or `90` (total seconds).
</ParamField>