libcanberra @PACKAGE_VERSION@

Copyright 2008 Lennart Poettering <@PACKAGE_BUGREPORT@>

• License
• News
• Overview
• Current Status
• Documentation
• Requirements
• Installation
• Acknowledgements
• Download

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 2.1 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

News

Version 0.7 released; changes include: documentation updates; various bug fixes; add this web site/README; allow playback of event sounds with only a sound file path specified; other changes

Overview

libcanberra is an implementation of the XDG Sound Theme and Name Specifications, for generating event sounds on free desktops, such as GNOME. It comes with several backends (ALSA, PulseAudio, null) and is designed to be portable. It consists of the following parts:

1. libcanberra: the main library
2. libcanberra-gtk: some glue code to make it easier to use libcanberra from Gtk+ applications
3. libcanberra-gtk-module: a Gtk+ module that uses libcanberra-gtk to trigger input feedback event sounds

For more information see the original announcement.

Current Status

libcanberra is mostly feature complete. For now however it includes backends only for ALSA and PulseAudio.

libcanberra has been declared a blessed GNOME dependency.

Documentation

You may browse the gtkdoc generated programing documentation of the API.

Requirements

Currently, libcanberra is tested on Linux only.

libcanberra was developed and tested on Fedora Rawhide from August 2008, it should work on most other Linux distributions (and maybe Unix versions) since it uses GNU autoconf and GNU libtool for source code configuration and shared library management.

libcanberra has no dependencies besides the OGG Vorbis development headers and whatever the selected backends require. Gtk+ support is optional.

Installation

As this package is made with the GNU autotools you should run ./configure inside the distribution directory for configuring the source tree. After that you should run make for compilation and make install (as root) for installation of libcanberra.

Acknowledgements

None so far.

Download

The newest release is always available from @PACKAGE_URL@

The current release is @PACKAGE_VERSION@

Get libcanberra's development sources from the GIT repository (gitweb):

git clone git://git.0pointer.de/libcanberra

If you want to report bugs or have questions, please use the libcanberra-discuss mailing list.