Cross platform library to play sound files in Python.
MIT License
Cross platform library to play sound files in Python.
Install via pip:
pip install playsound3
Once installed, you can use the playsound function to play sound files:
from playsound3 import playsound
playsound("/path/to/sound/file.mp3")
# or use directly on URLs
playsound("http://url/to/sound/file.mp3")
The playsound3
module contains a single function named playsound
:
def playsound(sound, block=True, backend=None) -> None:
"""Play a sound file using an audio backend availabile in your system.
Args:
sound: Path or URL to the sound file. Can be a string or pathlib.Path.
block: If True, the function will block execution until the sound finishes playing.
If False, sound will play in a background thread.
backend: Name of the audio backend to use. Use None for automatic selection.
"""
...
It requires one argument: sound
- the path to the file with the sound you'd like to play.
This should be a local file or a URL.
There's an optional second argument: block
which is set to True
by default.
Setting it to False
makes the function run asynchronously.
You can manually specify a backend by passing its name as the third argument.
You can browse available backends by using playsound3.AVAILABLE_BACKENDS
.
It is recommended to use the default value of None
to let the library choose the best backend available.
This repository was originally forked from playsound library created by Taylor Marks. The original library is unfortunately not maintained anymore and doesn't accept pull requests. This library: playsound3
is a major rewrite of the original, including its own set of tests hosted using GitHub Actions.
Compared to the original, playsound3
: