WaveLink.Client

Modern .NET client for the local WebSocket JSON-RPC API exposed by Elgato Wave Link 3.x.

• Target: .NET 10.0, C# 14
• Serializer: System.Text.Json Source Generation (100% Native AOT & Trimming compatible)
• Extracted features: Supports hardware DspEffects, IsGainLockOn, and advanced Channel metadata.

The library is designed to be:

• Native AOT and trimming friendly
• strongly typed and async-first
• useful both for local automation and higher-level mixer/control applications

See PROTOCOL.md for the wire format notes.

Install

dotnet add package WaveLink.Client

Quick start

usingWaveLink.Client;varclient=newWaveLinkClient();awaitclient.ConnectAsync();varapp=awaitclient.GetApplicationInfoAsync();Console.WriteLine($"{app.Name} ({app.AppId}) rev {app.InterfaceRevision}");varinputs=awaitclient.GetInputDevicesAsync();varoutputs=awaitclient.GetOutputDevicesAsync();// Subscribe to focused app + level metersawaitclient.SetSubscriptionAsync(newSetSubscriptionParams{FocusedAppChanged=newSubscriptionToggle{IsEnabled=true},LevelMeterChanged=newLevelMeterSubscription{IsEnabled=true,Type="all",Id="all"}});

Consuming Events

WaveLink.Client gives you two modern ways to consume real-time events.

Option 1: Modern IAsyncEnumerable<T> (Recommended)

You can use standard await foreach loops to process events asynchronously without dealing with traditional event handler memory leaks.

// Runs asynchronously in the background_=Task.Run(async()=>{awaitforeach(varmetersinclient.StreamLevelMetersAsync(cancellationToken)){Console.WriteLine($"Meters updated. Channels={meters.Channels?.Count??0}");}});_=Task.Run(async()=>{awaitforeach(varappinclient.StreamFocusedAppChangesAsync(cancellationToken)){Console.WriteLine($"Focused App Changed: {app.Name} -> {app.Channel?.Id}");}});

Option 2: Traditional .NET Events

client.FocusedAppChanged+=(_,e)=>Console.WriteLine($"Focused: {e.Name} -> {e.Channel?.Id}");client.LevelMeterChanged+=(_,m)=>Console.WriteLine($"Meters updated.");

Sample

The repository includes a console sample:

dotnet run --project samples/WaveLink.Console

Development

dotnet build WaveLink.Client.slnx -c Release

Notes

• This is a reverse-engineered client based on the Stream Deck plugin behavior.
• Unknown fields introduced by newer Wave Link updates are safely preserved inside ExtensionData dictionaries.