#synchronization #atomic #gui #augmented #apps #audio-thread

augmented-playhead

Implements some extra types and utilities over atomics for building audio-thread / GUI synchronization

13 releases (7 breaking)

0.8.0 Jan 17, 2024
0.7.0 May 22, 2023
0.6.0 Apr 19, 2023
0.5.0 Mar 22, 2023
0.1.0-alpha.4 Mar 25, 2022

#144 in Audio

Download history 14/week @ 2024-01-17 10/week @ 2024-02-14 46/week @ 2024-02-21 4/week @ 2024-02-28 1/week @ 2024-03-06 3/week @ 2024-03-13

62 downloads per month
Used in audio-processor-metronome

MIT license

96KB
1.5K SLoC

Augmented Audio Libraries

Default Linux Web-based builds Coverage Status Note about test coverage


Experiments trying to use Rust for audio programming.

Consider anything in this repository a draft.

⚠️ Goals
  • 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

License

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.

📖 Documentation

⬇️ Binary downloads

💬 Blog posts


📸 Screenshots

Sequencer screenshot

Metronome screenshot Test plugin host screenshot Looper screenshot

👩 Web GUI

See docs/misc/WEB_GUI.md.

🛠 Rust libraries and tooling

Workspace & Building

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:

git submodule update --init
cargo build

To run tests:

cargo test

On OSX you might want to run ./scripts/test.sh instead of that command.

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

Packaging apps and VSTs

Package VSTs using ./scripts/dev.sh build. This will build all the packages, build specific crates' outputs with ./scripts/dev.sh build <path>.

Looper, Metronome and other (flutter / macOS builds)

See instructions on their READMEs under crates/apps.

Building on linux

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.

Linting

cargo clippy

Benchmarking

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

cargo bench

Profiling on macOS

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

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

Generating flamegraphs from benchmarks

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

Snapshot testing audio processors

See docs/monorepo-tooling/SNAPSHOT_TESTING.md.

Debugging features

Dependencies

~0.9–3MB
~61K SLoC