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.