You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Andrew Belt 77422ab731
Merge pull request #3 from VCVRack/make-mflags
3 years ago
.gitignore Revise readme. 3 years ago
Dockerfile Install RackSDK when building Docker image. Update mounted output path when running Docker container. 3 years ago
Makefile Add MFLAGS to pass make options to Docker build. 3 years ago Revise readme. 3 years ago

VCV Rack plugin build toolchains

Compile Rack plugins for Mac, Windows, and Linux with a single command on any Linux distro.


Clone this repository in a path without spaces, or the Makefile will break.

Obtain MacOSX10.13.sdk.tar.bz2 using the method at, and place it in the root of this repository. This must be done on a computer with Mac 10.13.

There are two ways to build the toolchains:

  • Locally on Linux: Uses your system's compilers to build the toolchains.
  • In a Docker container: Downloads an Ubuntu image and installs all dependencies in the container.

Local toolchain build

Requires a Linux host.

Install toolchain build dependencies. On Ubuntu,

sudo make dep-ubuntu

Or on Arch Linux,

sudo make dep-arch-linux

Build toolchains for each platform.

make toolchain-lin
make toolchain-win
make toolchain-mac

Each toolchain will take around an hour to build, requiring network access and about 15 GB free disk space. The final disk space after building is about 3.7 GB.

Build your plugin.

make plugin-build PLUGIN_DIR=...

To speed up builds, use -jN to launch N parallel jobs, such as your number of logical cores.

Built plugin packages are placed in the plugin-build/ directory.

Docker toolchain build

Works on any operating system with Docker installed.

Build the Docker container with toolchains for all platforms.

make docker-build

Build your plugin.

make docker-plugin-build PLUGIN_DIR=...

Built plugin packages are placed in the plugin-build/ directory.


Thanks to @cschol for help with crosstool-ng, Ubuntu, Docker, and testing.