Repolode
Submit
spotify

spotify/pedalboard

A Python library for audio processing, offering file I/O, built-in effects, and VST3/Audio Unit plugin hosting.

View on GitHubWebsite
Stars
6,458
Forks
373
Open issues
149
Last commit
4 days ago

What is it?

Pedalboard is a Python library for reading, writing, resampling and processing audio. It ships with built-in effects such as Chorus, Reverb, Compressor, Delay, Distortion and PitchShift, which can be chained together into a Pedalboard object and applied to NumPy arrays.

The library can also load third-party VST3 instrument and effect plugins on macOS, Windows and Linux, and Audio Unit plugins on macOS, so developers can render MIDI through instruments or run audio through commercial effects from Python. An AudioStream object supports live audio processing through input and output devices.

Pedalboard was built by Spotify's Audio Intelligence Lab and is used internally for data augmentation in machine learning and for audio features. It releases the Python GIL so processing can use multiple CPU cores, and it can be used inside TensorFlow tf.data pipelines.

Key features

  • 01Reads and writes AIFF, FLAC, MP3, OGG and WAV files without extra dependencies.
  • 02Provides built-in effects including Chorus, Distortion, Compressor, Reverb, Delay and PitchShift.
  • 03Loads VST3 plugins on macOS, Windows and Linux, and Audio Units on macOS.
  • 04Supports real-time audio streaming through AudioStream.
  • 05Releases the GIL so audio can be processed across multiple CPU cores.

Use cases

  • Augmenting audio datasets for training machine learning models.
  • Applying effects to audio files in scripts without a Digital Audio Workstation.
  • Rendering MIDI through third-party VST3 instruments in Python.
  • Processing live guitar or microphone input with Python-defined effect chains.

Quick start

  1. 1

    Install the library from PyPI with pip

    pip install pedalboard

Things to know

  • Licensed under GPL-3.0, a copyleft license that may restrict use in proprietary products.
  • VST3 and Audio Unit plugin hosting depends on platform, and Audio Units are macOS only.
  • Some additional audio formats such as AAC, AC3 and WMA depend on the platform.

Topics

#audio#audio-processing#python#machine-learning#vst3#audio-effects#data-augmentation#audio-production#audio-research#audio-unit

FAQ

What is pedalboard?
A Python library for audio processing, offering file I/O, built-in effects, and VST3/Audio Unit plugin hosting. Pedalboard is a Python library for reading, writing, resampling and processing audio. It ships with built-in effects such as Chorus, Reverb, Compressor, Delay, Distortion and PitchShift, which can be chained together into a Pedalboard object and applied to NumPy arrays.
Is pedalboard free to use? What license does it have?
pedalboard is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is pedalboard still maintained?
Actively maintained. The last commit to pedalboard was on Nov 3, 2026.
What can I use pedalboard for?
Augmenting audio datasets for training machine learning models. Applying effects to audio files in scripts without a Digital Audio Workstation. Rendering MIDI through third-party VST3 instruments in Python. Processing live guitar or microphone input with Python-defined effect chains.
How do I install pedalboard?
Install the library from PyPI with pip: pip install pedalboard
Where can I get pedalboard?
The source code and installation instructions are on GitHub: https://github.com/spotify/pedalboard

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects