Rust
Need help with rust-vst2?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.
overdrivenpotato

Description

VST 2.4 API implementation in rust. Create plugins or hosts.

204 Stars 22 Forks MIT License 150 Commits 16 Opened issues

Services available

Need anything else?

rust-vst2

Travis Build Appveyor Build crates.io

A library to help facilitate creating VST plugins in rust.

This library is a work in progress and as such does not yet implement all opcodes. It is enough to create basic VST plugins without an editor interface.

Please note: This api may be subject to rapid changes and the current state of this library is not final.

Library Documentation

  • http://overdrivenpotato.github.io/rust-vst2

TODO

  • Implement all opcodes
  • Proper editor support (possibly conrod + sdl2?)
  • Write more tests
  • Provide better examples

Usage

To create a plugin, simply create a type which implements

plugin::Plugin
and
std::default::Default
. Then call the macro
plugin_main!
, which will export the necessary functions and handle dealing with the rest of the API.

Example Plugin

A simple plugin that bears no functionality. The provided Cargo.toml has a crate-type directive which builds a dynamic library, usable by any VST host.

src/lib.rs
#[macro_use]
extern crate vst2;

use vst2::plugin::{Info, Plugin};

#[derive(Default)] struct BasicPlugin;

impl Plugin for BasicPlugin { fn get_info(&self) -> Info { Info { name: "Basic Plugin".to_string(), unique_id: 1357, // Used by hosts to differentiate between plugins.

        ..Default::default()
    }
}

}

plugin_main!(BasicPlugin); // Important!

Cargo.toml
[package]
name = "basic_vst"
version = "0.0.1"
authors = ["Author "]

[dependencies] vst2 = "0.0.1"

[lib] name = "basicvst" crate-type = ["dylib"]

Packaging on OS X

On OS X VST plugins are packaged inside of loadable bundles. To package your VST as a loadable bundle you may use the

osx_vst_bundler.sh
script this library provides. 

Example: 

./osx_vst_bundler.sh Plugin target/release/plugin.dylib
Creates a Plugin.vst bundle

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.