code.delx.au - pulseaudio/blob - doc/modules.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 <head>
   5 <title>polypaudio: Loadable Modules</title>
   6 <link rel="stylesheet" type="text/css" href="style.css" />
   7 </head>
   8
   9 <body>
  10
  11 <h1>Loadable Modules</h1>
  12
  13 <p>The following loadable modules are provided with the <tt>polypaudio</tt> distribution:</p>
  14
  15 <h2>Device Drivers</h2>
  16
  17 <p>All device driver modules support the following parameters:</p>
  18 <table>
  19   <tr><td><tt>format=</tt></td><td>The sample format (one of <tt>u8</tt>, <tt>s16</tt>, <tt>s16le</tt>, <tt>s16le</tt>, <tt>float32</tt>, <tt>float32be</tt>, <tt>float32le</tt>, <tt>alaw</tt>, <tt>ulaw</tt>) (defaults to <tt>s16</tt>)</td></tr>
  20   <tr><td><tt>rate=</tt></td><td>The sample rate (defaults to 44100)</td></tr>
  21   <tr><td><tt>channels=</tt></td><td>Audio channels (defaults to 2)</td></tr>
  22   <tr><td><tt>sink_name=</tt>, <tt>source_name=</tt></td><td>Name for the sink (resp. source)</td></tr>
  23 </table>
  24
  25 <h3>module-pipe-sink</h3>
  26
  27 <p>Provides a simple test sink that writes the audio data to a FIFO
  28 special file in the file system. The sink name defaults to <tt>pipe_output</tt>.</p>
  29
  30 <p>The following option is supported:</p>
  31
  32 <table>
  33   <tr><td><tt>file=</tt></td><td>The name of the FIFO special file to use. (defaults to: <tt>/tmp/music.output</tt>)</td></tr>
  34 </table>
  35
  36 <h3>module-pipe-source</h3>
  37
  38 <p>Provides a simple test source that reads the audio data from a FIFO
  39 special file in the file system. The source name defaults to <tt>pipe_input</tt>.</p>
  40
  41 <p>The following option is supported:</p>
  42
  43 <table>
  44   <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>
  45 </table>
  46
  47
  48 <h3>module-null-sink</h3>
  49
  50 <p>Provides a simple null sink. All data written to this sink is silently dropped. This sink is clocked using the system time.</p>
  51
  52 <p>This module doesn't support any special parameters</p>
  53
  54 <a name="module-alsa-sink"/>
  55
  56 <h3>module-alsa-sink</h3>
  57
  58 <p>Provides a playback sink for devices supported by the <a href="http://www.alsa-project.org/">Advanced Linux
  59 Sound Architecture</a> (ALSA). The sink name defaults to <tt>alsa_output</tt>.</p>
  60
  61 <p>In addition to the general device driver options described above this module supports:</p>
  62
  63 <table>
  64   <tr><td><tt>device=</tt></td><td>The ALSA device to use. (defaults to "plughw:0,0")</td></tr>
  65   <tr><td><tt>fragments=</tt></td><td>The desired fragments when opening the device. (defaults to 12)</td></tr>
  66   <tr><td><tt>fragment_size=</tt></td><td>The desired fragment size in bytes when opening the device (defaults to 1024)</td></tr>
  67 </table>
  68
  69 <h3>module-alsa-source</h3>
  70
  71 <p>Provides a recording source for devices supported by the Advanced
  72 Linux Sound Architecture (ALSA). The source name defaults to <tt>alsa_input</tt>.</p>
  73
  74 <p>This module supports <tt>device=</tt>, <tt>fragments=</tt> and <tt>fragment_size=</tt> arguments the same way as <a href="#module-alsa-sink"><tt>module-alsa-sink</tt></a>.</p>
  75
  76 <a name="module-oss"/>
  77
  78 <h3>module-oss</h3>
  79
  80 <p>Provides both a sink and a source for playback, resp. recording on
  81 <a href="http://www.opensound.com">Open Sound System</a> (OSS) compatible devices.</p>
  82
  83 <p>This module supports <tt>device=</tt> (which defaults to <tt>/dev/dsp</tt>), <tt>fragments=</tt> and <tt>fragment_size=</tt> arguments the same way as <a href="#module-alsa-sink"><tt>module-alsa-sink</tt></a>.</p>
  84
  85 <p>In addition this module supports the following options:</p>
  86
  87 <table>
  88   <tr><td><tt>record=</tt></td><td>Accepts a binary numerical value for enabling (resp. disabling) the recording on this device. (defaults: to 1)</td></tr>
  89   <tr><td><tt>playback=</tt></td><td>Accepts a binary numerical value for enabling (resp. disabling) the playback on this device. (defaults: to 1)</td></tr>
  90 </table>
  91
  92 <p>The sink name (resp. source name) defaults to <tt>oss_output</tt> (resp. <tt>oss_input</tt>).</p>
  93
  94 <h3>module-oss-mmap</h3>
  95
  96 <p>Similar to <tt>module-oss</tt> but uses memory mapped
  97 (<tt>mmap()</tt>) access to the input/output buffers of the audio
  98 device. This provides better latency behaviour but is not as
  99 compatible as <tt>module-oss</tt>.</p>
 100
 101 <p>This module accepts exactly the same arguments as <a href="#module-oss"><tt>module-oss</tt></a>.</p>
 102
 103 <h3>module-solaris</h3>
 104
 105 <P>Provides a sink and source for the Solaris audio device.</p>
 106
 107 <p>In addition to the general device driver options described above this module supports:</p>
 108
 109 <table>
 110   <tr><td><tt>record=</tt></td><td>Accepts a binary numerical value for enabling (resp. disabling) the recording on this device. (defaults: to 1)</td></tr>
 111   <tr><td><tt>playback=</tt></td><td>Accepts a binary numerical value for enabling (resp. disabling) the playback on this device. (defaults: to 1)</td></tr>
 112   <tr><td><tt>buffer_size=</tt></td><td>Record buffer size</td></tr>
 113 </table>
 114
 115 <h3>module-waveout</h3>
 116
 117 <P>Provides a sink and source for the Win32 audio device.</p>
 118
 119 <p>This module supports all arguments thet <tt>module-oss</tt> supports except <tt>device=</tt>.</p>
 120
 121 <h3>module-combine</h3>
 122
 123 <p>This combines two or more sinks into one. A new virtual sink is
 124 allocated. All data written to it is forwarded to all connected
 125 sinks. In aequidistant intervals the sample rates of the output sinks
 126 is recalculated: i.e. even when the sink's crystals deviate (which is
 127 normally the case) output appears synchronously to the human ear. The
 128 resampling required for this may be very CPU intensive.</p>
 129
 130 <table>
 131   <tr><td><tt>sink_name=</tt></td><td>The name for the combined sink. (defaults to  <tt>combined</tt>)</td></tr>
 132   <tr><td><tt>master=</tt></td><td>The name of the first sink to link into the combined think. The sample rate/type is taken from this sink.</td></tr>
 133   <tr><td><tt>slaves=</tt></td><td>Name of additional sinks to link into the combined think, seperated by commas.</td></tr>
 134   <tr><td><tt>adjust_time=</tt></td><td>Time in seconds when to readjust the sample rate of all sinks. (defaults to 20)</td></tr>
 135   <tr><td><tt>resample_method=</tt></td><td>Resampling algorithm to
 136 use. See <tt>libsamplerate</tt>'s documentation for more
 137 information. Use one of <tt>sinc-best-quality</tt>,
 138 <tt>sinc-medium-quality</tt>, <tt>sinc-fastest</tt>,
 139 <tt>zero-order-hold</tt>, <tt>linear</tt>. If the default happens to
 140 be to slow on your machine try using <tt>zero-order-hold</tt>. This
 141 will decrease output quality however. (defaults to
 142 <tt>sinc-fastest</tt>)</td></tr> </table>
 143
 144 <h3>module-tunnel-{sink,source}</h3>
 145
 146 <p>Tunnel a remote sink/source to a local "ghost"
 147 sink/source. Requires a running polypaudio daemon on the remote server
 148 with <tt>module-native-protocol-tcp</tt> loaded. It's probably a
 149 better idea to connect to the remote sink/source directly since some
 150 buffer control is lost through this tunneling.</p>
 151
 152 <table>
 153   <tr><td><tt>server=</tt></td><td>The server to connect to</td></tr>
 154   <tr><td><tt>source=</tt></td><td>The source on the remote server. Only available for <tt>module-tunnel-source</tt>.</td></tr>
 155   <tr><td><tt>sink=</tt></td><td>The sink on the remote server. Only available for <tt>module-tunnel-sink</tt>.</td></tr>
 156   <tr><td><tt>cookie=</tt></td><td>The authentication cookie file to use.</td></tr>
 157 </table>
 158
 159 <h3>module-esound-sink</h3>
 160
 161 <p>Create a playback sink using an <a href="http://www.tux.org/~ricdude/apps.html">ESOUND</a> server as backend. Whenever you can, try to omit this
 162 module since it has many disadvantages including bad latency
 163 and even worse latency measurement. </p>
 164
 165 <table>
 166   <tr><td><tt>server=</tt></td><td>The server to connect to</td></tr>
 167   <tr><td><tt>cookie=</tt></td><td>The authentication cookie file to use.</td></tr>
 168 </table>
 169
 170 <h2>Protocols</h2>
 171
 172 <a name="module-cli"/>
 173
 174 <h3>module-cli</h3>
 175
 176 <p>Provides the user with a simple command line interface on the
 177 controlling TTY of the daemon. This module may not be loaded more than
 178 once.</p>
 179
 180 <p>For an explanation of the simple command line language used by this
 181 module see <a href="cli.html"><tt>cli.html</tt></a>.
 182
 183 <p>This module doesn't accept any arguments.</p>
 184
 185 <a name="module-cli-protocol-unix"/>
 186 <a name="module-cli-protocol-tcp"/>
 187 <a name="module-cli-protocol"/>
 188
 189 <h3>module-cli-protocol-{unix,tcp}</h3>
 190
 191 <p>An implemenation of a simple command line based protocol for
 192 controlling the <tt>polypaudio</tt> daemon. If loaded, the user may
 193 connect with tools like <tt>netcat</tt>, <tt>telnet</tt> or
 194 <a href="http://0pointer.de/lennart/projects/bidilink/"><tt>bidilink</tt></a> to the listening sockets and execute commands the
 195 same way as with <tt>module-cli</tt>.</p>
 196
 197 <p><b>Beware!</b> Users are not authenticated when connecting to this
 198 service.</p>
 199
 200 <p>This module exists in two versions: with the suffix <tt>-unix</tt>
 201 the service will listen on an UNIX domain socket in the local file
 202 system. With the suffix <tt>-tcp</tt> it will listen on a network
 203 transparent TCP/IP socket. (Both IPv6 and IPv4 - if available)</p>
 204
 205 <p>This module supports the following options:</p>
 206
 207 <table>
 208   <tr><td><tt>port=</tt></td><td>(only for <tt>-tcp</tt>) The port number to listen on (defaults to 4712)</td></tr>
 209   <tr><td><tt>loopback=</tt></td><td>(only for <tt>-tcp</tt>) Accepts
 210 a numerical binary value. If 1 the socket is bound to the loopback
 211 device, i.e. not publicly accessible. (defaults to 1)</td></tr>
 212   <tr><td><tt>listen=</tt></td><td>(only for <tt>-tcp</tt>) The IP address to listen on. If specified, supersedes the value specified in <tt>loopback=</tt></td></tr>
 213   <tr><td><tt>socket=</tt></td><td>(only for <tt>-unix</tt>) The UNIX socket name (defaults to <tt>/tmp/polypaudio/cli</tt>)</td></tr>
 214 </table>
 215
 216 <h3>module-simple-protocol-{unix,tcp}</h3>
 217
 218 <p>An implementation of a simple protocol which allows playback by using
 219 simple tools like <tt>netcat</tt>. Just connect to the listening
 220 socket of this module and write the audio data to it, or read it from
 221 it for playback, resp. recording.</p>
 222
 223 <p><b>Beware!</b> Users are not authenticated when connecting to this
 224 service.</p>
 225
 226 <p>See <tt>module-cli-protocol-{unix,tcp}</tt> for more information
 227 about the two possible suffixes of this module.</p>
 228
 229 <p>In addition to the options supported by <a href="module-cli-protocol"><tt>module-cli-protocol-*</tt></a>, this module supports:</p>
 230
 231 <table>
 232   <tr><td><tt>rate=</tt>, <tt>format=</tt>, <tt>channels=</tt></td><td>Sample format for streams connecting to this service.</td></tr>
 233   <tr><td><tt>playback=</tt>, <tt>record=</tt></td><td>Enable/disable playback/recording</td></tr>
 234   <tr><td><tt>sink=</tt>, <tt>source=</tt></td><td>Specify the sink/source this service connects to</td></tr>
 235 </table>
 236
 237 <h3>module-esound-protocol-{unix,tcp}</h3>
 238
 239 <p>An implemenation of a protocol compatible with the <a
 240 href="http://www.tux.org/~ricdude/EsounD.html">Enlightened Sound
 241 Daemon</a> (ESOUND, <tt>esd</tt>). When you load this module you may
 242 access the <tt>polypaudio</tt> daemon with tools like <tt>esdcat</tt>,
 243 <tt>esdrec</tt> or even <tt>esdctl</tt>. Many applications, such as
 244 XMMS, include support for this protocol.</p>
 245
 246 <p>See <tt>module-cli-protocol-{unix,tcp}</tt> for more information
 247 about the two possible suffixes of this module.</p>
 248
 249 <p>In addition to the options supported by <a href="module-cli-protocol"><tt>module-cli-protocol-*</tt></a>, this module supports:</p>
 250
 251 <table>
 252   <tr><td><tt>sink=</tt>, <tt>source=</tt></td><td>Specify the sink/source this service connects to</td></tr>
 253   <tr><td><tt>auth-anonymous=</tt></td><td>If set to 1 no authentication is required to connect to the service</td></tr>
 254   <tr><td><tt>cookie=</tt></td><td>Name of the cookie file for authentication purposes</td></tr>
 255 </table>
 256
 257 <p>This implementation misses some features the original ESOUND has: e.g. there is no sample cache yet. However: XMMS works fine.</p>
 258
 259 <h3>module-native-protocol-{unix,tcp}</h3>
 260
 261 <p>The native protocol of <tt>polypaudio</tt>.</p>
 262
 263 <p>See <tt>module-cli-protocol-{unix,tcp}</tt> for more information
 264 about the two possible suffixes of this module.</p>
 265
 266 <p>In addition to the options supported by <a href="module-cli-protocol"><tt>module-cli-protocol-*</tt></a>, this module supports:</p>
 267
 268 <table>
 269   <tr><td><tt>auth-anonymous=</tt></td><td>If set to 1 no authentication is required to connect to the service</td></tr>
 270   <tr><td><tt>auth-group=</tt></td><td>(only for <tt>-unix</tt>): members of the specified unix group may access the server without further auhentication.</td></tr>
 271   <tr><td><tt>cookie=</tt></td><td>Name of the cookie file for authentication purposes</td></tr>
 272 </table>
 273
 274 <h3>module-native-protocol-fd</h3>
 275
 276 <p>This is used internally when auto spawning a new daemon. Don't use it directly.</p>
 277
 278 <h3>module-http-protocol-tcp</h3>
 279
 280 <p>A proof-of-concept HTTP module, which can be used to introspect
 281 the current status of the polypaudio daemon using HTTP. Just load this
 282 module and point your browser to <a
 283 href="http://localhost:4714/">http://localhost:4714/</a>. This module takes the same arguments
 284 as <tt>module-cli-protocol-tcp</tt>.</p>
 285
 286 <h2>X Window System</h2>
 287
 288 <h3>module-x11-bell</h3>
 289
 290 <p>Intercepts X11 bell events and plays a sample from the sample cache on each occurence.</p>
 291
 292 <table>
 293   <tr><td><tt>display=</tt></td><td>X11 display to connect to. If ommited defaults to the value of <tt>$DISPLAY</tt></td></tr>
 294   <tr><td><tt>sample=</tt></td><td>The sample to play. If ommited defaults to <tt>x11-bell</tt>.</td></tr>
 295   <tr><td><tt>sink=</tt></td><td>Name of the sink to play the sample on. If ommited defaults to the default sink.</td></tr>
 296 </table>
 297
 298 <h3>module-x11-publish</h3>
 299
 300 <p>Publishes the access credentials to the Polypaudio server in the
 301 X11 root window. The following properties are used:
 302 <tt>POLYP_SERVER</tt>, <tt>POYLP_SINK</tt>, <tt>POLYP_SOURCE</tt>,
 303 <tt>POLYP_COOKIE</tt>. This is very useful when using SSH or any other
 304 remote login tool for logging into other machines and getting audio
 305 playback to your local speakers. The Polypaudio client libraries make
 306 use of this data automatically. Instead of using this module you may
 307 use the tool <tt>pax11publish</tt> which may be used to access, modify
 308 and import credential data from/to the X11 display.</p>
 309
 310 <table>
 311   <tr><td><tt>display=</tt></td><td>X11 display to connect to. If ommited defaults to the value of <tt>$DISPLAY</tt></td></tr>
 312   <tr><td><tt>sink=</tt></td><td>Name of the default sink. If ommited this property isn't stored in the X11 display.</td></tr>
 313   <tr><td><tt>source=</tt></td><td>Name of the default source. If ommited this property isn't stored in the X11 display.</td></tr>
 314   <tr><td><tt>cookie=</tt></td><td>Name of the cookie file of the
 315 cookie to store in the X11 display. If ommited the cookie of an
 316 already loaded protocol module is used.</td></tr> </table>
 317
 318 <h2>Volume Control</h2>
 319
 320 <h3>module-mmkbd-evdev</h3>
 321
 322 <p>Adjust the volume of a sink when the special multimedia buttons of modern keyboards are pressed.</p>
 323
 324 <table>
 325   <tr><td><tt>device=</tt></td><td>Linux input device ("<tt>evdev</tt>", defaults to <tt>/dev/input/event0</tt>)</td></tr>
 326   <tr><td><tt>sink=</tt></td><td>The sink to control</td></tr>
 327 </table>
 328
 329 <h3>module-lirc</h3>
 330
 331 <p>Adjust the volume of a sink when the volume buttons of an infrared remote control are pressed (through LIRC).</p>
 332
 333 <table>
 334   <tr><td><tt>config=</tt></td><td>The LIRC configuration file</td></tr>
 335   <tr><td><tt>appname=</tt></td><td>The application name to pass to LIRC (defaults to <tt>polypaudio</tt>)</td></tr>
 336   <tr><td><tt>sink=</tt></td><td>The sink to control</td></tr>
 337 </table>
 338
 339 <a name="rtp"/>
 340 <h2>RTP/SDP/SAP Transport</h2>
 341
 342 <p>Polypaudio can stream audio data to an IP multicast group via the
 343 standard protocols <a
 344 href="http://en.wikipedia.org/wiki/Real-time_Transport_Protocol">RTP</a>,
 345 <a
 346 href="http://en.wikipedia.org/wiki/Session_Announcement_Protocol">SAP</a>
 347 and <a
 348 href="http://en.wikipedia.org/wiki/Session_Description_Protocol">SDP</a>
 349 (RFC3550, RFC3551, RFC2327, RFC2327). This can be used for multiple
 350 different purposes: for sharing a single microphone on multiple
 351 computers on the local LAN, for streaming music from a single
 352 controlling PC to multiple PCs with speakers or to implement a simple
 353 "always-on" teleconferencing solution.</p>
 354
 355 <p>The current implementation is designed to be used exlusively in
 356 local area networks, though Internet multicasting is theoretically
 357 supported. Only uncompressed audio is supported, hence you won't be
 358 able to multicast more than a few streams at the same time over a
 359 standard LAN.</p>
 360
 361 <p>Polypaudio implements both a sender and a reciever for RTP
 362 traffic. The sender announces itself via SAP/SDP on the same multicast
 363 group as it sends the RTP data to. The reciever picks up the SAP/SDP
 364 announcements and creates a playback stream for each
 365 session. Alternatively you can use any RTP capable client to
 366 recieve and play back the RTP data (such as <tt>mplayer</tt>).</p>
 367
 368 <h3>module-rtp-send</h3>
 369
 370 <p>This is the sender side of the RTP/SDP/SAP implementation. It reads
 371 audio data from an existing source and forwards it to the network
 372 encapsulated in RTP. In addition it sends SAP packets with an SDP
 373 session description.</p>
 374
 375 <p>In combination with the monitor source of <tt>module-null-sink</tt>
 376 you can use this module to create an RTP sink.</p>
 377
 378 <table>
 379   <tr><td><tt>source=</tt></td><td>The source to read the audio data from. If ommited defaults to the default source.</td></tr>
 380   <tr><td><tt>format=, rate=, channels=</tt></td><td>Sample format to use, defaults to the source's.</td></tr>
 381   <tr><td><tt>destination=</tt></td><td>Destination multicast group for both RTP and SAP packets, defaults to <tt>224.0.0.56</tt></td></tr>
 382   <tr><td><tt>port=</tt></td><td>Destination port number of the RTP
 383 traffic. If ommited defaults to a randomly chosen even port
 384 number. Please keep in mind that the RFC suggests to use only even
 385 port numbers for RTP traffic.</td></tr>
 386   <tr><td><tt>mtu=</tt></td><td>Maximum payload size for RTP packets. If ommited defaults to 1280</td></tr>
 387   <tr><td><tt>loop=</tt></td><td>Takes a boolean value, specifying whether locally generated RTP traffic should be looped back to the local host. Disabled by default.</td></tr>
 388 </table>
 389
 390 <h3>module-rtp-recv</h3>
 391
 392 <p>This is the reciever side of the RTP/SDP/SAP implementation. It
 393 picks up SAP session announcements and creates an RTP playback stream
 394 for each.</p>
 395
 396 <p>In combination with <tt>module-null-sink</tt> you can use this
 397 module to create an RTP source.</p>
 398
 399 <table>
 400   <tr><td><tt>sink=</tt></td><td>The sink to connect to. If ommited defaults to the default sink.</td></tr>
 401   <tr><td><tt>sap_address=</tt></td><td>The multicast group to join for SAP announcements, defaults to <tt>224.0.0.56</tt>.</td></tr>
 402 </table>
 403
 404 <h2>JACK Connectivity</h2>
 405
 406 <p>Polypaudio can be hooked up to a <a
 407 href="http://jackit.sourceforge.net/">JACK Audio Connection Kit</a> server which is a specialized sound server used for professional audio production on Unix/Linux. Both a
 408 Polypaudio sink and a source are available. For each channel a port is
 409 created in the JACK server.</p>
 410
 411 <h3>module-jack-sink</h3>
 412
 413 <p>This module implements a Polypaudio sink that connects to JACK and registers as many output ports as requested.</p>
 414
 415 <table>
 416   <tr><td><tt>sink_name=</tt></td><td>The name for the Polypaudio sink. If ommited defaults to <tt>jack_out</tt>.</td></tr>
 417   <tr><td><tt>server_name=</tt></td><td>The JACK server to connect to. If ommited defaults to the default server.</td></tr>
 418   <tr><td><tt>client_name=</tt></td><td>The client name to tell the JACK server. If ommited defaults to <tt>polypaudio</tt>.</td></tr>
 419   <tr><td><tt>channels=</tt></td><td>Number of channels to register. If ommited defaults to the number of physical playback ports of the JACK server.</td></tr>
 420   <tr><td><tt>connect=</tt></td><td>Takes a boolean value. If enabled (the default) Polypaudio will try to connect its ports to the physicial playback ports of the JACK server</td></tr>
 421 </table>
 422
 423 <h3>module-jack-source</h3>
 424
 425 <p>This module implements a Polypaudio source that connects to JACK
 426 and registers as many input ports as requested. Takes the same
 427 arguments as <tt>module-jack-sink</tt>, except for <tt>sink_name</tt>
 428 which is replaced by <tt>source_name</tt> (with a default of <tt>jack_in</tt>) for obvious reasons.</p>
 429
 430 <h2>Miscellaneous</h2>
 431
 432 <h3>module-sine</h3>
 433
 434 <p>Creates a sink input and generates a sine waveform stream.</p>
 435
 436 <table>
 437   <tr><td><tt>sink=</tt></td><td>The sink to connect to. If ommited defaults to the default sink.</td></tr>
 438   <tr><td><tt>frequency=</tt></td><td>The frequency to generate in Hertz. Defaults to 440.</td></tr>
 439 </table>
 440
 441 <h3>module-esound-compat-spawnfd</h3>
 442
 443 <p>This is a compatibility module for <tt>libesd</tt> based autospawning of polypaudio. Don't use it directly.</p>
 444
 445 <h3>module-esound-compat-spawnpid</h3>
 446
 447 <p>This is a compatibility module for <tt>libesd</tt> based autospawning of polypaudio. Don't use it directly.</p>
 448
 449 <h3>module-match</h3>
 450
 451 <p>Adjust the volume of a playback stream automatically based on its name.</p>
 452
 453 <table>
 454   <tr><td><tt>table=</tt></td><td>The regular expression matching table file to use</td></tr>
 455 </table>
 456
 457 <p>The table file should contain a regexp and volume on each line, seperated by spaces. An example:</p>
 458
 459 <pre>
 460 ^sample: 25
 461 </pre>
 462
 463 <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>
 464
 465 <h3>module-detect</h3>
 466
 467 <p>Automatically detect the available sound hardware and load modules for it. Supports OSS, ALSA, Solaris and Win32 output drivers.
 468
 469 <table>
 470   <tr><td><tt>just-one=</tt></td><td>If set to <tt>1</tt> the module will only try to load a single sink/source and than stop.</td></tr>
 471 </table>
 472
 473 <h3>module-zeroconf-publish</h3>
 474
 475 <p>Publish all local sinks/sources using mDNS Zeroconf.</p>
 476
 477
 478 <hr/>
 479 <address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, April 2006</address>
 480 <div class="grey"><i>$Id$</i></div>
 481 </body> </html>