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 1d6faa0bdc Build app bundle in dist instead of root 7 years ago
.github Add Github issue template 7 years ago
dep Use library files as target names in dep/Makefile instead of build 7 years ago
ext Remove dr_libs submodule 7 years ago
include Changed onSelect/onDeselect to onFocus/onDefocus, added key commands for Open/Save/Save As, open in last used directory 7 years ago
plugins Add stub to plugins directory 7 years ago
res Tweak icons again 7 years ago
src Remove dr_libs submodule 7 years ago
.gitignore Autosave settings: opacity, tension, authentication token 7 years ago
.gitmodules Remove dr_libs submodule 7 years ago
Info.plist Remove version strings from Info.plist on Mac 7 years ago
LICENSE-dist.txt Bumped OpenGL require from 3.2 to 2.0, fixed plugin loading on win and mac, added licenses for new libraries 7 years ago
LICENSE.txt Relicensed to BSD-3-Clause 7 years ago
Makefile Build app bundle in dist instead of root 7 years ago
README.md Added `make dep` to root Makefile, added Development Environment setup 7 years ago
Rack.rc Fix Windows build, use portaudio pre-builds, remove curl init/destroy 7 years ago
Rack.res Fix plugin and request.hpp bugs, add icon res file to Windows 7 years ago
Rack.sh Add Rack.sh Linux wrapper script 7 years ago
arch.mk Updated build instructions, refactored Makefiles 7 years ago
compile.mk Move version check dialog box to RackScene on main thread 7 years ago
icon.icns Update Mac icns icon 7 years ago
icon.ico Tweak icons again 7 years ago
plugin.mk Add dist to `make clean` for plugins 7 years ago

README.md

Rack

Rack is the engine for the VCV open-source virtual Eurorack DAW.

Rack screenshot

This README includes instructions for building Rack from source. For information about the software, go to https://vcvrack.com/.

Setting up your development environment

Rack's 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 these dependencies.

Mac

Install Xcode or command line developer tools with xcode-select --install. Install CMake, preferably from Homebrew.

If you would like MacOS 10.7+ users to be able to run your binaries and plugins, install the MacOS 10.7 SDK using the xcodelegacy script.

Windows

Install MSYS2 and launch the mingw64 shell (not the default msys2 shell). Install build dependencies with the pacman package manger.

pacman -S git make tar unzip mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake

Linux

With your distro's package manager, make sure you have installed gcc, make, cmake, tar, and unzip.

Building

If the build fails for you, please report the issue with a detailed error message to help the portability of Rack.

Clone this repository and cd into it.

Clone submodules.

git submodule update --init --recursive

Build dependencies locally. You may use make's -j$(nproc) flag to parallelize builds across all your CPU cores.

make dep

You should see a message that all dependencies built successfully.

Build Rack.

make

Run Rack.

make run

Building plugins

Clone your favorite plugin in the plugins/ directory. e.g.:

cd plugins
git clone https://github.com/VCVRack/Fundamental.git

Clone submodules.

cd Fundamental
git submodule update --init --recursive

Build plugin.

make

License

Rack source code by Andrew Belt licensed under the BSD-3-Clause

Component Library graphics by Grayscale licensed under the CC BY-NC 4.0