spotify

pedalboard: Process Audio in Python with JUCE

Spotify's Pedalboard is a Python audio library built on JUCE 6 for reading, writing, rendering and adding effects to audio. It supports macOS, Windows and Linux, including VST3 plugins across platforms and Audio Units on macOS.

Stars
6.4k
Forks
363
Stars, last 30 days
+126
Last commit
15 days ago
Contributors
39

Our take

Activeregular commits and releases

Health score

44/100

How it is scored
Activity
59
Community
46
Issues
41
Pull requests
31

+126 stars in the last 30 days

  • Slower to merge pull requests than 94% of the projects we track

Pedalboard is an actively maintained, cross-platform audio toolkit with broad plugin support, though its GPL licensing and concentrated contributor activity merit attention before adopting it in a team product.

Good fit if

  • You need audio I/O and effects inside Python, including VST3 support on macOS, Windows and Linux.
  • Your work involves audio research, machine-learning augmentation, or automated audio rendering.
  • GPL-3.0 is compatible with how you plan to distribute or use your software.

Look elsewhere if

  • Your project cannot meet the obligations of GPL-3.0 or the licenses of bundled dependencies.
  • You need a project whose development is broadly distributed across contributors. Although 39 contributors are recorded, most contributions come from one person.
  • Your needs depend on Audio Unit plugins outside macOS, where the README documents Audio Unit support only for macOS.
All health signals
Last commit2026-10-07 (15 days ago)
Commits, last 90 days38
Releases, last 12 months7 (latest v0.9.26, 2026-10-07)
Contributors39 (top contributor: 86% of commits)
Issues closed, last 90 days7 (typically closed in 107 days)
Pull requests merged, last 90 days8 (typically merged in 9 days)
Project age5 years

Checked on 2026-10-23 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

6,487

Forks

379

Change since Nov 16, 2026: +3 stars·+1 forks

Overview

Spotify's Pedalboard is a Python library for audio processing built on JUCE 6, whose core audio processing code it uses. It lets Python applications read and write audio, apply effects, and load third-party software instruments and effects. It supports macOS, Windows and Linux, with Audio Unit support on macOS.

The library is aimed at people who need studio-style audio processing in Python, including audio researchers, machine-learning developers augmenting training data, and creators who want to process audio without a digital audio workstation. It can work with files, streams and TensorFlow data pipelines.

Key Features

  • Reads and writes common audio formats including AIFF, FLAC, MP3, OGG and WAV, with additional formats depending on platform.
  • Applies built-in effects for dynamics, filters, spatial processing, pitch shifting, distortion and quality reduction.
  • Loads VST3 instruments and effects on macOS, Windows and Linux, and Audio Units on macOS.
  • Processes audio in chunks and supports on-the-fly resampling, including streaming audio with AudioStream.
  • Chains, nests or mixes plugins using Pedalboard objects.
  • Releases Python's Global Interpreter Lock during processing, enabling work across multiple CPU cores.
  • Works in TensorFlow tf.data pipelines.

Use Cases

  • Audio researchers can apply effects and transformations to audio as part of Python experiments.
  • Machine-learning teams can augment training audio in TensorFlow data pipelines.
  • Musicians and producers can batch-process recordings with effect chains without opening a digital audio workstation.
  • Developers can build Python applications that render audio through VST3 instruments or effects.
  • Users can process live input through effects when a real-time audio stream fits their setup.

What you need

Detected in the repository

  • Python >=3.10 (from pyproject.toml)
  • A test suite and automated checks on GitHub Actions

License in plain words

GPL-3.0strong copyleft

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license notice
  • Share your changes: yes, the full source of anything you distribute that includes it, under the GPL
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install from PyPI:

pip install pedalboard

See the README and documentation for setup details, examples and API reference.

Alternatives

  • TimeSide: TimeSide focuses on extensible audio and video analysis, streaming, and collection workflows, while Pedalboard centers on audio effects and plugin hosting.
ProjectLanguageLicenseStarsStatus
pedalboardC++GPL-3.06.4kActive
TimeSidePythonAGPL-3.0393Inactive

Considerations

Pedalboard is active, with regular commits and releases, but contributor activity is concentrated in one person. Recent issue handling is comparatively slow, with a median close time of 107 days, so teams with unresolved issues should account for that when evaluating support expectations. The project requires Python 3.10 or newer. Platform and plugin compatibility vary: Linux x86-64 wheels require AVX support, and the README notes that many Linux VSTs need glibc newer than 2.27. The project uses GPL-3.0 and includes dependencies with their own licensing terms, which teams should review for their distribution plans.

Found this useful?

Share it with someone who would like pedalboard.

Comparisons