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

# Music

> Listen to music within your voice channels.

<Card title="Module: Music" icon="music" horizontal="True">
  Listen to music within your voice channels.
</Card>

## Configuration

### Setting the music channel

You may set a **music only** channel which will restrict the music player commands to your desired text channel.

<Warning>
  It may take up to **15 minutes** for kyos to restrict the commands.
</Warning>

<CodeGroup>
  ```javascript Syntax theme={null}
  ,settings musicchannel (channel)
  ```

  ```javascript Example theme={null}
  ,settings musicchannel #music
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/AalZmPvrgh2Es8UR/images/musicplayer.png?fit=max&auto=format&n=AalZmPvrgh2Es8UR&q=85&s=55f03d2691870dd8d047da539c2e270e" width="342" height="128" data-path="images/musicplayer.png" />
</Frame>

## Queueing Music

You can queue music with the `play` command.

<Tip>
  You may search various sources with the `play` command
</Tip>

<CodeGroup>
  ```javascript Syntax theme={null}
  ,play (query or URL)
  ```

  ```javascript Example theme={null}
  ,play GOLIATH
  OR
  ,play https://open.spotify.com/track/62Z5rlfm5y3VU8Q3QXceLT
  ```
</CodeGroup>

## Song Queueing

### Viewing the tracks in the queue

To view the currently queued songs, execute `queue` with **no query** or song link.

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/AalZmPvrgh2Es8UR/images/queue.png?fit=max&auto=format&n=AalZmPvrgh2Es8UR&q=85&s=f3586b280b6e93b0cb0ad347afc369e6" width="612" height="390" data-path="images/queue.png" />
</Frame>

### Removing a track from the queue

To remove a track from the [music queue](http://kyos.bot/server/music#viewing-the-tracks-in-the-queue), use the `remove` command

<CodeGroup>
  ```javascript Syntax theme={null}
  ,remove (position)
  ```

  ```javascript Example theme={null}
  ,remove 1
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/AalZmPvrgh2Es8UR/images/queue2.png?fit=max&auto=format&n=AalZmPvrgh2Es8UR&q=85&s=bb15e18d1565f1fad4a812f9f6794ee1" width="330" height="130" data-path="images/queue2.png" />
</Frame>

### Moving a track in the queue

To [move](http://localhost:3000/server/music#moving-a-track-in-the-queue) a track in the queue, use the `move` command

<CodeGroup>
  ```javascript Syntax theme={null}
  ,move (position) (new position)
  ```

  ```javascript Example theme={null}
  ,move 2 1
  ```
</CodeGroup>

<br />

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/AalZmPvrgh2Es8UR/images/moveplayer.png?fit=max&auto=format&n=AalZmPvrgh2Es8UR&q=85&s=496c14e31103e6ba5aa033e4f1bc72b9" width="364" height="136" data-path="images/moveplayer.png" />
</Frame>

## Controlling Music Player

To control your music player, use the following commands

<AccordionGroup>
  <Accordion title="Skipping tracks" icon="forward">
    Use the `skip` command to skip to the next track.
  </Accordion>

  <Accordion title="Pausing & Resuming playback" icon="pause">
    Use the `pause` & `resume` commands to control music pausing and resuming.
  </Accordion>

  <Accordion title="Seeking to a specific position" icon="timer">
    Use the `seek` command to seek to a specific position in the track.

    <CodeGroup>
      ```javascript Syntax theme={null}
      ,seek (position)
      ```

      ```javascript Example theme={null}
      ,seek 2:30
      ```

      ```javascript Example #2 theme={null}
      ,seek +30s
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Changing the track volume" icon="volume-high">
    Use the `volume` command to change the volume.

    <Tip>
      The percentage must be between `0` and `100`.
    </Tip>

    <CodeGroup>
      ```javascript Syntax theme={null}
      ,volume (percentage)
      ```

      ```javascript Example theme={null}
      ,volume 50
      ```
    </CodeGroup>
  </Accordion>
</AccordionGroup>
