Skip to main content

🔊 Play music and sounds in your Python scripts

Project description

Play sounds in your Python scripts

This project provides a simple cross-platform API to play sounds in your Python scripts, and allows you to play sounds while a function or code block executes, or afterwards.

It's a simple wrapper over playsound and boombox.

I use this project in onhold and ding.

Rationale

boombox is great and 90% of the way there, however the default options for playing sounds on Windows are limited to WAV files. If the platform is Windows, play_sounds will default to the playsound backend.

Installation

python3 -m pip install play_sounds

Usage

This library uses pathlib.Path objects when pointing to filenames and paths.

Playing a file

from play_sounds import play_file, DEFAULT_SONG

play_file(DEFAULT_SONG)  # blocks by default

# play without blocking
play_file(DEFAULT_SONG, block=False) 

Playing while work completes

from time import sleep
from play_sounds import play_while_running, DEFAULT_SONG

with play_while_running(DEFAULT_SONG):
  sleep(60)

Play sound after work completes

from time import sleep
from play_sounds import play_after, DEFAULT_SOUND

with play_after(DEFAULT_SOUND):  # blocks by default
  sleep(60)

# play without blocking
with play_after(DEFAULT_SOUND, block=False):
  sleep(60)

Copyright

See CREDIT.md.

License

See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

play_sounds-0.1.2.tar.gz (3.5 kB view details)

Uploaded Source

Built Distribution

play_sounds-0.1.2-py2.py3-none-any.whl (7.5 MB view details)

Uploaded Python 2Python 3

File details

Details for the file play_sounds-0.1.2.tar.gz.

File metadata

  • Download URL: play_sounds-0.1.2.tar.gz
  • Upload date:
  • Size: 3.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.6

File hashes

Hashes for play_sounds-0.1.2.tar.gz
Algorithm Hash digest
SHA256 16a6192a675f10f225789d0e4076997cb2c04d10583eaba6d3e0c6bdec270386
MD5 21cd538b8eb32446300b91ed79569296
BLAKE2b-256 65015ea2eb8197401dac1632bc0b6093307e4ab6ca88b7a8b6b36991ffa08822

See more details on using hashes here.

File details

Details for the file play_sounds-0.1.2-py2.py3-none-any.whl.

File metadata

  • Download URL: play_sounds-0.1.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 7.5 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.6

File hashes

Hashes for play_sounds-0.1.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 92ab00e28678c3b01a574efe068e34d5bf468ac210bd48a6b14b5ac92f7a48d5
MD5 5d1b7226b29103e982aff99b15b83f91
BLAKE2b-256 d9f00e4d2dbbad97ebb42430744c2b2ff14f36c2f8980d2f709ac9d873fd4e09

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page