1 libcanberra 0.30 2 3 Copyright 2008-2012 Lennart Poettering <mzyvopnaoreen (at) 0pointer 4 (dot) de> 5 * [1]License 6 * [2]News 7 * [3]Overview 8 * [4]Current Status 9 * [5]Documentation 10 * [6]Requirements 11 * [7]Installation 12 * [8]Acknowledgements 13 * [9]Download 14 15License 16 17 This program is free software; you can redistribute it and/or modify it 18 under the terms of the GNU Lesser General Public License as published 19 by the Free Software Foundation, either version 2.1 of the License, or 20 (at your option) any later version. 21 22 This program is distributed in the hope that it will be useful, but 23 WITHOUT ANY WARRANTY; without even the implied warranty of 24 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser 25 General Public License for more details. 26 27News 28 29 Tue 25 Sep 2012: 30 31 [10]Version 0.30 released; Port to GStreamer 1.0. 32 33 Tue 15 May 2012: 34 35 [11]Version 0.29 released; A couple of bugfixes, drop GConf usage. 36 37 Thu 24 Feb 2011: 38 39 [12]Version 0.28 released; Hook properly into GNOME 3.0 sessions; this 40 drops support for GNOME 2.0 sessions, but not applications. 41 42 Fri 18 Feb 2011: 43 44 [13]Version 0.27 released; Gtk+ 3.x fixes; add new tool to implement 45 boot-up sounds when used with systemd; other fixes 46 47 Mon 4 Oct 2010: 48 49 [14]Version 0.26 released; Gtk+ 3.x fixes. 50 51 Sun 13 Jun 2010: 52 53 [15]Version 0.25 released; Optionally build with Gtk+ 3.x in addition 54 to Gtk+ 2.x. 55 56 Mon 19 Apr 2010: 57 58 [16]Version 0.24 released; GTK code is now fine with GSEAL. Minor fixes 59 in the PulseAudio backend, other fixes. 60 61 Sat 20 Feb 2010: 62 63 [17]Version 0.23 released; various minor fixes in the pulse and 64 gstreamer backends as well in the Vala API. Support for the recently 65 standardized Vorbis 6.1/7.1 multichannel modes. 66 67 Tue 20 Oct 2009: 68 69 [18]Version 0.22 released; small fix to make sure we don't dereference 70 a null pointer. 71 72 Fri 16 Oct 2009: 73 74 [19]Version 0.21 released; suppress casting warning 75 76 Thu 15 Oct 2009: 77 78 [20]Version 0.20 released; minor casting fix 79 80 Wed 14 Oct 2009: 81 82 [21]Version 0.19 released; some important fixes for the Gtk support 83 84 Sun 20 Sep 2009: 85 86 [22]Version 0.18 released; numerous updates for the Gtk support 87 88 Fri 12 Sep 2009: 89 90 [23]Version 0.17 released; add vala vapi file; numerous updates to Gtk 91 support 92 93 Thu 27 Aug 2009: 94 95 [24]Version 0.16 released; add new ca_context_playing() call 96 97 Wed 5 Aug 2009: 98 99 [25]Version 0.15 released; bug fixes 100 101 Thu 2 Jul 2009: 102 103 [26]Version 0.14 released; bug fixes 104 105 Tue 23 Jun 2009: 106 107 [27]Version 0.13 released; multichannel support; gtk multihead support; 108 bug fixes 109 110 Mon 13 Apr 2009: 111 112 [28]Version 0.12 released; changes include: various fixes and updates 113 for the PulseAudio backend; detect forks and return an error for all 114 functions in that case 115 116 Wed 21 Jan 2009: 117 118 [29]Version 0.11 released; changes include: major GStreamer backend 119 fixes; update to libtool 2.2; a few other fixes 120 121 Mon 6 Oct 2008: 122 123 [30]Version 0.10 released; changes include: install Gtk+ module using 124 GConf; a few other fixes 125 126 Tue 9 Sep 2008: 127 128 [31]Version 0.9 released; changes include: GStreamer fixes, include 129 (optional) libtdb based lookup cache. 130 131 Thu 28 Aug 2008: 132 133 [32]Version 0.8 released; changes include: new OSS and GStreamer 134 backend; portability fixes for FreeBSD/Solaris; the multi backend works 135 now 136 137 Thu 14 Aug 2008: 138 139 [33]Version 0.7 released; changes include: documentation updates; 140 various bug fixes; add this web site/README; allow playback of event 141 sounds with only a sound file path specified; other changes 142 143Overview 144 145 libcanberra is an implementation of the [34]XDG Sound Theme and Name 146 Specifications, for generating event sounds on free desktops, such as 147 [35]GNOME. It comes with several backends ([36]ALSA, [37]PulseAudio, 148 OSS, [38]GStreamer, null) and is designed to be portable. It consists 149 of the following parts: 150 1. libcanberra: the main library 151 2. libcanberra-gtk: some glue code to make it easier to use 152 libcanberra from Gtk+ applications 153 3. libcanberra-gtk-module: a Gtk+ module that uses libcanberra-gtk to 154 trigger input feedback event sounds 155 156 For more information see [39]the original announcement. 157 158Current Status 159 160 libcanberra is mostly feature complete. For now however it includes 161 backends only for ALSA, PulseAudio, OSS and GStreamer. 162 163 libcanberra has been declared [40]a blessed GNOME dependency. 164 165 The OSS driver is incomplete: only sound files that are in a format 166 natively understood by the sound card are supported. If the sample 167 type, channel map or sampling rate of the sound file are not supported 168 by the sound card no automatic conversion will take place and the file 169 will not be played. Also note that the OSS backend is most likely 170 incompatible with OSS4, due to subtle incompatibilities between OSS4 171 and the OSS 3.x. 172 173 It is recommended to always take the "shortest" path from libcanberra 174 to the audio device. I.e. don't use the GStreamer plugin if libcanberra 175 supports the final output target natively. Besides being more 176 resource-friendly and less error-prone, some advanced functionality 177 might get lost with each layer you add to your stack. For example: 178 while you could use libcanberra's Gstreamer backend to output to a 179 PulseAudio server this will not be able to make use of sample cacheing 180 or will be able to attach additional meta data to the sounds played, 181 which might be necessary for effects like positional event sounds. 182 183Documentation 184 185 You may browse the [41]gtkdoc generated [42]programing documentation of 186 the API. 187 188Requirements 189 190 Currently, libcanberra is tested on Linux only. 191 192 libcanberra was developed and tested on Fedora Rawhide from August 193 2008, it should work on most other Linux distributions (and maybe Unix 194 versions) since it uses GNU autoconf and GNU libtool for source code 195 configuration and shared library management. 196 197 libcanberra has no dependencies besides the OGG Vorbis development 198 headers and whatever the selected backends require. Gtk+ support is 199 optional. An optional lookup cache can be used if Samba's tdb trivial 200 database is available. 201 202Installation 203 204 As this package is made with the GNU autotools you should run 205 ./configure inside the distribution directory for configuring the 206 source tree. After that you should run make for compilation and make 207 install (as root) for installation of libcanberra. 208 209Acknowledgements 210 211 Marc-André Lureau and Brian Cameron for the GStreamer backend. 212 213 Joe Marcus Clarke for the OSS backend. 214 215 Diego Elio Pettenò for various build system fixes. 216 217Download 218 219 The newest release is always available from 220 [43]http://0pointer.de/lennart/projects/libcanberra/ 221 222 The current release is [44]0.30 223 224 Get libcanberra's development sources from the [45]GIT [46]repository 225 ([47]gitweb): 226git clone git://git.0pointer.de/libcanberra 227 228 If you want to report bugs, have questions or want to be notified about 229 new releases, please join the [48]libcanberra-discuss mailing list. 230 231 If you want to be notified about new git commits, please join the 232 [49]libcanberra-commits mailing list. 233 234 libcanberra's bugs are tracked at [50]bugs.freedesktop.org. 235 __________________________________________________________________ 236 237 238 Lennart Poettering <mzyvopnaoreen (at) 0pointer (dot) de>, September 239 2012 240 241References 242 243 1. README#license 244 2. README#news 245 3. README#overview 246 4. README#status 247 5. README#documentation 248 6. README#requirements 249 7. README#installation 250 8. README#acks 251 9. README#download 252 10. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.30.tar.xz 253 11. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.29.tar.xz 254 12. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.28.tar.gz 255 13. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.27.tar.gz 256 14. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.26.tar.gz 257 15. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.25.tar.gz 258 16. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.24.tar.gz 259 17. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.23.tar.gz 260 18. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.22.tar.gz 261 19. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.21.tar.gz 262 20. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.20.tar.gz 263 21. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.19.tar.gz 264 22. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.18.tar.gz 265 23. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.17.tar.gz 266 24. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.16.tar.gz 267 25. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.15.tar.gz 268 26. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.14.tar.gz 269 27. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.13.tar.gz 270 28. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.12.tar.gz 271 29. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.11.tar.gz 272 30. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.10.tar.gz 273 31. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.9.tar.gz 274 32. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.8.tar.gz 275 33. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.7.tar.gz 276 34. http://freedesktop.org/wiki/Specifications/sound-theme-spec 277 35. http://www.gnome.org/ 278 36. http://alsa-project.org/ 279 37. http://pulseaudio.org/ 280 38. http://gstreamer.org/ 281 39. http://0pointer.de/blog/projects/sixfold-announcement.html 282 40. http://mail.gnome.org/archives/devel-announce-list/2008-August/msg00001.html 283 41. http://www.gtk.org/gtk-doc/ 284 42. http://0pointer.de/lennart/projects/libcanberra/gtkdoc/ 285 43. http://0pointer.de/lennart/projects/libcanberra/ 286 44. http://0pointer.de/lennart/projects/libcanberra/libcanberra-0.30.tar.xz 287 45. http://git-scm.com/ 288 46. git://git.0pointer.de/libcanberra 289 47. http://git.0pointer.de/?p=libcanberra.git 290 48. https://tango.0pointer.de/mailman/listinfo/libcanberra-discuss/ 291 49. https://tango.0pointer.de/mailman/listinfo/libcanberra-commits/ 292 50. http://bugs.freedesktop.org/buglist.cgi?bug_status=__open__&product=libcanberra 293