Andrew Belt 840140e372 Update README, make screws smaller		7 years ago
.github	Add Github issue template	7 years ago
dep	Use Github mirror of GLEW instead of Sourceforge	7 years ago
ext	Cleanup, update nanovg	7 years ago
include	Add uniqueness assertion for plugin slugs, fix PolarityValueLight alpha	7 years ago
plugins	Add stub to plugins directory	7 years ago
res	Update README, make screws smaller	7 years ago
src	Made light glow more intense, added "sampleRate" to settings.json	7 years ago
.gitignore	Autosave settings: opacity, tension, authentication token	7 years ago
.gitmodules	Remove dr_libs submodule	7 years ago
CHANGELOG.md	Use 10V as the headroom for Audio Interface IO instead of 5V	7 years ago
Info.plist	Remove version strings from Info.plist on Mac	7 years ago
LICENSE-dist.txt	Update LICENSE-dist	7 years ago
LICENSE.txt	Relicensed to BSD-3-Clause	7 years ago
Makefile	Change build system to create standalone app bundle with resources inside, use ~/Documents/Rack as local directory	7 years ago
README.md	Update README, make screws smaller	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	Decrease minimum requirement for CPU extension support	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.

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

The Issue Tracker is the official developer's forum

Bug reports, feature requests, and even questions/discussions are welcome on the GitHub Issue Tracker for all VCVRack repos. However, please search before posting to avoid duplicates.

You may vote on feature requests by using the Thumbs Up/Down reaction on the first post.

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.

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. If you would like to build a previous version instead of the master branch, run git checkout v0.3.2 for example.

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