From 9304087e46a38f932959598720d1e048a6e1042a Mon Sep 17 00:00:00 2001 From: Pierre Ossman Date: Wed, 12 Jul 2006 16:47:20 +0200 Subject: 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 --- doc/README-pulse | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 doc/README-pulse (limited to 'doc/README-pulse') 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. -- cgit