> For the complete documentation index, see [llms.txt](https://docs.iynxdev.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iynxdev.com/configuration-files/music.md).

# Music

## <mark style="color:blue;">Introduction</mark>

The Music configuration file (`music.json`) controls Lavalink node connections, default playback settings, channel restrictions, and autoplay features.

***

## <mark style="color:blue;">Lavalink Nodes</mark>

**Type:** Array of Objects

Configure Lavalink servers for music playback.

```json
lavalink_nodes: [
    {
        name: 'Iynx',
        url: '127.0.0.1:2333',
        auth: 'youshallnotpass',
        secure: false,
    },
]
```

**name** - Descriptive name for the node\
**url** - Server address in format `ip:port`\
**auth** - Lavalink server password\
**secure** - Whether to use secure connection (true/false)

You can add multiple nodes and the bot will automatically select the one with the lowest traffic for optimal performance.

{% hint style="warning" %}
**Lavalink Addon Users:** If you have the Lavalink premium addon, this configuration is automatically overridden by the addon's servers.
{% endhint %}

***

## <mark style="color:blue;">Default Volume</mark>

**Type:** Number

Starting volume level for new music sessions.

```json
default_volume: 60
```

**Valid range:** 1 to 1000

This is the volume level used when the bot first starts playing music. Users can adjust it afterward using music commands.

***

## <mark style="color:blue;">Whitelist Channels</mark>

Restrict music commands to specific channels.

### <mark style="color:yellow;">enabled</mark>

**Type:** Boolean

Whether to enable channel restrictions.

```json
whitelist_channels: {
    enabled: false,
}
```

**When `true`:** Music commands only work in configured channels\
**When `false`:** Music commands work everywhere

***

### <mark style="color:yellow;">channels</mark>

**Type:** Array of Strings

List of channel IDs where music commands are allowed.

```json
channels: ["804354119523500082", "947577986939514881"]
```

Only applies when `enabled` is set to `true`.

***

## <mark style="color:blue;">Use Own Lavalink</mark>

**Type:** Boolean

Override addon Lavalink servers with your own configuration.

```json
use_own_lavalink: false
```

**When `true`:** Uses your configured Lavalink nodes even if you own the addon\
**When `false`:** Uses premium addon Lavalink servers (if you have the addon)

This option only matters if you have purchased the Lavalink addon.

***

## <mark style="color:blue;">Autoplay Enabled by Default</mark>

**Type:** Boolean

Automatically add similar songs to the queue.

```json
autoplay_enabled_by_default: false
```

**When `true`:** After the first song plays, the bot automatically adds similar tracks based on metadata\
**When `false`:** Bot only plays queued songs

***

## <mark style="color:blue;">Complete Configuration Example</mark>

Here's a production-ready music configuration:

```json
{
    config: {
        lavalink_nodes: [
            {
                name: 'Primary Node',
                url: '127.0.0.1:2333',
                auth: 'yourpassword',
                secure: false,
            },
            {
                name: 'Backup Node',
                url: '192.168.1.100:2333',
                auth: 'yourpassword',
                secure: false,
            },
        ],

        default_volume: 60,

        whitelist_channels: {
            enabled: true,
            channels: ["804354119523500082", "947577986939514881"],
        },

        use_own_lavalink: false,

        autoplay_enabled_by_default: false,
    }
}
```