Skip to content

Cloud-Scythe-Labs/cargo-reaper

Repository files navigation

built with nix

cargo-reaper

Corro the Unsafe Rust Urchin

A Cargo plugin for developing REAPER extension and VST plugins with Rust.

cargo-reaper is a convenience wrapper around Cargo that adds a post-build hook to streamline REAPER extension development. It automatically renames the compiled plugin to include the required reaper_ prefix and symlinks it to REAPER’s UserPlugins directory.

By default, Cargo prefixes dynamic libraries with lib, which REAPER does not recognize. Manually renaming the plugin and keeping the UserPlugins directory up-to-date can be tedious -- cargo-reaper takes care of all that for you, across all supported platforms.

reaper-rs

cargo-reaper is made to be a companion for reaper-rs which is a rust library for writing REAPER plugins that includes an extension plugin bootstrap proc macro.

Getting Started

Extension Plugins

To initialize, build and run your first cargo-reaper extension plugin:

cargo reaper new reaper_hello_world_extension
cargo reaper run

VST Plugins

Warning

Currently the reaper-rs library supports using the vst crate which is deprecated. In an effort to maintain support for reaper-rs, cargo-reaper can initialize VST plugins, but it does not add any conveniences like it does for extension development.

To initialize and build a VST plugin:

cargo reaper new --template vst reaper_vst_plugin
cargo build

For more information on how to use cargo-reaper read the docs, or start a discussion.

Please be sure to check that your issue has not already been resolved before opening a new discussion or issue.

Contributors 2

  •  
  •