audioread
Multi-library, cross-platform audio decoding.
Decision gist · record as of 2026-08-14
Yes. audioread is actively maintained, has no known vulnerabilities, minimal install friction, and solves a real cross-platform problem. Install it if you need to read audio files and want to avoid tight coupling to a specific decoder library. The main caveat is that you must have at least one compatible backend available on your system; pure Python installation is not enough for compressed formats.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires at least one audio backend installed on the system (GStreamer, FFmpeg, Core Audio on macOS, or MAD); pure Python installation alone cannot decode compressed formats.
- Low install friction with only two standard library runtime dependencies.
- Actively maintained with recent releases; last commit 2026-04-09 and 538 repository stars indicate ongoing support.
License · maintenance · safety
MIT (permissive) — MIT license is permissive, allowing use in commercial and proprietary projects with minimal restrictions beyond attribution.
last release 2025-10-26 (292 days) · last repo commit 2026-04-09 · 538 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 9,702,304 downloads/mo, #1,504 on PyPI
Alternatives
Verify before relying
import audioread
with audioread.audio_open('file.mp3') as f:
print(f.channels, f.samplerate, f.duration)
for buf in f:
# buf is raw 16-bit little-endian signed integer PCM data
process(buf)- Whether all listed backends (GStreamer, Core Audio, MAD, FFmpeg, Libav) are equally well-maintained or if some are deprecated in practice.
- Performance characteristics when handling large audio files or real-time streaming scenarios.
- Exact behavior and error handling when multiple backends are available and could handle the same format.
What it is and what it does
audioread is a Python library that abstracts away the complexity of choosing an audio decoder by automatically selecting an available backend to read audio files. It supports multiple decoding strategies—GStreamer, Core Audio on macOS, MAD, FFmpeg/Libav via command-line, and Python's standard library modules for uncompressed formats—and presents a unified interface regardless of which backend succeeds. You open an audio file with a context manager, access metadata like channel count, sample rate, and duration, and iterate over raw PCM buffers (16-bit little-endian signed integers) without needing to know which decoder is running underneath.
The library is designed for developers who need to read audio in Python but want to avoid hard dependencies on specific external libraries. It gracefully falls back through available backends and raises a clear exception only when no suitable decoder can be found. This makes it useful in environments where different systems have different audio libraries installed, or where you want to support multiple audio formats without forcing users to install all possible decoders.
Use it for
- Convert compressed audio files (MP3, FLAC, OGG) to WAV or other formats in a cross-platform application.
- Extract audio metadata and raw PCM data from files in a music processing or analysis pipeline.
- Build audio feature extraction tools that need to read diverse audio formats without hardcoding a specific decoder.
- Integrate audio file reading into applications that run on macOS, Linux, and Windows with minimal platform-specific code.
- Process audio buffers from various sources in a real-time or batch audio application.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
audioread is actively maintained, has no known vulnerabilities, minimal install friction, and solves a real cross-platform problem. Install it if you need to read audio files and want to avoid tight coupling to a specific decoder library. The main caveat is that you must have at least one compatible backend available on your system; pure Python installation is not enough for compressed formats.
Install
audioread on PyPI
Before you install
Low install friction with only two standard library runtime dependencies. Actively maintained with recent releases; last commit 2026-04-09 and 538 repository stars indicate ongoing support.
Requires at least one audio backend installed on the system (GStreamer, FFmpeg, Core Audio on macOS, or MAD); pure Python installation alone cannot decode compressed formats.
License in practice
MIT license is permissive, allowing use in commercial and proprietary projects with minimal restrictions beyond attribution.
Quickstart
import audioread
with audioread.audio_open('file.mp3') as f:
print(f.channels, f.samplerate, f.duration)
for buf in f:
# buf is raw 16-bit little-endian signed integer PCM data
process(buf)Verify before relying
- Whether all listed backends (GStreamer, Core Audio, MAD, FFmpeg, Libav) are equally well-maintained or if some are deprecated in practice.
- Performance characteristics when handling large audio files or real-time streaming scenarios.
- Exact behavior and error handling when multiple backends are available and could handle the same format.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesstandard-aifcstandard-sunau |
| Maintenance | Actively maintained 292 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 9,702,304 / month, #1,504 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.9Topic :: Multimedia :: Sound/Audio :: Conversion |
Evidence: audioread-3.1.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “audio file decoding”
- audioreadDecode audio files using whichever backend is available on the…
- miniaudioMiniaudio provides Python bindings for cross-platform audio playback,…
- decordDecord decodes video and audio files with hardware-accelerated…
Give your agent the search over MCP, or paste the wish link into any chat.
More Conversion packages
Pydub provides a high-level Python interface for loading, manipulating, and exporting audio files with simple operations like slicing, concatenation, and format conversion.
However, the abandoned status since 2021-03-10 means no future fixes or compatibility updates—use it only if you can tolerate potential issues with newer Python…
Performs high-quality sample-rate conversion (resampling) for audio signals, supporting both one-shot and streaming modes via a Python wrapper around libsoxr.
Cloudinary Python SDK provides image and video upload, transformation, optimization, and delivery through Cloudinary's cloud platform, with built-in Django integration and secure URL generation.
Install it if you're using Cloudinary or considering a managed media platform.
Wraps LAME MP3 encoder for Python, providing bindings to encode raw PCM audio data into MP3 format with configurable bitrate, sample rate, channels, and quality settings.
Miniaudio provides Python bindings for cross-platform audio playback, recording, decoding, and sample format conversion using the miniaudio C library.
music21 is a Python toolkit for analyzing, processing, and computationally working with musical scores and MIDI data, supporting symbolic music representation and analysis workflows.
See also audiofile · standard-sunau · soundfile · playsound · standard-aifc · tinytag · silk-python · decord2 · decord