Skip to content
RESONON

Install from Source

If you want to make changes to the core source code of Resonon or have other reasons for not using the official installers, you can build and install from source.

Prerequisites

Section titled “Prerequisites”
  • macOS — the build and install process is macOS-only (it codesigns the binaries and symlinks them into /usr/local/bin).
  • Rust toolchain — install via rustup. A recent stable toolchain is required.
  • Node.js + npm — only needed to build the VS Code extension.

Build and install

Section titled “Build and install”

Clone the repository and run the install target:

Terminal window
git clone https://github.com/WARNS-AUDIO/RESONON.git
cd RESONON
make install

make install performs the full pipeline:

  1. Builds and stages the bundled audio plugins.
  2. Builds the resonon binary (release, with embedded plugins).
  3. Builds the resonon-lsp language server.
  4. Installs both binaries under ~/.resonon/versions/dev/.
  5. Copies the bundled sample kits and the standard library alongside them.
  6. Codesigns the binaries and activates the dev version.
  7. Symlinks resonon and resonon-lsp into /usr/local/bin (this step uses sudo).

When it finishes, verify the install:

Terminal window
resonon --version

VS Code extension

Section titled “VS Code extension”

To build and install the extension from source:

Terminal window
make install-ext

Building without installing

Section titled “Building without installing”

If you just want to compile the binaries (for development or CI) without installing them system-wide, use cargo directly:

Terminal window
cargo build --release --bin resonon --features embedded-plugins
cargo build --release -p resonon-lsp

The binaries land in target/release/. Run the test suite with cargo test --all.

Next Steps

Section titled “Next Steps”