Setting up your development environment¶
Before building Rack or Rack plugins, you must install build dependencies provided by your system’s package manager. Rack’s own dependencies (GLEW, glfw, etc) do not need to be installed on your system, since specific versions are compiled locally during the build process. However, you need proper tools to build Rack and these dependencies.
Install Homebrew, and install build dependencies.
brew install git wget cmake autoconf automake libtool jq python
If you have an anti-virus program running, disable it or it may interfere with the build process.
Install MSYS2 and launch the MinGW 64-bit shell from the Start menu, not the default MSYS shell. Update the package manager itself:
Then restart the shell and install packages.
pacman -Su git wget make tar unzip zip mingw-w64-x86_64-gcc mingw-w64-x86_64-gdb mingw-w64-x86_64-cmake autoconf automake mingw-w64-x86_64-libtool mingw-w64-x86_64-jq python
On Ubuntu 16.04+:
sudo apt install git gdb curl cmake libx11-dev libglu1-mesa-dev libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev zlib1g-dev libasound2-dev libgtk2.0-dev libjack-jackd2-dev jq
On Arch Linux:
pacman -S git wget gcc gdb make cmake tar unzip zip curl jq python
You do not need to build Rack to build plugins if you use the Rack SDK.
If the build fails for you, please report the issue to help the portability of Rack.
Clone this repository with
git clone https://github.com/VCVRack/Rack.git and
Make sure there are no spaces in your absolute path, since this breaks the Makefile-based build system.
git submodule update --init --recursive
Build dependencies locally.
You may add
-j4 (or your number of logical cores) to your
make commands to parallelize builds.
This may take 15-60 minutes.
Build Rack. This may take 1-5 minutes.
Building Rack plugins¶
Complete the Setting up your development environment section.
Plugins can be built in two ways:
- Build Rack from source and build plugins in the
plugins/folder. (Recommended for advanced developers.)
- Download an official Rack build and Rack-SDK-1.1.2.zip, and build plugins anywhere you like. (Easiest/fastest.)
Download or clone the plugin source code, e.g.
git clone https://github.com/VCVRack/Fundamental.git
Clone the git repo’s submodules.
cd Fundamental git submodule update --init --recursive
If using the Rack SDK, set the
RACK_DIR environment variable by prefixing each of the following commands with
RACK_DIR=<Rack SDK dir>.
Build plugin dependencies. (Most plugins don’t require this step.)
Build the plugin.
Create a plugin ZIP package.
Or you may build, package, and install plugins to your Rack user folder in one step.