diff options
author | Walter Bender <walter@walter-laptop.(none)> | 2009-02-20 16:12:44 (GMT) |
---|---|---|
committer | Walter Bender <walter@walter-laptop.(none)> | 2009-02-20 16:12:44 (GMT) |
commit | b0b6de5e6c61fe92452bf057d2f0677a3d1fec9b (patch) | |
tree | 18b7e220d66044df26505c31b0ad68cda5e8d8b0 /arch_src/pyalsaaudio-0.2/README | |
parent | 897de91d58c45e13f6de78818d9805fc78021d75 (diff) |
silbe patch to build alsaaudio on first launch
Diffstat (limited to 'arch_src/pyalsaaudio-0.2/README')
-rw-r--r-- | arch_src/pyalsaaudio-0.2/README | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/arch_src/pyalsaaudio-0.2/README b/arch_src/pyalsaaudio-0.2/README new file mode 100644 index 0000000..179cb79 --- /dev/null +++ b/arch_src/pyalsaaudio-0.2/README @@ -0,0 +1,55 @@ +PyAlsaAudio +=========== + +Author: Casper Wilstrup (cwi@unispeed.dk) + +This package contains wrappers for accessing the ALSA api from Python. It +is currently fairly complete for PCM devices. My next goal is to have +complete mixer supports as well. MIDI sequencer support is low on my +priority list, but volunteers are welcome. + +If you find bugs in the wrappers please notify me on email. Please +don't send bug reports regarding ALSA specifically. There are several +bugs in this api, and those should be reported to the ALSA team - not +me. + +This software is licensed under the PSF license - the same one used +by the majority of the python distribution. Basically you can use it +for anything you wish (even commercial purposes). There is no warranty +whatsoever. + + +Installation +============ + +Note: the wrappers link with the alsasound library alsa (from the alsa-lib +package). Verify that this is installed by looking for /usr/lib/libasound.so +before building. The libasound development files are also neccesary. On debian +and derivatives, this is achieved by installing the alsalib-dev package. + +Naturally you also need to use a kernel with proper ALSA +support. This is the default in Linux kernel 2.6 and later. If you are using +kernel version 2.4 you may need to install the ALSA patches yourself - although +most distributions ship with ALSA kernels. + +To install, execute the following: + $ python setup.py build + +And then as root: + # python setup.py install + + +Using the API +============= +There is a reasonably usefull API documentation included in the module +documentation, which can be found in the doc subdirectory of the source +distribution. + +There are also three example programs included with the source: +'playbacktest.py' which plays back raw sound data read from +stdin + +'recordtest.py' which captures sound from the microphone at writes +it raw to stdout. + +'mixertest.py' which can be used to manipulate the mixers |