pydub-stubs

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 on this page — 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

pydub-stubs on PyPI

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

Evidence: pydub_stubs-0.25.1.6-py3-none-any.whl

Keywords: pydub, types, typing, stubs

Tags

More Software Development packages