• Stars
    star
    252
  • Rank 161,312 (Top 4 %)
  • Language
    Rust
  • License
    BSD 3-Clause "New...
  • Created almost 5 years ago
  • Updated 6 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Rust bindings for the webrtc-audio-processing library

webrtc-audio-processing

Crates.io Docs.rs Build Status dependency status

A wrapper around PulseAudio's repackaging of WebRTC's AudioProcessing module.

webrtc-audio-processing can remove echo from an audio input stream in the situation where a speaker is feeding back into a microphone, as well as noise-removal, auto-gain-control, voice-activity-detection, and more!

Example Usage

See examples/simple.rs for an example of how to use this crate.

Building

Feature Flags

  • bundled - Build webrtc-audio-procesing from the included C++ code
  • derive_serde - Derive serialize and deserialize traits for Serde use

Dynamic linking

By default the build will attempt to dynamically link with the library installed via your OS's package manager.

You can specify an include path yourself by setting the environment variable WEBRTC_AUDIO_PROCESSING_INCLUDE.

Packages

sudo apt install webrtc-audio-processing-dev # Ubuntu/Debian
sudo pacman -S webrtc-audio-processing # Arch

Build from source

The webrtc source code is included as a git submodule. Be sure to clone this repo with the --recursive flag, or pull the submodule with git submodule update --init.

Building from source and static linking can be enabled with the bundled feature flag. You need the following tools to build from source:

  • clang or gcc
  • autotools (MacOS: brew install automake, brew install autoconf)
  • libtoolize (typically glibtoolize on MacOS: brew install libtool)
  • pkg-config (MacOS: brew install pkg-config)

Publishing

cargo login
cd ./webrtc-audio-processing-sys
cargo publish --features derive_serde --features bundled
cd ../
cargo publish --features derive_serde --features bundled

Contributing

Version increment

We are using semantic versioning. When incrementing a version, please do so in a separate commit, and also mark it with a Github tag.