pydub-stubs

Pydub version: 0.25.1

pydub-stubs provides type information for Pydub.
Only the public interface is guaranteed to be typed, however there are type definitions for some private and undocumented functions.

pip install pydub-stubs

Anticipated Questions

Q: What is `_Metadata` and `_PartialMetadata`?

These are legacy types that have been replaced by the channels, frame_rate, and sample_rate keyword arguments.

Changelog

Version 0.25.1.6

Fixed incorrect undocumented fix_wav_headers function signature
Previously, the function signature was defined as taking a bytes, but this is incorrect as the function mutates the value. The signature has been updated to bytearray. (Fixes #8)

Version 0.25.1.5

Fixed incorrect WhiteNoise generator name
Previously, the generator was incorrectly named Whitenoise. (#7 - thanks, @Kakadus!)

Version 0.25.1.4

Added "effect" functions as methods on AudioSegment
The methods have always been accessible on AudioSegment, but since they are not defined on the class, they were not previously defined in the type stubs. Note that if pydub.scipy_effects is imported, the effect methods may have slightly different definitions.

Version 0.25.1.3

Added typing.BinaryIO to _PathLike
Pydub supports using an IO object in place of a file for both creating and exporting AudioSegments. (Fixes #5)

Version 0.25.1.2

Added pathlib.Path to _PathLike
Allows you to use Path objects in place of strings. (thanks, @qthequartermasterman!)

Version 0.25.1.1

Removed literal type fallback overloads
The fallbacks removed all the advantages of using literals at all.
Modernized the type stubs
Uses new union syntax, and more. (#2 and #3 - thanks, @Viicos!)
Add WavSubChunk, WavData, and undocumented functions
These previously existed and were available but were untyped. (thanks again, @Viicos!)

Previous versions

Version 0.25.1.0

Added v0.25.0 features
This includes pydub.scipy_effects.eq and new classmethod parameters.
Signatures now use literals where possible
Overloaded implementations exist as a fallback.
Added missing modules
pydub.silence and pydub.utils

Version 0.24.1.9

Add undocumented parameter of AudioSegment.from_file
read_ahead_limit is absent from the documentation but is a supported keyword argument.

Version 0.24.1.8

Export other modules
Adds exports for effects, exceptions, generators, playback, and scipy_effects

Version 0.24.1.7

Added AudioSegment._spawn (again)
This was accidentally removed in an earlier version.
Improved pydub.effects.invert_phase
This is technically less accurate as (0, 0) is equivalent to (0, 1).

Version 0.24.1.6

Removed testing symbols from pydub.audio_segment

Version 0.24.1.5

Fixed AudioSegment.export
First param is named out_f and isn't required.

Version 0.24.1.4

Improved signature of AudioSegment.from_file
The keyword arguments for raw/PCM audio don't require format to be set to either raw or pcm.
Fixed package exports
Exports AudioSegment from __init__.py.

Version 0.24.1.3

Fixed overloads of AudioSegment.fade
Exactly two of start, end, and duration must be given.

Version 0.24.1.2

Improved AudioSegment.fade
Changed to use overloads to prevent invalid method calls.
Improved AudioSegment.from_mono_audiosegments
Use a positional-only parameter to ensure there's at least 1 argument.

Version 0.24.1.1

Fixed AudioSegment.__init__
Use overloads to model correct parameters.
Fixed AudioSegment._spawn
Parameter overrides accepts a partial dictionary.
Fixed pydub.scipy_effects.high_pass_filter
Parameter order should be int, not float.

Version 0.24.1.0

Released

Metadata

Release files for pydub-stubs 0.25.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pydub-stubs 0.25.1.6
File	Size	Uploaded	Provenance
pydub_stubs-0.25.1.6.tar.gz	8.6 kB	Apr 11, 2025	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for pydub-stubs 0.25.1.6
File	Interpreter	ABI	Platform	Reset
pydub_stubs-0.25.1.6-py3-none-any.whl 9.5 kB Apr 11, 2025 Without provenance	Python 3	none	any	Details

Total release size: 18.1 kB

Release files / pydub_stubs-0.25.1.6.tar.gz

Download URL	pydub_stubs-0.25.1.6.tar.gz
Size	8.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`38e9a1e490b11e9fdd3c5a0b01667e2d959c817aadb56555b124c6c8be028ff5`
BLAKE2b-256 checksum How to use checksums	`5c282ae85a1671861ee88235c3bd50f495a80562003f22ab4223af6c8dfcbfc2`
Upload date	Apr 11, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.4 CPython/3.12.6 Darwin/24.4.0`

Release files / pydub_stubs-0.25.1.6-py3-none-any.whl

Download URL	pydub_stubs-0.25.1.6-py3-none-any.whl
Size	9.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`235be0707485c48fe3d6537c751171bfeca21480c914e7e7bc9db2d6ed65f8ae`
BLAKE2b-256 checksum How to use checksums	`529ec286937e56d47c97ce2221456b7779abf6449fd41d78a8fb9d2b13065b8c`
Upload date	Apr 11, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.8.4 CPython/3.12.6 Darwin/24.4.0`

Security for pydub-stubs 0.25.1.6

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.