This package is the Python version of spAudio library providing spaudio module which enables fullduplex audio device I/O and spplugin module which enables plugin-based file I/O supporting many sound formats including WAV, AIFF, MP3, Ogg Vorbis, FLAC, ALAC, raw, and more. The spplugin module also supports 24/32-bit sample size used in high-resolution audio files, so you can easily load data with 24/32-bit sample size into NumPy’s ndarray.


You can use pip command to install the binary package:

pip install spaudio

If you use Anaconda or Miniconda , conda command with “bannohideki” channel can be used:

conda install -c bannohideki spaudio

NumPy package is needed only if you want to use NumPy arrays. If you don’t use NumPy arrays, no external package is required. Note that this package doesn’t support Python 2.

The linux version also requires spPlugin installation (audio device I/O requires the pulsesimple plugin based on PulseAudio ). You can install it by using dpkg (Ubuntu) or rpm (CentOS) command with one of the following packages.

If you want to use apt (Ubuntu) or yum (CentOS), see this page (for Ubuntu) or this page (for CentOS) .

Change Log

  • Version 0.7.16

    • Added high-level functions of audioread and audiowrite to spplugin module.

    • Added functions of readframes/readrawframes and writeframes/writerawframes to spaudio module and spplugin module.

    • Changed some specification of spplugin.

  • Version 0.7.15

    • Added function to spaudio module.

    • Added support for open call of spaudio module with keyword arguments.

  • Version 0.7.14

    • Added spplugin module which enables plugin-based audio file I/O.

  • Version 0.7.13

    • Initial public release.


To build this package, the following are required.