VstAudio 0.2.0

dotnet add package VstAudio --version 0.2.0
                    
NuGet\Install-Package VstAudio -Version 0.2.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="VstAudio" Version="0.2.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="VstAudio" Version="0.2.0" />
                    
Directory.Packages.props
<PackageReference Include="VstAudio" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add VstAudio --version 0.2.0
                    
#r "nuget: VstAudio, 0.2.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package VstAudio@0.2.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=VstAudio&version=0.2.0
                    
Install as a Cake Addin
#tool nuget:?package=VstAudio&version=0.2.0
                    
Install as a Cake Tool

VstAudio

.NET 8 bindings for vst-audio, a Rust library that hosts VST2 and VST3 plugins in separate worker processes. The package includes the native C ABI library and matching worker.

Install

dotnet add package VstAudio --version 0.2.0
using VstAudio;

using var host = new Host();
using var plugin = host.Load("/path/to/effect.vst3",
    options: new LoadOptions { SampleRate = 48000, BlockSize = 128 });

// One array per input channel, each with the same number of frames.
float[][] input = Enumerable.Range(0, plugin.InputChannels)
    .Select(_ => new float[1061]).ToArray();
float[][] output = plugin.Process(input, tail: 193);
// output[channel] has 1254 samples; the plugin's reported latency is compensated.
// Dispose stops the worker; the using declarations dispose both objects.

Supported operations

Version 0.2.0 exposes scanning (including sandboxed scanning), class selection, synchronous loading, offline Float32/Float64 rendering, parameter queries and updates, state save/restore, and worker editor open/close. Float64 requires native plugin support. Processing accepts jagged channel arrays or flat planar spans; input and output spans must not overlap. For instruments with no inputs, use the span overload to specify the number of frames. 0.2.0 adds the experimental realtime block path below and moves to the MIT OR Apache-2.0 licence; its native library speaks C ABI version 2, so 0.1.0 natives and 0.2.0 managed code do not mix.

Calls block the caller and are serialized per instance; in a GUI, run them with await Task.Run(...) so the UI thread stays free, as the WPF and WinUI 3 examples do. Control and per-block render deadlines default to 10 seconds; loading defaults to 30 seconds. Negative timeouts are rejected; values above uint.MaxValue milliseconds are clamped. Rendering fails with an exception on a missed deadline, lost worker or recovery; it never substitutes silence for missing results. Dispose is idempotent and can run on any thread. A plugin remains usable after its host has been disposed.

Experimental realtime block path

Set LoadOptions.Realtime = true, then call Plugin.TakeBlockProcessor() once. The returned experimental BlockProcessor accepts flat planar spans containing exactly channels * Quantum samples and returns Delivered, Missed, or InvalidBuffer without waiting for a late worker. Taking it disables the plugin's offline Process methods. This API is marked VSTA0001 (ADR 0008). The package's tests show that a call allocates nothing and never waits for the worker, but also that a managed audio thread stops for every blocking garbage collection in the process. Keep blocking collections out of the process while audio plays, or call the C ABI's vsta_blocks_process_f32 from a native audio thread.

The control/offline API follows ADR 0006. Event polling, explicit recovery commands, channel-layout selection and cross-architecture worker registration are not exposed by this .NET release. .NET Framework and Unity are not supported.

Native platforms and worker lookup

  • Windows x64 (win-x64)
  • Linux x64, glibc 2.28 or newer (linux-x64)
  • macOS Apple Silicon (osx-arm64)
  • macOS Intel (osx-x64)

Native assets and dependency notices live in runtimes/<rid>/native/. The package's MSBuild targets preserve subdirectories in build and publish outputs, including VstAudioWorker.app/Contents/MacOS/vst-audio-worker on macOS. The helper has an ad-hoc signature, not Developer ID signing or notarization; application distributors must sign and notarize their final distribution.

new Host() checks VST_AUDIO_WORKER, then the application's runtimes/<rid>/native/ directory, then the application directory. You can pass an explicit executable path to new Host(workerPath). A missing explicit path throws WorkerNotFoundException. Use a worker from the same native release. On Unix, the package adds execute permission for each existing read permission on a bundled worker, because NuGet does not preserve file modes. It never changes permissions on explicit paths or paths from the environment variable. The application must have permission to update the bundled file mode on first use (or the distributor must set its execute permissions before deployment).

Licensed under MIT OR Apache-2.0, at your option. The bundled worker's notices, including its BSD-3-Clause and ISC parts, ship with the package.

VST is a registered trademark of Steinberg Media Technologies GmbH. This project is independent of Steinberg and is not endorsed by it.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.2.0 199 11/5/2026
0.1.0 90 11/5/2026
0.0.1 93 11/4/2026