Skip to main content

A short, cross-platform, pure-python audio file player and tone-generating module.

Project description

             ┏┓ ┏━┓┏━┓┏┳┓┏┓ ┏━┓╻ ╻
    ╺━╸╺━╸   ┣┻┓┃ ┃┃ ┃┃┃┃┣┻┓┃ ┃┏╋┛   ╺━╸╺━╸
       ╺━╸   ┗━┛┗━┛┗━┛╹ ╹┗━┛┗━┛╹ ╹   ╺━╸

               ╭══════════════╮
╭───────────┬──┴──────────────┴──┬───────────╮
│(0) ___    │ ⯀  [:::::::] [] ( )│    ___ (0)│
│  /:::::\  │────────────────────│  /:::::\  │
│ |:::::::| │  │   ──    ──   │  │ |:::::::| │
│ |:::::::| │  │ ─(⚙)────(⚙)─ │  │ |:::::::| │
│  \:::::/  │  │────▯▯▯▯▯▯────│♫ │  \:::::/  │
╰────────────────────────────────┴───────────╯
Image: There's no stoppin' us!

This is a small cross-platform audio-file player module, useful for plain-to-fancy system sound events, rings, beeps, and the like. I couldn’t find a good one for this. “playsound” was very close at first glance but had a number of issues and has not been updated in a while.

BoomBox can wait for the file to finish or play in the background. It tries hard to support Windows, Mac, and Linux, and mostly succeeds. Though you could play an eight-minute Grateful Dead jam with it, you probably wouldn’t want to.

Usage

Quick start—a cross-platform player looks like this:

from boombox import BoomBox  # power on

boombox = BoomBox("There's_no_stoppin_us.ogg")  # load cassette

boombox.play()  # hit the ⏯ button

The play function also returns the instance, so if in a hurry one could do:

boombox = BoomBox(slow_jam).play()  # or
BoomBox(slow_jam).play()

The latter less efficient for multiple calls, of course. There are a number of other keyword parameters that can be passed. Such as:

  • wait
  • timeout_ms
  • duration_ms
  • binary_path (ChildBoomBox only, to a CLI player)

Not all arguments are supported on every implementation, but they will not balk if given.

Implementations

There are a number of underlying implementations if you’d like to pick a specific one and bypass the platform default:

  • Windows
    • WinBoomBox (default, wav only)
    • PyAudioBoomBox - PyAudio (wav only)
    • ChildBoomBox - Command-line player (powershell, others)
  • Mac OSX:
    • MacOSBoomBox - PyObjc (default, multiformat)
    • PyAudioBoomBox - PyAudio (wav only)
    • ChildBoomBox - Command-line player (afplay, others)
  • POSIX:
    • GstBoomBox - Gstreamer (default, multiformat)
    • PyAudioBoomBox - PyAudio (wav only)
    • ChildBoomBox - Command-line player (paplay, aplay, others)

Simply add an import to your script to choose a different one:

from boombox import PyAudioBoomBox as BoomBox

You may have to install one of the audio libraries above for all of the functionality of Boom Box to work.

⏵ pip install --user boombox[all]  # or pyaudio, pyobjc, pygobject, etc

Playback Control

╭───────────────────────────────────────────╮
│ ╭───────────────────────────────────────╮ │
│ │ ╭───────────────────────────────────╮ │ │
│ │ │ /\ :  Electric Boogaloo     90 min│ │ │
│ │ │/──\: .....................  NR [✓]│ │ │
│ │ ╰───────────────────────────────────╯ │ │
│ │      //─\\   ╭....:....╮   //─\\      │ │
│ │     ││( )││  │)       (│  ││( )││     │ │
│ │      \\─//   ╰....:....╯   \\─//      │ │
│ │       _ _ ._  _ _ .__|_ _.._  _       │ │
│ │      (_(_)│ |(_(/_│  │_(_||_)(/_      │ │
│ │               low noise   |           │ │
│ ╰─────── ─────────────────────── ───────╯ │
│        /    []             []    \        │
│       /  ()                   ()  \       │
╰──────/─────────────────────────────\──────╯

A simple playback interface is returned by the instance:

boombox.stop()  # Enough!
boombox.play()  # One more time!

Tone Generation

Tones may be generated like so:

boombox.play_tone(frequency_hz, duration_ms, volume=.1)
▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂▂
╲▂▂▂▂╱╲▂▂▂▂╱╲▂▂▂
▔╲▂▂▂╱▔╲▂▂▂╱▔╲▂▂
▔▔╲▂▂╱▔▔╲▂▂╱▔▔╲▂
▔▔▔╲▂╱▔▔▔╲▂╱▔▔▔╲
▔▔▔▔╲╱▔▔▔▔╲╱▔▔▔▔
▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔

┏┓╻┏━┓   ┏━┓┏┓╻┏━╸   ╺┳┓┏━┓┏━╸┏━┓   ╻╺┳╸   ┏┓ ┏━╸╺┳╸╺┳╸┏━╸┏━┓   ╻
┃┗┫┃ ┃   ┃ ┃┃┗┫┣╸     ┃┃┃ ┃┣╸ ┗━┓   ┃ ┃    ┣┻┓┣╸  ┃  ┃ ┣╸ ┣┳┛   ╹
╹ ╹┗━┛   ┗━┛╹ ╹┗━╸   ╺┻┛┗━┛┗━╸┗━┛   ╹ ╹    ┗━┛┗━╸ ╹  ╹ ┗━╸╹┗╸   ╹

Project details


Release history Release notifications

This version

0.56

Download files

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

Files for boombox, version 0.56
Filename, size File type Python version Upload date Hashes
Filename, size boombox-0.56-py2.py3-none-any.whl (12.0 kB) File type Wheel Python version 3.7 Upload date Hashes View
Filename, size boombox-0.56.tar.gz (9.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page