rconvolve

Fast convolution and impulse response extraction for audio applications in Rust.

Overview

rconvolve provides FFT-based convolution and deconvolution for audio processing. It supports:

• Batch and real-time convolution for applying impulse responses to audio
• Exponential sine sweep generation for acoustic measurement
• Impulse response extraction from recorded sweeps via deconvolution
• Mono, stereo, and true stereo (4-channel matrix) processing
• WebAssembly support for browser-based applications
• no_std compatibility (requires alloc) for embedded systems

Live Demo: Try the WebAssembly demo at rconvolve.pages.dev

Installation

Add to your Cargo.toml:

[dependencies]
rconvolve = "*"

Feature Flags

Quick Start

Batch Convolution

use rconvolve::convolve;

let dry_audio = vec![1.0, 0.0, 0.0, 0.0];
let impulse_response = vec![0.5, 0.3, 0.1];

let wet_audio = convolve::apply_ir(&dry_audio, &impulse_response)?;
# Ok::<(), Box<dyn std::error::Error>>(())

Real-Time Convolution

use rconvolve::convolve::PartitionedConvolution;

let impulse_response = vec![0.5, 0.3, 0.1];
let input_block = vec![1.0; 512];
let mut processor = PartitionedConvolution::new(impulse_response, 512, None)?;
let output = processor.process_block(&input_block)?;
# Ok::<(), Box<dyn std::error::Error>>(())

Impulse Response Extraction

use rconvolve::{sweep, deconvolve};

let sweep_signal = sweep::exponential(48000.0, 2.0, 20.0, 20000.0)?;
let recorded_response = vec![0.0; 96000]; // Your recorded sweep response
let ir = deconvolve::extract_ir(&sweep_signal, &recorded_response)?;
# Ok::<(), Box<dyn std::error::Error>>(())

Examples

The crate includes some examples:

apply_reverb

Apply convolution reverb to a WAV file:

cargo run --example apply_reverb -- input.wav impulse_response.wav output.wav

realtime_reverb

Real-time convolution reverb using system audio input/output:

cargo run --example realtime_reverb -- impulse_response.wav
cargo run --example realtime_reverb -- --test-ir  # Use generated test IR

simple_wav_to_ir

Convert a recorded sweep to an impulse response:

cargo run --example simple_wav_to_ir -- recorded_sweep.wav output_ir.wav

WebAssembly

cargo install wasm-pack
wasm-pack build --target web --release

See the full documentation for the WASM API reference, or try the live demo.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.