---
id: pydub-stubs
version: "0.25.1.6"
license: ISC
license_treatment: permissive
maintenance: aging
---

# pydub-stubs — Stub-only package containing type information for pydub

License: permissive · Maintenance: aging · Downloads: 109.9K/mo

## What it is and what it does

Pydub-stubs is a type stub package that adds static type information to Pydub, the Python audio processing library. It works alongside Pydub to enable type checkers and IDEs to understand Pydub's API, providing autocompletion and catching type errors at development time rather than runtime. The stubs cover Pydub's public interface and some undocumented functions, including AudioSegment methods, effects, generators, and utility modules.

You install it as a companion to Pydub itself—it contains no runtime code, only type definitions. It depends only on typing-extensions and supports Python 3.9 through 3.13. The package is maintained to track Pydub releases, with recent fixes addressing function signatures and method availability on AudioSegment.

Use it for:

- Add type checking to audio processing scripts that use Pydub, catching parameter mismatches before runtime.
- Enable IDE autocompletion and inline documentation for Pydub methods while editing code.
- Validate Pydub usage in a typed codebase that enforces strict type checking.
- Document expected parameter types and return values for Pydub operations in team projects.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for Pydub, enabling static type checking and IDE autocompletion when working with Pydub's audio processing library.

Yes, if you use Pydub and want static type checking. Install it alongside Pydub to gain IDE support and type safety with minimal friction. The aging maintenance status is a minor concern but acceptable for a stable type stub that tracks a mature library. No security vulnerabilities and permissive licensing make it a low-risk addition.

## Install

pip install pydub-stubs
uv add pydub-stubs
poetry add pydub-stubs

## Installing pydub-stubs

Before you install: Low install friction with a single lightweight runtime dependency (typing-extensions). Repository shows aging maintenance but remains active with no archived status; suitable for projects already using Pydub that need type safety.

License in practice: ISC license is permissive and poses no restrictions on use, modification, or distribution in commercial or private projects.

Quickstart:

pip install pydub-stubs

from pydub import AudioSegment

audio = AudioSegment.from_file("file.mp3")

Requires Pydub itself to be installed separately; type stubs alone do not provide audio functionality.

Verify before relying:

- Whether type coverage extends to all Pydub modules or only the public API as stated
- Compatibility guarantees with Pydub versions other than 0.25.1
- How frequently the stubs are updated relative to new Pydub releases

## Package facts

- License: ISC (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 109.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pydub type stubs, pydub type hints, audio processing type checking, pydub typing support, static type checking audio, pydub mypy support, type-stubs, audio-processing

[View on SkillFed](https://skillfed.io/packages/pydub-stubs) · [View on PyPI](https://pypi.org/project/pydub-stubs/)