harcokuppens / py-simple-audio Goto Github PK

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.