Important
We're working on a restructure of the repository, and planning on switching to a different GUI for the plugins. Read more at #477
As defined in bundler.toml, the following plugins are included in this repository, for more information on each plugin, please refer to their respective product pages on zmann.org.
Product | CI/CD | TYPE | |
---|---|---|---|
Toybox C1200 | |||
Orchestron | |||
Bilhorn Reed | |||
Hohner Melodica | |||
Mellotron | |||
NoiseG8 |
After downloading the .vst3 file, move it to your VST3 directory. The default VST3 directory is located at C:\Program Files\Common Files\VST3
on Windows. If you are unsure where your VST3 directory is located, you can check the VST3 directory in your DAW's settings.
Tip
Create a dedicated folder within your VST3 directory, e.g., ZMANN
, for better organization.
Warning
As of writing, only Windows is supported for building. Linux cross-compilation might work, but is not stable at this time. Currently we don't have any motivation in supporting Mac OS, although the plugins should be compatible without many modifications. Read more about cross-compilation.
- Node.js 18.17 or later
- Rust
Before building, make sure that rustup is installed with msvc if building on Windows:
$ rustup default stable-x86_64-pc-windows-msvc
As of writing, we aren't including the samples (for example .binv5 or .microbin) in the repository due to the git file limit. For the builds not to fail, supply a /samples/plugin_name
folder, where plugin_name
is the name of the plugin you are building. You can create the folder by running:
$ mkdir /samples/plugin_name
Then, add the samples to the folder. The folder structure should look like this:
/samples
/Toybox_C1200
/Cello.binv5
Release builds will be built with the samples included in the plugin bundle.
Plugins are required to be built separately from each other. Run the xtask build command with the plugin name and --release
at the end to target a release build. For example:
$ cargo xtask bundle toybox_c1200 --release
Cargo will now build the toybox_c1200_ui before building the plugin itself. After successfully building, each plugin will make their own .vst3 bundle inside of the /target/bundled/
folder.
Or to build all projects inside of the repository, run to build all the ui and plugins in the repository:
$ cargo xtask bundle -p toybox_c1200 -p orchestron
Optionally by running mklink on Windows, a simlink will be created from the locally generated artifacts folder to the standard vst3 folder to streamline development. This will allow you to test the plugins in your DAW without having to move the files manually. Run the following command in the root of the repository:
mklink /j "%COMMONPROGRAMFILES%\VST3\zmann-dev" "%~dp0target\bundled\"
Make sure to install the following package and toolchain:
$ sudo apt install build-essential
$ rustup target add x86_64-pc-windows-gnu
After installing the toolchain, modify .cargo/config.toml to use the x86_64-pc-windows-gnu
toolchain:
[alias]
xtask = "run --package xtask --target x86_64-pc-windows-gnu --release --"
Finally, you can build the plugins by running the following command:
$ cargo xtask bundle plugin_name
The code in this repository is licensed under the GNU General Public License v3.0 or later. You can find a copy of the license in the LICENSE file.
The samples included in this repository are owned by their respective owners. Please refer to the individual sample files for their specific licensing information.
VST® is a trademark of Steinberg Media Technologies GmbH, registered in Europe and other countries. Other company names, product names and logos are the trademarks or registered trademarks of their respective owners.