pedalboard

Pedalboard is a Python library from Spotify's Audio Intelligence Lab for working with audio: reading, writing, rendering, and applying effects. It supports common audio file formats and a range of built-in effects, and can load third-party VST3 and Audio Unit instruments and effects. Key capabilities described in the README: - Audio I/O utilities (pedalboard.io): read and write AIFF, FLAC, MP3, OGG, and WAV on all platforms without extra dependencies; additional formats such as AAC, AC3, and WMA depending on platform; on-the-fly resampling with O(1) memory usage; live audio effects through AudioStream. - Built-in effects: guitar-style effects (Chorus, Distortion, Phaser, Clipping), loudness and dynamics (Compressor, Gain, Limiter), equalizers and filters (HighpassFilter, LadderFilter, LowpassFilter), spatial effects (Convolution, Delay, Reverb), pitch effects (PitchShift), lossy compression (GSMFullRateCompressor, MP3Compressor), and quality reduction (Resample, Bitcrush). - Plugin support: VST3 instruments and effects on macOS, Windows, and Linux via pedalboard.load_plugin; Audio Units on macOS. - Performance and threading: releases the Python GIL to use multiple CPU cores; the README states single-thread processing is up to 300x faster than pySoX for single transforms and 2-5x faster than SoxBindings, and file reading is up to 4x faster than librosa.load in many cases. - TensorFlow compatibility: usable in tf.data pipelines. Installation is via pip (pip install pedalboard), with platform wheels for Linux (manylinux and musllinux, x86_64 and aarch64), macOS (Intel and Apple Silicon), and Windows (amd64). The README says it is tested with Python 3.10 through 3.15. Examples in the README cover a quick start reading and writing a WAV file through a Pedalboard, building a guitar-style effects chain, loading VST3 or Audio Unit plugins and rendering MIDI to audio, creating parallel effect chains with the Mix plugin, processing live audio with AudioStream, and using Pedalboard inside a tf.data pipeline. Pedalboard is licensed under GPLv3 and bundles several statically compiled libraries, including JUCE 6, the VST3 SDK, Rubber Band, FFTW, libmp3lame, libgsm, and dr_wav, each with its own license terms as listed in the README.