pydub
Manipulate audio with an simple and easy high level interface
What it is and what it does
Pydub is a Python library that abstracts away low-level audio handling to let you work with audio files through simple, intuitive operations. It handles loading audio in multiple formats, slicing and concatenating segments, adjusting volume, and exporting to different formats—all without needing to understand the underlying audio encoding details.
The package has no runtime Python dependencies, making installation lightweight. However, it has been abandoned since its last release on 2021-03-10, meaning no bug fixes, security patches, or compatibility updates have been applied. The classifiers indicate support through Python 3.8, but actual compatibility with newer versions is unverified. You will likely need external system libraries installed to handle audio codec operations.
Use it for:
- Convert audio files between formats in batch processing scripts.
- Programmatically slice, trim, or concatenate audio segments for podcast or music workflows.
- Adjust volume levels or apply basic audio transformations in automated pipelines.
- Prototype audio analysis or processing tasks requiring raw audio data manipulation.
- Build simple audio utilities without requiring a full-featured audio framework.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Pydub provides a high-level Python interface for loading, manipulating, and exporting audio files with simple operations like slicing, concatenation, and format conversion.
Yes, but with caution. Pydub remains popular and works well for straightforward audio tasks if your Python version and system dependencies align. However, the abandoned status since 2021-03-10 means no future fixes or compatibility updates—use it only if you can tolerate potential issues with newer Python versions and are willing to maintain a fork if critical bugs emerge.
Install
pydub on PyPI
pip
pip install pydubuv
uv add pydubpoetry
poetry add pydubInstalling pydub
Before you install
Installation is straightforward with no runtime Python dependencies, but the project has been abandoned since March 2021 with no recent maintenance or updates.
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.
Quickstart
pip install pydub
from pydub import AudioSegment
sound = AudioSegment.from_file('audio.mp3')
sliced = sound[:5000]
sliced.export('output.wav', format='wav')
External audio libraries (e.g., ffmpeg or libav) required for codec support; exact requirements depend on audio formats used.
Verify before relying
- Whether the package works reliably with current Python versions beyond 3.8, given the abandoned status.
- What external audio libraries (e.g., ffmpeg, libav) are required as system dependencies.
- Current compatibility with modern audio formats and codecs.
- Whether critical bugs have emerged since the last release in March 2021.
Package facts
| License | MIT (permissive) |
| Python support | not specified |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | none |
| Maintenance | abandoned — 1,983 days since the last release |
| First released | |
| Downloads | 21,038,345/month — #1,016 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: pydub-0.25.1-py2.py3-none-any.whl
Keywords: audio, sound, high-level
Tags
More Libraries packages
urllib3 is an HTTP client library that provides…
permissive · top 100 on PyPI
requestsRequests is a Python HTTP library that…
permissive · top 100 on PyPI
pluggyPluggy provides a plugin system that lets you…
permissive · top 100 on PyPI
python-dateutilProvides parsing, arithmetic, and recurrence…
permissive · top 100 on PyPI
sixSix provides utility functions to write Python…
permissive · top 100 on PyPI
pytestpytest is a testing framework that lets you…
permissive · top 100 on PyPI
pydub-stubsProvides type stubs for Pydub, enabling static…
permissive · top 15,000 on PyPI
descript-audiotoolsProvides object-oriented audio signal handling…
permissive · top 15,000 on PyPI
pycawPycaw provides programmatic control of Windows…
unclear · top 15,000 on PyPI
mediafileMediaFile reads and writes metadata tags across…
permissive · top 15,000 on PyPI
aeidonaeidon reads, writes, and manipulates…
copyleft · top 15,000 on PyPI
pulsectlProvides a high-level Python interface to…
permissive · top 15,000 on PyPI
audioop-ltsProvides the `audioop` module for Python 3.13+,…
permissive · top 5,000 on PyPI
moviepyMoviePy is a Python library for video editing…
permissive · top 5,000 on PyPI
playsoundPlays audio files (MP3, WAV) and URLs from…
permissive · top 15,000 on PyPI
soundfileReads and writes audio files in formats like…
permissive · top 1,000 on PyPI