Skip to main content

Play notification sounds.

Project description

beepy is a Python language module that allows users to easily play notification sounds on Linux, OSX and Windows. It only works under Python 3.

It is intended to be used when you are running a long analysis in the background and want to know when it is ready.

Example Use

import beepy
beep(sound=1) # integer as argument
beep(sound='coin') # string as argument


Currently, beepy only runs on Python 3.

beepy relies on a Python package called simpleaudio which can be also be installed using: pip install simpleaudio.


To install, type: pip install beepy.


sound argument takes eitheer integers (1-7) or string (from the list below) as argument.

Following are the mappings for the numbers: 1 : 'coin', 2 : 'robot_error', 3 : 'error', 4 : 'ping', 5 : 'ready', 6 : 'success', 7 : 'wilhelm'


beepy is currently at pre-alpha stage. But reports can be posted on Github at a later date.


  • Prabesh Dhakal - Initial Work


This project is licensed under the MIT License - see the file for details.


  • beepr The main motivation behind this package is another R package by the name of beepr. I could not find an equivalent for Python, so decided to make my own version of it. You can learn more about beepr here.

  • simpleaudio This package is built on top of another package named simpleaudio, and would not be possible in its absence. While it is largely based on simpleaudio, beepy is not meant to replace the simpleaudio package. My sincere thanks to hamiltron for creating simpleaudio.

  • Sound Files All sound files used in this package come from and were Creative Commons 0 1.0 Universal (CC0 1.0) licenced at the time of creation of this project.

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

beepy-1.0.7.tar.gz (1.3 MB view hashes)

Uploaded Source

Built Distribution

beepy-1.0.7-py3-none-any.whl (1.3 MB view hashes)

Uploaded Python 3

Supported by

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