A simple Pythonic interface for libsoundio.
libsoundio is a robust, cross-platform solution for real-time audio. It performs no buffering or processing on your behalf, instead exposing the raw power of the underlying backend.
You can use pip to download and install the latest release with a single command.
pip3 install pysoundio
See examples directory.
Some of the examples require PySoundFile
pip3 install soundfile
On Windows and OS X, this will also install the library libsndfile. On Linux you will need to install the library as well.
Ubuntu / Debian
apt-get install libsndfile1
:download:`devices.py <../examples/devices.py>`
List the available input and output devices on the system and their properties.
python devices.py
:download:`record.py <../examples/record.py>`
Records data from microphone and saves to a wav file. Supports specifying backend, device, sample rate, block size.
python record.py out.wav --device 0 --rate 44100
:download:`play.py <../examples/play.py>`
Plays a wav file through the speakers. Supports specifying backend, device, block size.
python play.py in.wav --device 0
:download:`sine.py <../examples/sine.py>`
Plays a sine wave through the speakers. Supports specifying backend, device, sample rate, block size.
python sine.py --freq 442
To run the test suite.
tox -r
If you wish to use your own build of libsoundio (perhaps you want Jack enabled) then build from source and install it globally and reinstall pysoundio.
Note: PySoundIo only works with libsoundio versions >= 1.1.0