Note: This is a fork of the original aubio project maintained by the LedFx team.

Why this fork exists:

• The original aubio project is no longer actively maintained and released
• We need Python 3.13 support with pre-built wheels on PyPI
• We require the latest fixes and improvements from the main branch of aubio
• LedFx depends on aubio and needs a reliable, up-to-date release

All credit for aubio goes to the original authors. This fork exists solely to provide maintained releases for projects that depend on aubio.

Original project: https://github.com/aubio/aubio
This fork: https://github.com/LedFx/aubio-ledfx

aubio is a library to label music and sounds. It listens to audio signals and attempts to detect events. For instance, when a drum is hit, at which frequency is a note, or at what tempo is a rhythmic melody.

Its features include segmenting a sound file before each of its attacks, performing pitch detection, tapping the beat and producing midi streams from live audio.

aubio provide several algorithms and routines, including:

• several onset detection methods
• different pitch detection methods
• tempo tracking and beat detection
• MFCC (mel-frequency cepstrum coefficients)
• FFT and phase vocoder
• up/down-sampling
• digital filters (low pass, high pass, and more)
• spectral filtering
• transient/steady-state separation
• sound file read and write access
• various mathematics utilities for music applications

The name aubio comes from audio with a typo: some errors are likely to be found in the results.

A python module for aubio is provided. For more information on how to use it, please see the file python/README.md and the manual .

The python module comes with the following command line tools:

• aubio extracts informations from sound files
• aubiocut slices sound files at onset or beat timestamps

Additional command line tools are included along with the library:

• aubioonset outputs the time stamp of detected note onsets
• aubiopitch attempts to identify a fundamental frequency, or pitch, for each frame of the input sound
• aubiomfcc computes Mel-frequency Cepstrum Coefficients
• aubiotrack outputs the time stamp of detected beats
• aubionotes emits midi-like notes, with an onset, a pitch, and a duration
• aubioquiet extracts quiet and loud regions

• manual, generated with sphinx
• developer documentation, generated with Doxygen

The latest version of the documentation can be found at:

https://aubio.org/documentation

aubio uses the Meson build system and vcpkg for dependency management. It compiles on Linux, macOS, Windows, and iOS.

• Meson >= 1.9.0: pip install "meson>=1.9.0" or apt install meson
• Ninja: pip install ninja or apt install ninja-build
• C compiler: GCC, Clang, or MSVC
• Python >= 3.8 (for Python bindings)
• NumPy (for Python bindings): pip install numpy
• vcpkg (optional, for automatic dependency management): See vcpkg installation

aubio uses vcpkg manifest mode (vcpkg.json) to automatically manage dependencies. If vcpkg is installed, dependencies will be fetched automatically during build.

# Install vcpkg (one-time setup)
git clone https://github.com/microsoft/vcpkg.git
./vcpkg/bootstrap-vcpkg.sh  # or .bat on Windows
export VCPKG_ROOT=$(pwd)/vcpkg
export PATH=$VCPKG_ROOT:$PATH

Dependencies (libsndfile, libsamplerate, fftw3) will be installed automatically via vcpkg.json when you build.

# Configure the build (vcpkg will install dependencies automatically)
meson setup builddir

# Compile
meson compile -C builddir

# Install (optional)
meson install -C builddir

aubio uses meson-python for Python packaging.

# Install from source directory
pip install .

# Or build a wheel
pip wheel . --no-deps

# Install uv if you haven't already
pip install uv

# Build a wheel
uv build --wheel

# Install the wheel
pip install dist/aubio-*.whl

Common build options (use with meson setup -Doption=value builddir):

• -Dexamples=true/false - Build example programs (default: false)
• -Dtests=true/false - Build test suite (default: false)
• -Ddocs=true/false - Build documentation (default: false)
• -Ddouble=true/false - Compile in double precision (default: false)

Example:

meson setup builddir -Dexamples=true -Dtests=true
meson compile -C builddir
meson test -C builddir

Windows: Requires MSVC or MinGW-w64. The shared library is not built on Windows by default (only static library and Python extension).

macOS: Automatically detects and uses the Accelerate framework for optimized FFT operations.

Linux: Install optional dependencies for additional features:

• libsndfile-dev - For audio file I/O
• libsamplerate-dev - For sample rate conversion
• libfftw3-dev - For FFTW3 FFT implementation
• libjack-dev - For JACK audio support

For comprehensive build documentation, see:

• doc/building.rst - Complete build guide
• doc/meson_reference.rst - Quick reference for common tasks

Please use the DOI link above to cite this release in your publications. For more information, see also the about page in aubio manual.

Original aubio project: https://aubio.org/
This fork (aubio-ledfx): https://github.com/LedFx/aubio-ledfx

aubio is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This fork maintains the same license as the original aubio project.

Patches are welcome: please fork the latest git repository and create a feature branch. Submitted requests should pass all continuous integration tests.

This repository includes automated environment setup for GitHub Copilot Coding Agent. The .github/copilot-setup-steps.yml file ensures that Copilot has all necessary build tools, dependencies, and testing infrastructure pre-installed. For details, see .github/COPILOT_SETUP_README.md.

For optimization and modernization priorities, see:

• OPTIMIZATION_SUMMARY.md - Quick reference guide
• OPTIMIZATION_ROADMAP.md - Detailed implementation roadmap