Experiments trying to use Rust for audio programming.

Consider anything in this repository a draft.

• Goal 1: Learn & have fun
  • This is goal #1 and it's very important to keep it in mind if you end-up depending on one of the crates in this repository
• Goal 2: Build tools for aiding development
• Goal 3: Experiment with Audio software GUI in Rust

Most of this repository is published under the MIT LICENSE.

Some directories which contain full applications are licensed under the AGPLv3 license. Check the LICENSE and README.md files.

• See releases to download binaries
• Simple Metronome on App Store

• Initial 'Test Plugin Host' post
• Simple Metronome release
• Generic AudioProcessors in Rust

• Augmented Audio Libraries
• Applications in this repository
  • Test plugin host
  • Metronome
  • Continuous Looper (native macOS)
  • Looper VST (iced)

• Simple standalone audio-app
• Effects and analysis
  • RMS, FFT, peak-detection, transient detection
  • Filters
  • Time-based effects (delay/reverb)
  • Compressor
  • Pitch-shifter
  • Bit-crusher
  • Utility (pan, mono, gain)

See docs/misc/WEB_GUI.md.

The project is set-up with a cargo workspace. Running cargo commands at the root directory should compile all crates sharing caches.

To build the whole project run:

cargo build

To run tests:

cargo test

Build outputs should be on target/debug or target/release.

Since this is bringing in all the possible rust crates, you'll need to install quite a few dependencies.

See .github/workflows/default.yml for a list of what's needed on Ubuntu.

cargo clippy

Benchmarks using criterion will be slowly added. In order to run benchmarks use:

cargo bench

https://crates.io/crates/cargo-instruments

cd ./crates/oscillator
cargo instruments -t time --bench sine_oscillator_benchmark -- --bench

NOTE I couldn't get this to work on macOS

Flamegraphs can be generated using cargo-flamegraph:

cargo install flamegraph

The tool can then be used to run a criterion benchmark and generate a flamegraph:

cargo flamegraph --bench sine_oscillator_benchmark -- --bench

See docs/monorepo-tooling/SNAPSHOT_TESTING.md.