jiaaro/pydub
Pydub
Pydub is a Python audio manipulation library and digital audio processor used for editing, slicing, and converting audio files and segments. It serves as a programmatic wrapper for FFmpeg to import and export a wide variety of audio formats.
The library functions as an audio signal generator capable of creating synthetic waveforms, such as sine waves and white noise. It also provides tools for digital signal processing, including the application of filters, fades, crossfades, and gain adjustments to sound signals.
Its broader capabilities cover programmatic audio editing through concatenation and mixing, automated audio analysis for metadata extraction and silence detection, and sample format conversion. The toolkit also supports frequency filtering, DC offset removal, and the generation of silent segments for spacing.
The library can route processed audio segments to system speakers using external playback drivers.
Features
- FFmpeg Wrappers - Acts as a programmatic wrapper for FFmpeg to handle a wide variety of audio decoding, encoding, and format conversions.
- Programmatic Audio Editing - Provides programmatic cutting, slicing, and concatenation of audio segments to automate complex sound sequences.
- Audio File Handling - Loads audio data from various file formats using custom codec or decoder parameters.
- Audio Exporters - Writes audio data to files in various formats with custom metadata tags and bitrate settings.
- Audio Concatenation - Joins multiple audio segments together sequentially to create a single continuous track.
- Audio Mixing - Overlays one audio segment onto another with options to loop the overlay or adjust volume.
- General Format Conversion - Changes audio files between different encodings, sample rates, and channel layouts for cross-platform compatibility.
- Frequency Filtering - Implements high-pass, low-pass, and band-pass filters to isolate or remove specific frequency ranges.
- Audio Slicing - Extracts specific parts of a recording using millisecond-based offsets to isolate segments.
- Decibel-Scale Volume Control - Implements logarithmic decibel math to provide intuitive volume adjustments that match human hearing.
- Python Audio Manipulation Libraries - Provides a high-level Python toolkit for editing, slicing, and converting audio files and segments.
- Raw Sample Manipulation - Provides the ability to manipulate raw audio samples as integer arrays for precise gain and phase operations.
- Sample Format Conversion - Enables changing the sample width, frame rate, and number of channels of an audio segment.
- Temporal Audio Slicing - Enables intuitive audio clip extraction by indexing data using millisecond-based time offsets.
- Gain Controls - Provides programmatic interfaces for adjusting the amplitude and gain of audio segments in decibels.
- Digital Signal Processing Libraries - Provides a library for applying filters, adjusting gain, and removing DC offset from digital sound signals.
- Audio Object Wrapping - Wraps raw audio data in high-level objects to simplify complex operations like slicing and concatenation.
- Audio Channel Decomposition - Provides the ability to decompose interleaved stereo data into separate mono streams for independent processing.
- Audio Channel Layout Conversion - Splits multi-channel audio into mono segments or combines mono segments into a multi-channel track.
- Audio Fades and Crossfades - Provides features to create smooth transitions using fades and crossfades between audio segments.
- Audio Conversion Utilities - Changes audio data from one encoding or container to another, such as converting streams to MP3.
- Sample Buffer Extraction - Provides utilities to retrieve audio samples as raw bytes or numerical arrays for use in external tools.
- Metadata Extraction - Extracts technical format details from audio files, including the codec, bitrate, and channel count.
- Signal Generation - Generates synthetic audio waveforms such as sine waves and white noise.
- Loudness Measurement - Calculates the maximum loudness of an audio segment expressed in decibels relative to full scale.
- Audio Analysis and Synthesis - Extracts metadata and detects silent periods to programmatically split or trim audio files.
- Silence-Based Splitting - Divides audio segments into smaller chunks by cutting at silent intervals.
- Silence Detection - Identifies and locates quiet periods within audio segments using configurable length and volume thresholds.
- Sound Synthesis - Creates synthetic waveforms and layers audio tracks with fades and crossfades for sound design.
- Synthetic Signal Generation - Creates synthetic audio sounds including sine waves, square waves, and white noise.
- Digital Signal Processing - High-level interface for audio manipulation.
- Audio and Video Processing - Manipulates audio files with a high-level, intuitive interface.
- Audio Processing - High-level interface for audio manipulation.
- Audio Video Processing - Listed in the “Audio Video Processing” section of the Awesome Python awesome list.
