audioio 2.0.0

Platform independent interfacing of numpy arrays of floats with audio files and devices.

AudioIO

Platform independent interfacing of numpy arrays of floats with audio files and devices.

Documentation | API Reference

The AudioIO modules try to use whatever audio packages are installed on your system to achieve their tasks. AudioIO, however, adds own code for handling metadata and marker lists.

See installation for further instructions and recommendations on additional audio packages.

Features

• Audio data are always numpy arrays of floats (np.float64) with values ranging between -1 and 1 ...
• ... independent of how the data are stored in an audio file.
• load_audio() function for loading a whole audio file.
• Blockwise random-access loading of large audio files (class AudioLoader).
• blocks() generator for iterating over blocks of data with optional overlap.
• write_audio() function for writing data, metadata, and markers to an audio file.
• Read metadata() as nested dictionaries of key-value pairs.
• Read markers(), i.e. cue points with spans, labels, and descriptions.
• Platform independent, synchronous (blocking) and asynchronous (non blocking) playback of numpy arrays via play().
• Automatic resampling of data for playback to match supported sampling rates.
• Detailed and platform specific installation instructions (pip, conda, Debian and RPM based Linux packages, homebrew for MacOS) for all supported audio packages (audiomodules).