Voice Prerequisites

This page covers what you need before using DisCatSharp.Voice.

1. Install the Voice Package

<PackageReference Include="DisCatSharp.Voice" Version="10.7.1" />

For normal NuGet usage, DisCatSharp.Voice.Natives is included automatically.

If you run from source or manually manage runtime assets, add:

<PackageReference Include="DisCatSharp.Voice.Natives" Version="10.7.1">
  <IncludeAssets>runtime; native; contentfiles</IncludeAssets>
</PackageReference>

2. Enable Required Gateway Intent

Voice connect and movement events require GuildVoiceStates.

var client = new DiscordClient(new DiscordConfiguration
{
    Token = "...",
    TokenType = TokenType.Bot,
    Intents = DiscordIntents.AllUnprivileged | DiscordIntents.GuildVoiceStates
});

3. Native Dependencies by Platform

DisCatSharp.Voice relies on native libraries (libopus, libsodium, and for DAVE, libdave).

Windows

Using NuGet packages is usually enough. Runtime natives are shipped in DisCatSharp.Voice.Natives.

macOS

If you run outside packaged natives, install dependencies with Homebrew:

brew install opus libsodium

Linux (Debian/Ubuntu)

If you run outside packaged natives:

sudo apt-get install libopus0 libopus-dev
sudo apt-get install libsodium23 libsodium-dev

For older distros, libsodium package names can differ (libsodium18, libsodium13, etc.).

4. DAVE Support

DAVE is Discord's end-to-end voice encryption protocol. DisCatSharp negotiates and uses it automatically when the channel requires it.

Prebuilt libdave binaries in DisCatSharp.Voice.Natives are available for:

Platform	Architectures
Windows	x64
Linux	x64, arm64
macOS	x64, arm64

Keep DisCatSharp.Voice and DisCatSharp.Voice.Natives on matching versions. If libdave is unavailable at runtime, DisCatSharp logs the native-loading failure and cannot participate in DAVE for that connection. The UDP transport can still initialize, but media in a DAVE-required session should not be expected to interoperate correctly.

5. Voice Configuration Defaults

using DisCatSharp.Voice;
using DisCatSharp.Voice.Enums;

client.UseVoice(new VoiceConfiguration
{
    EnableIncoming = false,
    EnableExternalOpus = false,
    EnableDebugLogging = false,
    MaxDaveProtocolVersion = 1,
    DavePendingAudioBehavior = DavePendingAudioBehavior.PassThrough
});

Relevant behavior:

MaxDaveProtocolVersion = 1 advertises DAVE support. Version negotiation and later transitions are handled automatically.
MaxDaveProtocolVersion = 0 advertises protocol-0-only operation.
DavePendingAudioBehavior is consulted only when no current sender mode is usable. It does not interrupt an established old epoch while the next transition is being prepared, and it does not block protocol-0 passthrough.
EnableExternalOpus must be true before using BindExternalOpusSourceAsync or VoiceOutputController.
EnableIncoming must be true before subscribing for decoded incoming media.

Table of Contents