# Apply Audio Filter

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

The Apply Audio Filter action applies an audio filter to the current music player.

<div data-full-width="false"><figure><img src="/files/E1JN9UcS6SHNwkQjEbia" alt="" width="375"><figcaption></figcaption></figure></div>

## Server

This setting selects which server the action applies to. You have two options to choose from:

{% tabs %}
{% tab title="Current Server" %}

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

When you select the 'Current Server' option, the audio will be applied to the player in the current server.
{% endtab %}

{% tab title="Server ID" %}

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

When you select the Server ID option, the audio filter will be applied to the provided server ID's player.

### Server ID

In this field, you can enter the ID of the server where you want the audio filter to be applied to. Variables can be used in this field.
{% endtab %}
{% endtabs %}

## Filter Type

In this field, you can select the type of audio filter to apply to the specified player.

{% tabs %}
{% tab title="Filters" %}

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

When you select one of the default filters, the specified filter will be applied to the player. The available filters are:

| Filter Type  | Filter Description                           |
| ------------ | -------------------------------------------- |
| Bass Boost   | Enhances low frequencies for deeper bass     |
| Nightcore    | Faster and higher pitched audio              |
| Vaporwave    | Slower and lower pitched audio (chill vibes) |
| 8D Audio     | Creates spatial/surround sound effect        |
| Tremolo      | Volume oscillation (wobble effect)           |
| Vibrato      | Pitch oscillation (warble effect)            |
| Karaoke      | Attempts to remove vocals from track         |
| Treble Boost | Enhances high frequencies                    |
| Chipmunk     | Very high pitched (Alvin and the Chipmunks)  |
| Daycore      | Opposite of nightcore (slower & lower)       |

### Intensity

In this field, you can choose the intensity level of the filter. This supports low, medium or high.
{% endtab %}

{% tab title="Custom Pitch" %}

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

When you select Custom Pitch, you are able to specify a custom pitch (how high or low the song sounds) for the music player.

### Pitch Value

This field allows you to specify a custom pitch for the music player. A value of 1.0 is normal, a higher value would equal a higher pitch, and a lower value would equal a lower pitch. Variables can be used in this field.
{% endtab %}

{% tab title="Custom Speed" %}

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

When you select Custom Speed, you are able to specify a custom speed for the music player.

### Pitch Value

This field allows you to specify a custom speed for the music player. A value of 1.0 is normal, a higher value play faster, and a lower value would play slower. Variables can be used in this field.
{% endtab %}

{% tab title="Custom Equalizer" %}

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

Custom Equalizer is an advanced feature that allows you to select a custom band and gain for your music player.

### Custom Equalizer Bands

In this field, you can enter a JSON array of band objects. There are 15 bands (0-14), and each band can be adjusted with the gain value. Valid values for gain range from -0.25 to 1.0, where -0.25 means the given band is completely muted, and 0.25 means the band is doubled. This can change the volume of the output.

{% hint style="info" %}
You can see more information on the custom equalizer feature [on LavaLink's docs](https://lavalink.dev/api/rest#equalizer).
{% endhint %}
{% endtab %}

{% tab title="Reset/Clear All" %}

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

Reset / Clear All will clear all filters from the specified player.
{% endtab %}
{% endtabs %}


---

# 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/custom-commands-and-events/actions/music-actions/apply-audio-filter.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.