# Music

<figure><img src="/files/l49loSiI5VvK9a4hWwjU" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
This module requires a [Premium Subscription](/premium/premium-and-priority-hosting-plans.md#premium-plans) to function.
{% endhint %}

{% hint style="info" %}
If you are looking for instructions on how to use the Music Blocks, please see [Music Actions](/custom-commands-and-events/actions/music-actions.md).
{% endhint %}

The [Music](https://dashboard.botghost.com/dashboard/music) module gives you access to pre-built commands for the music blocks, allowing your bot to play music in your Discord server!

## Commands

In this area, you can view and modify the commands of the Music module. Below you may find some information on each command of the module.

<figure><img src="/files/tXDqMVXQhtbDZWMu8z8T" alt="" width="375"><figcaption></figcaption></figure>

<details>

<summary>/music seek</summary>

This command allows you to go to (or "seek" to) a specific time in the current song that is playing.

</details>

<details>

<summary>/music pause</summary>

This command will pause the currently playing song. Use `/music resume` to resume playing the song.

</details>

<details>

<summary>/music queue</summary>

This command will return every song that is currently in the music queue and information about the currently playing song.

</details>

<details>

<summary>/music clear-filters</summary>

This command will clear all filters added with the `/music apply-filter` command.

</details>

<details>

<summary>/music track</summary>

This command returns information about the song that is currently playing, including the title, artist, progress and album art.

</details>

<details>

<summary>/music play</summary>

Plays a song in the voice channel you or the bot is currently in. Accepts song titles, URLs, or playlist URLs.

</details>

<details>

<summary>/music stop</summary>

Stops playing music and clears the queue.

</details>

<details>

<summary>/music replay</summary>

Replays the current song from the beginning.

</details>

<details>

<summary>/music disconnect</summary>

Disconnects the bot from the voice channel and resets the queue, filters, and settings.

</details>

<details>

<summary>/music resume</summary>

Resumes playback of music paused with `/music pause`.

</details>

<details>

<summary>/music set-autoleave</summary>

Configure whether to automatically disconnect the bot from the voice channel when the queue ends.

</details>

<details>

<summary>/music set-autoplay</summary>

Configure whether to automatically queue similar songs when the queue ends.

</details>

<details>

<summary>/music apply-filter</summary>

Apply various sound filters to the music playback. Use `/music clear-filters` to clear them.

</details>

<details>

<summary>/music skip</summary>

Skips the currently playing song.

</details>

<details>

<summary>/music remove</summary>

Remove a specific song from the queue based on queue position.

</details>

<details>

<summary>/music shuffle</summary>

Shuffles the music queue.

</details>

<details>

<summary>/music set-volume</summary>

Sets the volume of the music (0-200).

</details>

<details>

<summary>/music loop</summary>

Choose whether to loop the currently playing track or queue.

</details>

## Events

The music module is also provided with two events:

<figure><img src="/files/tKN6oHJPX8BVTahMYO56" alt=""><figcaption></figcaption></figure>

<details>

<summary>Set voice channel status to song data</summary>

This event will set the voice channel status to information about the currently playing song when a song starts plating

</details>

<details>

<summary>Remove voice status song data</summary>

This event will remove the status set by `Set voice channel status to song data` when a song finishes playing.

</details>

***

{% hint style="danger" %}
It's advised that you do not edit the commands and events unless you have a good understanding of BotGhost and its Command Builder. If you encounter any issues, you might want to reset the module for it to work again as intented.

Additionally, a copy of the edited commands / events will be created if you update the module.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.botghost.com/fun-modules/music.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.