Requirements

Platform

Jamba is currently working on the following platforms:

  • macOS Mojave 10.14.6+ with Xcode 11.3.1 installed
  • Windows 10 64 bits and Visual Studio Build tools (Visual Studio 16 2019)

It requires cmake version 3.17 at the minimum and uses C++ 17

Info

On macOS, it is likely possible to use an earlier version (of the OS and Xcode) but it has not been tested

Note

Linux is currently not supported (could be added if there is demand).

VST3 SDK

Tip

Jamba can automatically download the SDK for you but it is strongly recommended to install the SDK as the cloned repository is quite large (over 100MB) and would have to be downloaded again if you delete the build folder.

Download or clone the SDK

You can clone the SDK from Github

git clone --recursive https://github.com/steinbergmedia/vst3sdk.git
Note

Jamba currently uses 3.7.0 which corresponds to the tag vstsdk370_31_07_2020_build_116 (3e651943d4747f8af43d10b21227020bc8b7f438 commit hash).

Otherwise you can download the SDK from Steinberg website.

More information about the 2 different options can be found on the website.

Install the SDK

Jamba lets you configure the location of the SDK via the VST3_SDK_ROOT CMake cache variable which can be set via any means available to CMake or set via the --vst3 option when running the configure.py script. If you do not want to have to worry about it you can also install it (or create a link) to a default location:

  • /Users/Shared/Steinberg/VST_SDK.3.7.0 for macOS
  • C:\Users\Public\Documents\Steinberg\VST_SDK.3.7.0 for windows.

VST2 SDK

If you want to wrap your VST3 plugin into a VST2 plugin you will need the VST2 SDK. Unfortunately Steinberg is no longer distributing it officially and you need to get access to it. Once you get access to it, Jamba lets you configure the location of the SDK via the VST2_SDK_ROOT CMake cache variable which can be set via any means available to CMake or set via the --vst2 option when running the configure.py script.

Tip

If you download an old version of the VST3 SDK (like 3.6.9 (shasum 256 => 7c6c2a5f0bcbf8a7a0d6a42b782f0d3c00ec8eafa4226bbf2f5554e8cd764964)) it contains the VST2 SDK at the root and this is what you need to copy or link to.

Warning

If you donwload the latest VST3 SDK zip file it does contain a VST2_SDK folder at the root but it is an incomplete VST2 SDK distribution. Only older versions of the VST3 SDK (like 3.6.9) contains a valid VST2 SDK distribution.