A flexible tool for processing audio

# CamillaDSP v0.6.3 

A tool to create audio processing pipelines for applications such as active crossovers or room correction. It is written in Rust to benefit from the safety and elegant handling of threading that this language provides.

Supported platforms: Linux, macOS, Windows.

Audio data is captured from a capture device and sent to a playback device. Alsa, PulseAudio, Jack, Wasapi and CoreAudio are currently supported for both capture and playback.

The processing pipeline consists of any number of filters and mixers. Mixers are used to route audio between channels and to change the number of channels in the stream. Filters can be both IIR and FIR. IIR filters are implemented as biquads, while FIR use convolution via FFT/IFFT. A filter can be applied to any number of channels. All processing is done in chunks of a fixed number of samples. A small number of samples gives a small in-out latency while a larger number is required for long FIR filters. The full configuration is given in a yaml file.

### Table of Contents **[Introduction](#introduction)** - **[Background](#background)** - **[How it works](#how-it-works)** - **[System requirements](#system-requirements)** - **[Usage example: crossover for 2-way speakers](#usage-example-crossover-for-2-way-speakers)** - **[Dependencies](#dependencies)** - **[Related projects](#related-projects)**

**[Installing](#installing)**

**[Building](#building)** - **[Build with standard features](#building-in-linux-with-standard-features)** - **[Customized build](#customized-build)** - **[Optimize for your system](#optimize-for-your-system)** - **[Building on Windows and macOS](#building-on-windows-and-macos)**

**[How to run](#how-to-run)** - **[Command line options](#command-line-options)** - **[Reloading the configuration](#reloading-the-configuration)** - **[Controlling via websocket](#controlling-via-websocket)**

**[Processing audio](#processing-audio)** - **[Cross-platform](#cross-platform)** - **[Jack](#jack)** - **[File or pipe](#file-or-pipe)** - **[Windows](#windows)** - **[MacOS (CoreAudio)](#macos-coreaudio)** - **[Linux](#linux)** - **[Alsa](#alsa)** - **[PulseAudio](#pulseaudio)** - **[Pipewire](#pipewire)**

**[Configuration](#configuration)** - **[The YAML format](#the-yaml-format)** - **[Devices](#devices)** - **[Resampling](#resampling)** - **[Mixers](#mixers)** - **[Filters](#filters)** - **[Gain](#gain)** - **[Volume](#volume)** - **[Loudness](#loudness)** - **[Delay](#delay)** - **[FIR](#fir)** - **[IIR](#iir)** - **[Dither](#dither)** - **[Difference equation](#difference-equation)** - **[Pipeline](#pipeline)** - **[Visualizing the config](#visualizing-the-config)**

**[Getting help](#getting-help)** - **[FAQ](#faq)** - **[Troubleshooting](#troubleshooting)**



# Introduction

## Background The purpose of CamillaDSP is to enable audio processing with combinations of FIR and IIR filters. This functionality is available in EqualizerAPO, but for Windows only. For Linux the best known FIR filter engine is probably BruteFIR, which works very well but doesn't support IIR filters. The goal of CamillaDSP is to provide both FIR and IIR filtering for Linux, Windows and macOS, to be stable, fast and flexible, and be easy to use and configure.

* BruteFIR: https://www.ludd.ltu.se/~torger/brutefir.html * EqualizerAPO: https://sourceforge.net/projects/equalizerapo/ * The IIR filtering is heavily inspired by biquad-rs: https://github.com/korken89/biquad-rs

## How it works The audio pipeline in CamillaDSP runs in three separate threads. One thread handles capturing audio, one handles the playback, and one does the processing in between. The capture thread passes audio to the processing thread via a message queue. Each message consists of a chunk of audio with a configurable size. The processing queue waits for audio messages, processes them in the order they arrive, and passes the processed audio via another message queue to the playback