pozalabs-pydub 0.38.0

Manipulate audio with an simple and easy high level interface (Pozalabs fork)

Pydub (Pozalabs Fork)

Pydub lets you do stuff to audio in a way that isn't stupid.

This is a Pozalabs fork of jiaaro/pydub, published as pozalabs-pydub on PyPI.

Changes from Upstream

Requirements

• Python 3.11+ (upstream supports Python 2.7+)
• All legacy Python 2 compatibility code has been removed

Performance (Rust/PyO3 Extensions)

• overlay_segments - Pre-allocated buffer overlay replacing audioop.add/mul (16-bit 4-5x, 32-bit 11-16x faster)
• extend_24bit_to_32bit - Zero-copy 24-bit to 32-bit sample extension via direct PyBytes allocation (~400x faster than pure Python)
• fade() - Memory-efficient fade using memoryview, with coarse/precise two-path implementation

New Features

• Compressed audio I/O - from_file() auto-detects and decompresses gzip/zstd files; export() accepts an optional compressor parameter
• Audio level metering - measure_audio_level() for RMS, peak, and LUFS measurement
• Waveform data - get_normalized_amplitudes() computes normalized amplitude values for waveform visualization
• Silent audio generation - Create silent audio matching the original segment's parameters
• Audio processing framework - Command-based processor architecture for merge, overlay, and format conversion
• Python 3.13 support - Via audioop-lts dependency

Type Safety

• Comprehensive type hints using Self, Literal, TypedDict, Unpack
• _AudioParams dataclass with validation for initialization parameters

Build System

• pyproject.toml with maturin backend, managed by uv
• Rust(PyO3) native extension compiled via maturin
• Wheel distribution via GitHub Actions

Optional Dependencies

• zstandard (>=0.23.0) - Zstandard compression (pip install pozalabs-pydub[zstd])

For general usage, API documentation, and ffmpeg setup, see the upstream README.

License

MIT License - Copyright 2011 James Robert