Our take
Activeregular commits and releases- 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 commit | 2026-10-07 (15 days ago) |
|---|---|
| Commits, last 90 days | 38 |
| Releases, last 12 months | 7 (latest v0.9.26, 2026-10-07) |
| Contributors | 39 (top contributor: 86% of commits) |
| Issues closed, last 90 days | 7 (typically closed in 107 days) |
| Pull requests merged, last 90 days | 8 (typically merged in 9 days) |
| Project age | 5 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.
Stars
6,487Forks
379Change 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
Pedalboardobjects. - Releases Python's Global Interpreter Lock during processing, enabling work across multiple CPU cores.
- Works in TensorFlow
tf.datapipelines.
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.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| pedalboard | C++ | GPL-3.0 | 6.4k | Active |
| TimeSide | Python | AGPL-3.0 | 393 | Inactive |
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.