About

This is meant to be a more Linux packaging friendly copy of the AudioProcessing module from the WebRTC project. The ideal case is that we make no changes to the code to make tracking upstream code easy.

This package currently only includes the AudioProcessing bits, but I am very open to collaborating with other projects that wish to distribute other bits of the code and hopefully eventually have a single point of packaging all the WebRTC code to help people reuse the code and avoid keeping private copies in several different projects.

Building

This project uses the Meson build system. The quickest way to build is:

# Initialise into the build/ directory, for a prefixed install into the
# install/ directory
meson setup build -Dprefix=$PWD/install

# Run the actual build
ninja -C build

# Install locally
ninja -C build install

# The libraries, headers, and pkg-config files are now in the install/
# directory

Testing

The project includes a comprehensive test suite ported from upstream WebRTC. To build and run the tests:

# Configure with tests enabled
meson setup builddir -Dtests=enabled

# Build
ninja -C builddir

# Run all tests
meson test -C builddir

# Run tests with verbose output
meson test -C builddir -v

# Run a specific test
./builddir/tests/apm_unit_tests --gtest_filter="TestName"

# List all available tests
./builddir/tests/apm_unit_tests --gtest_list_tests

The test suite requires Google Test and Google Mock, which are automatically fetched as subprojects if not found on the system.

Feedback

Patches, suggestions welcome. You can file an issue on our Gitlab repository.

Notes

1. It might be nice to try LTO on the library. We build a lot of code as part of the main AudioProcessing module deps, and it's possible that this could provide significant space savings.