This project is a work in progress and not intended for use in production yet.

audio-plugin-host

High-level Rust hosting library for VST2/3 and CLAP. Largely based on EasyVst and vst-rs.

Setting up VST SDK

1. Download the VST SDK and unzip it.
2. Set the environment variable VSTSDK_DIR to the path of the unzipped SDK. To clarify, it should point to a directory called VST_SDK with multiple other files and directories inside it.

Usage

For full examples see the examples directory.

Loading

let host = host::Host::new(
    env!("CARGO_PKG_NAME"),
    env!("CARGO_PKG_VERSION"),
    env!("CARGO_PKG_AUTHORS"),
);

thread_check::mark_current_as_main();

let descriptors = discovery::get_descriptor_from_file(&plugin_path);
println!("{:?}", descriptors);

let mut plugin = plugin::load(
    &plugin_path,
    &descriptors.first().expect("No plugins in file").id,
    &host,
)
.unwrap();

println!("{:?}", plugin.get_io_configuration());

Processing

// Audio thread

let process_details = ProcessDetails {
    block_size: 512,
    sample_rate: 44100,
    nanos: start_time
        .duration_since(SystemTime::UNIX_EPOCH)
        .unwrap()
        .as_nanos() as f64,
    ..Default::default()
};

plugin.process(
    &input_buses,
    &mut output_buses,
    events,
    &process_details,
);

Main Loop

// Main thread

let (width, height) = plugin.show_editor(window_id, WindowIDType::this_platform()).unwrap();
window.set_size(width as u32, height as u32).unwrap();

loop {
    let events = plugin.get_events();

    if !events.is_empty() {
        println!("Received events: {:?}", events);
    }

    for event in events {
        match event {
            PluginIssuedEvent::ResizeWindow(width, height) => {
                window.set_size(width as u32, height as u32).unwrap();
            }
            PluginIssuedEvent::Parameter(param) => {
                let param = plugin.get_parameter(param.parameter_id);
                println!("Parameter updated {:?}", param);
            }
            _ => {}
        }
    }
}

Feature Flags

• future-thread-pool: Abstracts the CLAP thread pool behind an awaitable Future.
• serde: Adds Serialize and Deserialize to various structures.

Licensing

You may use this in any project, proprietary or open source but if you vendor it or make modifications, those changes must be made public.