Overview

The Audio Mixer allows you to play secondary audio tracks simultaneously with the main track. This is perfect for:

• Voiceovers & TTS: Announce song names or read chat messages without stopping the music.
• Sound Effects: Play airhorns, applause, or memes over the active track.
• Background Music: Keep a low-volume ambient track running while playing other media.

The mixer works by intercepting the main audio stream and digitally mixing the PCM data from auxiliary sources before encoding. It features intelligent buffering to handle sources that download faster than real-time (like TTS) and automatic clamping to prevent audio distortion.

Endpoints

The mixer exposes a full REST API for managing layers:

• POST /v4/sessions/:sessionId/players/:guildId/mix - Add a new layer
• GET /v4/sessions/:sessionId/players/:guildId/mix - List active layers
• PATCH /v4/sessions/:sessionId/players/:guildId/mix/:mixId - Update layer volume
• DELETE /v4/sessions/:sessionId/players/:guildId/mix/:mixId - Remove a layer

WebSocket Events

Configuration

// config.js
enableLoadStreamEndpoint: true

Query / Body Parameters

Example Request

curl -X GET "http://your-server.com/v4/loadstream?encodedTrack=QAAAAAMAM0hvdyB0byBBZGQgQ2hhcHRlcnMgdG8gWW91ciBWaWRlb3MgVXNpbmcgVGltZXN0YW1wcwAQWW91VHViZSBDcmVhdG9ycwAAAAAAATSYAAtiMUZvX01fdGo2dwABACtodHRwczovL3d3dy55b3V0dWJlLmNvbS93YXRjaD92PWIxRm9fTV90ajZ3AQA2aHR0cHM6Ly9pLnl0aW1nLmNvbS92aV93ZWJwL2IxRm9fTV90ajZ3L3NkZGVmYXVsdC53ZWJwAAAHeW91dHViZQAAAAAAAAAA&position=30000" \
     -H "Authorization: yourPassword" \
     --output track.pcm

Response

How to use

1. Check for available tracks

When you load a track (especially from YouTube), the response includes an audioTracks array inside pluginInfo. This lists all available audio streams for that video.

"pluginInfo": {
    "audioTracks": [
        {
            "id": "en",
            "name": "English (Original)",
            "isDefault": true,
            "isAutoDubbed": false
        },
        {
            "id": "pt-br",
            "name": "Portuguese (Brazil)",
            "isDefault": false,
            "isAutoDubbed": true
        }
    ]
}

2. Select a track

By default, NodeLink plays the default/original audio. To play a different track (e.g., Portuguese dub), pass the audioTrackId in the track object when updating the player.

curl -X PATCH "http://your-server.com/v4/sessions/{sessionId}/players/{guildId}" \
     -H "Authorization: yourPassword" \
     -H "Content-Type: application/json" \
     -d '{
       "track": {
         "encoded": "...",
         "audioTrackId": "pt-br"
       }
     }'

Use Cases

• Multi-language Videos: Allow users to switch between original audio and dubbed versions.
• Descriptive Audio: Select audio tracks with descriptive commentary for accessibility.

How to use

1. Check for available tracks

When you load a track (especially from YouTube), the response includes an audioTracks array inside pluginInfo. This lists all available audio streams for that video.

To see this information, you must load the track using loadTracks.

"pluginInfo": {
    "audioTracks": [
        {
            "id": "en",
            "name": "English (Original)",
            "isDefault": true,
            "isAutoDubbed": false
        },
        {
            "id": "pt-br",
            "name": "Portuguese (Brazil)",
            "isDefault": false,
            "isAutoDubbed": true
        }
    ]
}

2. Select a track

By default, NodeLink plays the default/original audio. To play a different track (e.g., Portuguese dub), pass the audioTrackId in the track object when updating the player.

curl -X PATCH "http://your-server.com/v4/sessions/{sessionId}/players/{guildId}" \
     -H "Authorization: yourPassword" \
     -H "Content-Type: application/json" \
     -d '{
       "track": {
         "encoded": "...",
         "audioTrackId": "pt-br"
       }
     }'

Use Cases

• Multi-language Videos: Allow users to switch between original audio and dubbed versions.
• Descriptive Audio: Select audio tracks with descriptive commentary for accessibility.

Body

Example Request

curl -X PATCH "http://your-server.com/v4/youtube/config" \
     -H "Authorization: yourPassword" \
     -H "Content-Type: application/json" \
     -d '{
       "refreshToken": "1//0gN...",
       "visitorData": "Cgt..."
     }'

Response

Query Parameters

Response

Methods Supported

Body (POST)

Query Parameters (GET)

Example Request (POST)

curl -X POST "http://your-server.com/v4/youtube/oauth" \
     -H "Authorization: yourPassword" \
     -H "Content-Type: application/json" \
     -d '{"refreshToken": "..."}'

Example Request (GET)

curl -X GET "http://your-server.com/v4/youtube/oauth?refreshToken=..." \
     -H "Authorization: yourPassword"

Response