code.delx.au - pulseaudio/blob - doc/README.html.in

   1 <?xml version="1.0" encoding="iso-8859-1"?> <!-- -*-html-helper-*- -->
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4
   5 <head>
   6 <title>polypaudio @PACKAGE_VERSION@</title>
   7 <link rel="stylesheet" type="text/css" href="style.css" />
   8 </head>
   9
  10 <body>
  11 <h1><a name="top">polypaudio @PACKAGE_VERSION@</a></h1>
  12
  13 <p><i>Copyright 2002-2004 Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;</i></p>
  14
  15 <ul class="toc">
  16     <li><a href="#license">License</a></li>
  17     <li><a href="#news">News</a></li>
  18     <li><a href="#overview">Overview</a></li>
  19     <li><a href="#status">Status</a></li>
  20     <li><a href="#documentation">Documentation</a></li>
  21     <li><a href="#requirements">Requirements</a></li>
  22     <li><a href="#installation">Installation</a></li>
  23     <li><a href="#acks">Acknowledgements</a></li>
  24     <li><a href="#download">Download</a></li>
  25 </ul>
  26
  27 <h2><a name="license">License</a></h2>
  28
  29 <p>This program is free software; you can redistribute it and/or
  30 modify it under the terms of the GNU General Public License as
  31 published by the Free Software Foundation; either version 2 of the
  32 License, or (at your option) any later version.</p>
  33
  34 <p>This program is distributed in the hope that it will be useful, but
  35 WITHOUT ANY WARRANTY; without even the implied warranty of
  36 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  37 General Public License for more details.</p>
  38
  39 <p>You should have received a copy of the GNU General Public License
  40 along with this program; if not, write to the Free Software
  41 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</p>
  42
  43 <h2><a name="news">News</a></h2>
  44
  45
  46 <div class="news-date">Sat Jul 17 2004: </div> <p class="news-text"><a
  47 href="@PACKAGE_URL@polypaudio-0.1.tar.gz">Version 0.1</a> released</p>
  48
  49 <h2><a name="overview">Overview</a></h2>
  50
  51 <p><tt>polypaudio</tt> is a sound server for Linux and other Unix like
  52 operating systems. It is intended to be an improved drop-in
  53 replacement for the <a
  54 href="http://www.tux.org/~ricdude/apps.html">Enlightened Sound
  55 Daemon</a> (ESOUND). In addition to the features ESOUND provides
  56 <tt>polypaudio</tt> has:</p>
  57
  58 <ul>
  59   <li>Extensible plugin architecture (<tt>dlopen()</tt>)</li>
  60   <li>Support for more than one sink/source</li>
  61   <li>Better low latency behaviour</li>
  62   <li>Embedabble into other software (the core is available as C library)</li>
  63   <li>Completely asynchronous C API</li>
  64   <li>Simple command line interface for reconfiguring the daemon while running</li>
  65   <li>Flexible, implicit sample type conversion and resampling</li>
  66   <li>"Zero-Copy" architecture</li>
  67 </ul>
  68
  69 <p>Both the core and the client API are completely asynchronous making
  70 use of a simple main loop abstraction layer. This allows easy
  71 integration with asynchronous applications using the
  72 <tt>glib</tt>/<tt>gtk</tt> mainloop. Since the asynchronous API
  73 available through <tt>polyplib</tt> is quite difficult to use there is
  74 a simplified synchronous API wrapper <tt>polyplib-simple</tt>
  75 available.</p>
  76
  77 <h2><a name="status">Status</a></h2>
  78
  79 <p>Version @PACKAGE_VERSION@ is quite usable. <tt>polypaudio</tt> does
  80 not yet match all ESOUND features: currently a sample cache and
  81 automatic releasing of unused sound drivers are missing. Have a look on the more extensive <a href="http://0pointer.de/cgi-bin/viewcvs.cgi/trunk/src/todo?view=markup">TODO list</a>.</p>
  82
  83 <h2><a name="documentation">Documentation</a></h2>
  84
  85 <p>There is some prelimenary documentation available: <a
  86 href="modules.html"><tt>modules.html</tt></a>, <a
  87 href="cli.html"><tt>cli.html</tt></a>, <a
  88 href="daemon.html"><tt>daemeon.html</tt></a>.</p>
  89
  90 <p>Documentation for developing with <tt>polypaudio</tt> is not yet
  91 available. Read the source, Luke!</p>
  92
  93 <h2><a name="requirements">Requirements</a></h2>
  94
  95 <p>Currently, <tt>polypaudio</tt> is tested on Linux only. It requires an OSS or ALSA compatible soundcard.</p>
  96
  97 <p><tt>polypaudio</tt> was developed and tested on Debian GNU/Linux
  98 "testing" from July 2004, it should work on most other Linux
  99 distributions (and maybe Unix versions) since it uses GNU autoconf and
 100 GNU libtool for source code configuration and shared library
 101 management.</p>
 102
 103 <p><tt>polypaudio</tt> needs <a
 104 href="http://www.mega-nerd.com/SRC/">Secret Rabbit Code (aka <tt>libsamplerate</tt>)</a> and <a href="http://www.alsa-project.org/">alsa-lib</a>.</p>
 105
 106 <h2><a name="installation">Installation</a></h2>
 107
 108 <p>As this package is made with the GNU autotools you should run
 109 <tt>./configure</tt> inside the distribution directory for configuring
 110 the source tree. After that you should run <tt>make</tt> for
 111 compilation and <tt>make install</tt> (as root) for installation of
 112 <tt>polypaudio</tt>.</p>
 113
 114 <h2><a name="acks">Acknowledgements</a></h2>
 115
 116 <p>Eric B. Mitchell for writing ESOUND</p>
 117
 118 <h2><a name="download">Download</a></h2>
 119
 120 <p>The newest release is always available from <a href="@PACKAGE_URL@">@PACKAGE_URL@</a></p>
 121
 122 <p>The current release is <a href="@PACKAGE_URL@polypaudio-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p>
 123
 124 <p>Get <tt>polypaudio</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="https://seth.intheinter.net:8081/svn/polypaudio/">repository</a>. (<a href="http://0pointer.de/cgi-bin/viewcvs.cgi/?root=polypaudio">viewcvs</a>)</p>
 125
 126 <p>If you want to be notified whenever I release a new version of this software use the subscription feature of <a href="http://freshmeat.net/projects/polypaudio/">Freshmeat</a>.</p>
 127
 128 <hr/>
 129 <address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, July 2004</address>
 130 <div class="grey"><i>$Id$</i></div>
 131
 132 </body>
 133 </html>