This project is forked from https://github.com/cexen/py-simple-audio which forked it from the original project at https://github.com/hamiltron/py-simple-audio . Cexen applied a patch to make the library also work with python3.12. This repository is mainly used to build wheels for the patched simpleaudio so that we can easily install it for all python versions on all platforms. This project uses github actions workflow to build the wheels, and published them under the name "simpleaudio-patched" on pypi.
I no longer have the time to dedicate to maintaining Simpleaudio (which at this point is mostly keeping CI builds working). This project should be considered archived, meaning that there will be no further updates or builds. For anyone seriously interested in taking over the project, I would be willing to help in that process. I would also be willing to revisit maintaining the library should anyone wish to sponsor it.
The simplaudio package provides cross-platform, dependency-free audio playback capability for Python 3 on OSX, Windows, and Linux.
MIT Licensed.
Installation (make sure the pip
command is the right one for
your platform and Python version):
pip install simpleaudio
See documentation for additional installation information.
import simpleaudio.functionchecks as fc
fc.LeftRightCheck.run()
See documentation for more on function checks.
import simpleaudio as sa
wave_obj = sa.WaveObject.from_wave_file("path/to/file.wav")
play_obj = wave_obj.play()
play_obj.wait_done()
For usage and how-to questions, first checkout the tutorial in the documentation. If you're still stuck, post a question on StackOverflow and tag it 'pysimpleaudio'.
For bug reports, please create an issue on Github .
Jonas Kalderstam
Christophe Gohlke
Tom Christie
Many others for their contributions, documentation, examples, and more.