py-canberra 0.0.4

Wrappers for the libcanberra sound-playing interface

py-canberra is a Python interface to the libcanberra sound-playing library for Linux.

Full documentation is available here

Dependencies

The only dependency is libcanberra, which can usually be installed from your package repository as libcanberra.

# Ubuntu
apt install libcanberra0

# RHEL / CentOS
yum install libcanberra

# Arch
pacman -S libcanberra

Installation

py-canberra includes binary distributions for many platforms through PyPI

pip install py-canberra

Quickstart

Oftentimes, if libcanberra is installed, some default system sounds will be installed to /usr/share/sounds, including a bell sound

import canberra
canberra.play(event_id='bell')

import time
time.sleep(0.5)  # wait for the sound to finish playing

This plays /usr/share/sounds/freedesktop/stereo/bell.oga on the default output device.