diff options
authorLennart Poettering <>2004-10-27 22:43:36 +0000
committerLennart Poettering <>2004-10-27 22:43:36 +0000
commitc82105d901682fdbecd409930fdf6d747d37809c (patch)
parent1bcec3ef5b83ca72c7d32e553566698607bae0e2 (diff)
prepare next release 0.6
git-svn-id: file:///home/lennart/svn/public/pulseaudio/trunk@264 fefdeb5f-60dc-0310-8127-8f9354f1896f
3 files changed, 76 insertions, 10 deletions
diff --git a/doc/ b/doc/
index a0b3e641..22a30dc2 100644
--- a/doc/
+++ b/doc/
@@ -44,6 +44,18 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</p>
<h2><a name="news">News</a></h2>
+<div class="news-date">Thu Oct 28 2004: </div> <p class="news-text"><a
+href="@PACKAGE_URL@polypaudio-0.6.tar.gz">Version 0.6</a> released;
+changes include: TCP wrappers support; don't load the complete sound
+file into memory when playing back using <tt>pa_play_file()</tt>;
+autoload API change; don't load all sound files as FLOAT32; shorten
+default buffers; client-side latency interpolation; add new user
+volume metrics; add <tt>module-tunnel</tt>, <tt>module-null-sink</tt>,
+<tt>module-match</tt> and new tool <tt>paplay</tt>; new API version
+macros; many client API improvements; correctly lock cookie file
+generation; correctly lock daemon autospawning; print daemon layout to
+STDERR on SIGHUP; new options for <tt>pacat</tt>: allow sample type specification.</p>
<div class="news-date">Mon Sep 24 2004: </div> <p class="news-text"><a
href="@PACKAGE_URL@polypaudio-0.5.1.tar.gz">Version 0.5.1</a> released;
changes include: improve esound protocol compatibility; fix
@@ -96,6 +108,7 @@ Daemon</a> (ESOUND). In addition to the features ESOUND provides
<li>Module autoloading</li>
<li>Very accurate latency measurement for playback and recordin.</li>
<li>May be used to combine multiple sound cards to one (with sample rate adjustment)</li>
+ <li>Client side latency interpolation</li>
<p>Both the core and the client API are completely asynchronous making
@@ -120,7 +133,10 @@ available. A simple main loop implementation is available as well.</p>
<li><tt>module-native-protocol-tcp</tt>, <tt>module-native-protocol-unix</tt>: Native polypaudio protocol (for TCP/IP resp. UNIX domain sockets)</li>
<li><tt>module-simple-protocol-tcp</tt>, <tt>module-simple-protocol-unix</tt>: Simplistic protocol for playback/capture for usage with tools like <tt>netcat</tt> (for TCP/IP resp. UNIX domain sockets)</li>
<li><tt>module-cli-protocol-tcp</tt>, <tt>module-cli-protocol-unix</tt>, <tt>module-cli</tt>: Expose polypaudio's internals whith a simple command line interface. (for TCP/IP resp. UNIX domain sockets resp. STDIN/STDOUT)</li>
- </ul>
+ <li><tt>module-tunnel-sink</tt>, <tt>module-tunnel-source</tt>: make sinks/sources from other hosts available locally.</li>
+ <li><tt>module-match</tt>: adjust volume automatically for newly created playback streams based on a regular expression matching table.</li>
+ <li><tt>module-null-sink</tt>: a clocked sink similar to <tt>/dev/null</tt>.</li>
<p><tt>polypaudio</tt> is the successor of my previous, ill-fated
attempt to write a sound server, <a
@@ -131,10 +147,9 @@ href="">Polypaudio
Manager</a>. Another GTK GUI tool for Polypaudio is the <a
href="">Polypaudio Volume
Meter</a>. There are output plugins for <a
-href="">XMMS</a> and <a
-href="">libao</a>. Drivers
-for <a href="">gstreamer</a> and <a
-href="">MPlayer</a> will be released shortly.</p>
+href="">XMMS</a>, <a
+href="">libao</a> and <a href="">gstreamer</a>. Drivers
+for <a href="">MPlayer</a> and <a href="">PortAudio</a> will be released shortly.</p>
<h2><a name="status">Status</a></h2>
@@ -173,6 +188,10 @@ command line :</p>
<p>The best idea is to configure your daemon in <tt>/etc/polypaudio/daemon.conf</tt> and <tt>/etc/polypaudio/</tt> and to run polypaudio without any arguments.</p>
+<p><b>Beware!</b> Unless you pass the option <tt>--sysconfdir=/etc</tt> to
+<tt>configure</tt>, the directory <tt>/etc/polypaudio/</tt> is really
<h3>Developing polypaudio Clients</h3>
<p>You may browse the <a href="">Doxygen</a> generated <a
@@ -206,10 +225,13 @@ distributions (and maybe Unix versions) since it uses GNU autoconf and
GNU libtool for source code configuration and shared library
-<p><tt>polypaudio</tt> needs <a
+<p><tt>polypaudio</tt> needs <tt>libwrap</tt>, <a
href="">Secret Rabbit Code (aka
-<tt>libsamplerate</tt>)</a>, <a href=""><tt>libsndfile</tt></a>, <a
-href="">alsa-lib</a> and <a href="">GLIB</a>. (The latter is required for building the GLIB main loop integration module only.)</p>
+<tt>libsamplerate</tt>)</a>, <a
+href=""><tt>libsndfile</tt></a>, <a
+href="">alsa-lib</a> and <a
+href="">GLIB</a>. (The latter is required for
+building the GLIB main loop integration module only.)</p>
<h2><a name="installation">Installation</a></h2>
@@ -229,7 +251,7 @@ compilation and <tt>make install</tt> (as root) for installation of
<p>The current release is <a href="@PACKAGE_URL@polypaudio-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p>
-<p>Get <tt>polypaudio</tt>'s development sources from the <a href="">Subversion</a> <a href="svn://">repository</a> (<a href="">viewcvs</a>): </p>
+<p>Get <tt>polypaudio</tt>'s development sources from the <a href="">Subversion</a> <a href="svn://">repository</a> (<a href="">viewcvs</a>): </p>
<pre>svn checkout svn:// polypaudio</pre>
@@ -237,8 +259,10 @@ compilation and <tt>make install</tt> (as root) for installation of
<p><b>New!</b> There is a general discussion <a href="">mailing list for polypaudio</a> available.</p>
+<p><b>New!</b> There is now a <a href="">Polypaudio wiki</a> (based on <a href="">trac</a>) available.</p>
-<address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, September 2004</address>
+<address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, October 2004</address>
<div class="grey"><i>$Id$</i></div>
diff --git a/doc/ b/doc/
index 147ee551..8d2414c0 100644
--- a/doc/
+++ b/doc/
@@ -62,6 +62,10 @@ The <tt>polypaudio</tt> daemon accepts several command line arguments:
<p>The daemon tries to load the module <a href="modules.html#module-cli-protocol-unix"><tt>module-cli-protocol-unix</tt></a>, effectively providing a command line interface on a special UNIX domain socket.</p>
+<p>The daemon logs the current server layout.</p>
<address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, September 2004</address>
<div class="grey"><i>$Id$</i></div>
diff --git a/doc/ b/doc/
index 4bf6044b..5e9b8873 100644
--- a/doc/
+++ b/doc/
@@ -44,6 +44,13 @@ special file in the file system. The source name defaults to <tt>pipe_input</tt>
<tr><td><tt>file=</tt></td><td>The name of the FIFO special file to use. (defaults to: <tt>/tmp/music.input</tt>)</td></tr>
+<p>Provides a simple null sink. All data written to this sink is silently dropped. This sink is clocked using the system time.</p>
+<p>This module doesn't support any special parameters</p>
<a name="module-alsa-sink"/>
@@ -116,6 +123,21 @@ be to slow on your machine try using <tt>zero-order-hold</tt>. This
will decrease output quality however. (defaults to
<tt>sinc-fastest</tt>)</td></tr> </table>
+<p>Tunnel a remote sink/source to a local "ghost"
+sink/source. Requires a running polypaudio daemon on the remote server
+with <tt>module-native-protocol-tcp</tt> loaded. It's probably a
+better idea to connect to the remote sink/source directly since some
+buffer control is lost through this tunneling.</p>
+ <tr><td><tt>server=</tt></td><td>The server to connect to</td></tr>
+ <tr><td><tt>source=</tt></td><td>The source on the remote server. Only available for <tt>module-tunnel-source</tt>.</td></tr>
+ <tr><td><tt>sink=</tt></td><td>The sink on the remote server. Only available for <tt>module-tunnel-sink</tt>.</td></tr>
+ <tr><td><tt>cookie=</tt></td><td>The authentication cookie file to use.</td></tr>
<a name="module-cli"/>
@@ -251,6 +273,22 @@ about the two possible suffixes of this module.</p>
<p>This is a compatibility module for <tt>libesd</tt> based autospawning of polypaudio. Don't use it directly.</p>
+<p>Adjust the volume of a playback stream automatically based on its name.</p>
+ <tr><td><tt>table=</tt></td><td>The regular expression matching table file to use</td></tr>
+<p>The table file should contain a regexp and volume on each line, seperated by spaces. An example:</p>
+^sample: 25
+<p>The volumes of all streams with titles starting with <tt>sample:</tt> are automatically set to 25. (FYI: All sample cache streams start with <tt>sample:</tt>)</p>
<address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, September 2004</address>
<div class="grey"><i>$Id$</i></div>