VstAudio 0.1.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package VstAudio --version 0.1.0
                    
NuGet\Install-Package VstAudio -Version 0.1.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.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="VstAudio" Version="0.1.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.1.0
                    
#r "nuget: VstAudio, 0.1.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.1.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.1.0
                    
Install as a Cake Addin
#tool nuget:?package=VstAudio&version=0.1.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.1.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.1.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.

Calls block the caller and are serialized per instance. 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.

This is the control/offline API in ADR 0006, not a realtime callback API. 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).

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