summaryrefslogtreecommitdiffstats
path: root/doc/README-pulse
diff options
context:
space:
mode:
authorPierre Ossman <ossman@cendio.se>2006-07-12 16:47:20 +0200
committerTakashi Iwai <tiwai@suse.de>2006-07-12 16:47:20 +0200
commit9304087e46a38f932959598720d1e048a6e1042a (patch)
tree627fc036583567f41c747d0b4bef06f847d408d1 /doc/README-pulse
parent65028b0c19c6aa3ba469cbb9d52c56655d3b67b5 (diff)
Follow Polypaudio/PulseAudio name change
Polypaudio recently changed its name to PulseAudio which affects the names of libraries of header files. Update the polyp, now pulse, plug-in to follow this name change. Signed-off-by: Pierre Ossman <ossman@cendio.se>
Diffstat (limited to 'doc/README-pulse')
-rw-r--r--doc/README-pulse41
1 files changed, 41 insertions, 0 deletions
diff --git a/doc/README-pulse b/doc/README-pulse
new file mode 100644
index 0000000..d5431b4
--- /dev/null
+++ b/doc/README-pulse
@@ -0,0 +1,41 @@
+PulseAudio <--> ALSA plugins
+============================
+
+This plugin allows any program that uses the ALSA API to access a PulseAudio
+sound daemon. In other words, native ALSA applications can play and record
+sound across a network.
+
+There are two plugins in the suite, one for PCM and one for mixer control. A
+typical configuration will look like:
+
+ pcm.pulse {
+ type pulse
+ }
+
+ ctl.pulse {
+ type pulse
+ }
+
+Put the above in ~/.asoundrc, or /etc/asound.conf, and use "pulse" as device
+in your ALSA applications. For example:
+
+ % aplay -Dpulse foo.wav
+ % amixer -Dpulse
+
+PulseAudio will accept more or less any format you throw at it. So a plug
+wrapper is unnecessary. Mixing is also handled so dmix will only cause a
+performance hit without any gain.
+
+The plugins will respect your PulseAudio environment variables (like
+PULSE_SERVER), but you can override these in ALSA's configuration files.
+
+Both plugins accept the "server" parameter, specifying which PulseAudio server
+to contact. Both also accept the "device" parameter, which indicate which
+source and sink to use.
+
+The mixer control plugin also accepts the parameters "source" and "sink" for
+when you need to specify a sink/source combination with different names. If
+you need to do this with PCM:s then specify two PCM:s with different "device".
+
+If you do not specify any source and/or sink, then the server's defaults will
+be used.