VstAudio 0.1.0
See the version list below for details.
dotnet add package VstAudio --version 0.1.0
NuGet\Install-Package VstAudio -Version 0.1.0
<PackageReference Include="VstAudio" Version="0.1.0" />
<PackageVersion Include="VstAudio" Version="0.1.0" />
<PackageReference Include="VstAudio" />
paket add VstAudio --version 0.1.0
#r "nuget: VstAudio, 0.1.0"
#:package VstAudio@0.1.0
#addin nuget:?package=VstAudio&version=0.1.0
#tool nuget:?package=VstAudio&version=0.1.0
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 | Versions 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. |
-
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.