audiolab

What it is and what it does

audiolab is a Python library for audio file I/O and real-time processing built on top of soundfile and PyAV (FFmpeg bindings). It provides a unified interface for loading audio from local files, HTTP URLs, bytes, and streams; saving to multiple container formats; and applying filters and transformations like resampling, tempo adjustment, and pitch shifting. The library includes both a programmatic API with functions like load_audio(), save_audio(), and info(), plus classes for advanced streaming workflows (Reader, StreamReader, Writer, AudioPipe), and a command-line tool (audi) for inspecting audio file metadata.

Typical use cases include preprocessing audio for machine learning pipelines, converting between formats, extracting segments with time-based offsets, applying real-time effects during playback or batch processing, and quickly inspecting audio properties from the shell. The library abstracts away FFmpeg complexity while exposing filter chains for power users.

Use it for:

• Preprocess audio datasets for speech recognition or audio classification by loading, resampling, and converting to mono in one call.
• Apply tempo or pitch perturbation to audio files during training data augmentation using filter chains.
• Stream large audio files with real-time filtering to avoid loading entire files into memory.
• Convert audio between formats (MP3 to WAV, AAC to FLAC) and inspect metadata from the command line.
• Extract time-windowed segments from audio files with automatic resampling to a target rate.
• Build audio processing pipelines that chain multiple filters (resample, tempo, pitch) during load.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

audiolab loads, processes, and saves audio files in multiple formats (WAV, MP3, FLAC, AAC, etc.) with support for streaming, filtering, and real-time transformations via a Python interface built on soundfile and PyAV.

Yes. audiolab offers a clean, well-maintained interface to audio I/O and filtering with low install friction, permissive licensing, and no known vulnerabilities. It is suitable for audio preprocessing, format conversion, and real-time filtering tasks. Install it if you need to load and process audio files in Python without wrestling with FFmpeg directly; skip it only if you require lower-level control or have specific format constraints not listed in the documentation.

Install

audiolab on PyPI

pip install audiolab

uv add audiolab

poetry add audiolab

Installing audiolab

Before you install

Low install friction with a pure-Python wheel. Active maintenance with recent commits and no known vulnerabilities. Repository is not archived and has been actively developed since its first release.

License in practice

Apache License 2.0 is permissive; you may use, modify, and distribute audiolab and derivative works freely provided you include the license and document changes. No restrictions on commercial use.

Quickstart

pip install audiolab

from audiolab import load_audio, save_audio

# Load audio from file with resampling
audio, rate = load_audio("audio.wav", rate=16000, to_mono=True)

# Save audio to file
save_audio("output.wav", audio, rate)

Requires Python 3.8 or later. PyAV (FFmpeg bindings) and soundfile are runtime dependencies; system FFmpeg libraries may be needed depending on your platform.

Verify before relying

• Whether PyAV and soundfile system dependencies are automatically resolved or require manual installation on all platforms.
• Performance characteristics when processing large audio files or streaming from remote URLs.
• Supported audio formats beyond the examples listed (WAV, MP3, FLAC, AAC).

Package facts

Evidence: audiolab-0.5.1-py3-none-any.whl

Tags

More Graphics packages