multi-library, cross-platform audio decoding
Project description
Decode audio files using whichever backend is available. The library currently supports:
Gstreamer via gst-python.
Core Audio on Mac OS X via ctypes. (PyObjC not required.)
FFmpeg via its command-line interface.
The standard library wave and aifc modules (for WAV and AIFF files).
Use the library like so:
with audioread.audio_open(filename) as f:
print(f.channels, f.samplerate, f.duration)
for buf in f:
do_something(buf)
Buffers in the file can be accessed by iterating over the object returned from audio_open. Each buffer is a buffer or str object containing raw 16-bit little-endian signed integer PCM data. (Currently, these PCM format parameters are not configurable, but this could be added to most of the backends.)
Additional values are available as fields on the audio file object:
channels is the number of audio channels (an integer).
samplerate is given in Hz (an integer).
duration is the length of the audio in seconds (a float).
The audio_open function transparently selects a backend that can read the file. (Each backend is implemented in a module inside the audioread package.) If no backends succeed in opening the file, a DecodeError exception is raised. This exception is only used when the file type is unsupported by the backends; if the file doesn’t exist, a standard IOError will be raised.
Audioread is “universal” and supports both Python 2 (2.6+) and Python 3 (3.2+). The GStreamer backend currently only supports 2.x since gst-python is 2.x-only.
Future Work
Possible additional backends:
PyOgg?
Other command-line tools?
Example
The included decode.py script demonstrates using this package to convert compressed audio files to WAV files.
Version History
- 1.2.0
Add support for FFmpeg on Windows (thanks to Jean-Christophe Saad-Dupuy).
- 1.1.0
Add support for Sun/NeXT Au files via the standard-library sunau module (thanks to Dan Ellis).
- 1.0.3
Use the rawread (standard-library) backend for .wav files.
- 1.0.2
Send SIGKILL, not SIGTERM, to ffmpeg processes to avoid occasional hangs.
- 1.0.1
When GStreamer fails to report a duration, raise an exception instead of silently setting the duration field to None.
- 1.0.0
Catch GStreamer’s exception when necessary components, such as uridecodebin, are missing. The GStreamer backend now accepts relative paths. Fix a hang in GStreamer when the stream finishes before it begins (when reading broken files). Initial support for Python 3.
- 0.8
All decoding errors are now subclasses of DecodeError.
- 0.7
Fix opening WAV and AIFF files via Unicode filenames.
- 0.6
Make FFmpeg timeout more robust. Dump FFmpeg output on timeout. Fix a nondeterministic hang in the Gstreamer backend. Fix a file descriptor leak in the MAD backend.
- 0.5
Fix crash when FFmpeg fails to report a duration. Fix a hang when FFmpeg fills up its stderr output buffer. Add a timeout to ffmpeg tool execution (currently 10 seconds for each 4096-byte read); a ReadTimeoutError exception is raised if the tool times out.
- 0.4
Fix channel count detection for FFmpeg backend.
- 0.3
Fix a problem with the Gstreamer backend where audio files could be left open even after the GstAudioFile was “closed”.
- 0.2
Fix a hang in the GStreamer backend that occurs occasionally on some platforms.
- 0.1
Initial release.
Et Cetera
audioread is by Adrian Sampson. It is made available under the MIT license. An alternative to this module is decoder.py.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file audioread-1.2.0.tar.gz.
File metadata
- Download URL: audioread-1.2.0.tar.gz
- Upload date:
- Size: 13.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3e1ca455bbca131854a432e4acda6852c318ae165be60f74f3bdc6a91a98d35c |
|
| MD5 | 267a548d7786c7c16508f89842e134da |
|
| BLAKE2b-256 | 89d7addbce6873ca1b1a8e1a87f9645d8054dbe195adb267af3a0bb52bb73e69 |
