summaryrefslogtreecommitdiffstats
path: root/doc/README.html.in
blob: 377764301c8da06baac5ba007c42fd26376887b7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
<?xml version="1.0" encoding="iso-8859-1"?> <!-- -*-html-helper-*- -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">

<head>
<title>PulseAudio Device Chooser @PACKAGE_VERSION@</title>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>

<body>
<h1><a name="top">PulseAudio Device Chooser @PACKAGE_VERSION@</a></h1>

<p><i>Copyright 2006 Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;</i></p>

<ul class="toc">
    <li><a href="#license">License</a></li>
    <li><a href="#news">News</a></li>
    <li><a href="#overview">Overview</a></li>
    <li><a href="#status">Current Status</a></li>
    <li><a href="#documentation">Documentation</a></li>
    <li><a href="#requirements">Requirements</a></li>
    <li><a href="#installation">Installation</a></li>
    <li><a href="#acks">Acknowledgements</a></li>
    <li><a href="#download">Download</a></li>
</ul>

<h2><a name="license">License</a></h2>

<p>This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.</p>

<p>This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.</p>

<p>You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.</p>

<h2><a name="news">News</a></h2>

<div class="news-date">Sat Aug 26 2006: </div> <p class="news-text"><a
href="@PACKAGE_URL@padevchooser-0.9.3.tar.gz">Version 0.9.3</a> released; add menu item for starting the <a href="http://0pointer.de/lennart/projects/paprefs/">PulseAudio Preferences</a></p>

<div class="news-date">Sat Jul 8 2006: </div> <p class="news-text"><a
href="@PACKAGE_URL@padevchooser-0.9.2.tar.gz">Version 0.9.2</a> released; initial release</p>

<h2><a name="overview">Overview</a></h2>

<p>PulseAudio Device Chooser (<tt>padevchooser</tt>) is a simple GTK
tool which registers an icon in the tray area and allows quick access to some features of the <a
href="http://0pointer.de/lennart/projects/pulseaudio/">PulseAudio
sound server</a>. Specifically it can do for you:</p>

<ul>
  <li>Notify about new sink/sources becoming available on the LAN</li>
  <li>Quickly change the default PulseAudio sink/source/server assigned to the current X11 display, selecting devices available on the LAN</li>
  <li>Start the auxiliary tools <a href="http://0pointer.de/lennart/projects/pavucontrol/">PulseAudio Volume Control</a>, <a href="http://0pointer.de/lennart/projects/pavumeter/">PulseAudio Volume Meter</a>, <a href="http://0pointer.de/lennart/projects/paman/">PulseAudio Manager</a>, <a href="http://0pointer.de/lennart/projects/paprefs/">PulseAudio Preferences</a>
</ul>
  
<p>Everybody loves <a href="@PACKAGE_URL@/screenshot.png">screenshots</a>.</p>

<h2><a name="status">Current Status</a></h2>

<p>Works perfectly.</p>
  
<h2><a name="documentation">Documentation</a></h2>

<p>There is not much to say. Just run <tt>padevchooser</tt> and see for yourself.</p>

<h2><a name="requirements">Requirements</a></h2>

<p>Currently, <tt>padevchooser</tt> is tested on Linux only.</p>

<p><tt>padevchooser</tt> was developed and tested on Debian GNU/Linux
"testing" from June 2006, it should work on most other Linux
distributions (and maybe Unix versions) since it uses GNU autoconf for
source code configuration.</p>

<p><tt>padevchooser</tt> requires GTK 2.4, <tt>libnotify</tt>, GConf installed.</p>

<p>Obviously <tt>padevchooser</tt> requires an installation of <a
href="http://pulseaudio.org/">PulseAudio</a> (version 0.9.2), compiled
with ZeroConf support. For being discovered correctly PulseAudio
servers need to load <tt>module-zeroconf-publish</tt> and
<tt>module-native-protocol-tcp</tt>.</p>

<h2><a name="installation">Installation</a></h2>

<p>As this package is made with the GNU autotools you should run
<tt>./configure</tt> inside the distribution directory for configuring
the source tree. After that you should run <tt>make</tt> for
compilation and <tt>make install</tt> (as root) for installation of
<tt>padevchooser</tt>.</p>

<h2><a name="acks">Acknowledgements</a></h2>

<p>None so far.</p>

<h2><a name="download">Download</a></h2>

<p>The newest release is always available from <a href="@PACKAGE_URL@">@PACKAGE_URL@</a></p>

<p>The current release is <a href="@PACKAGE_URL@padevchooser-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p>

<p>Get <tt>padevchooser</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="svn://svn.0pointer.net/padevchooser">repository</a> (<a href="http://0pointer.net/cgi-bin/viewcvs.cgi/?root=padevchooser">viewcvs</a>): </p>

<pre>svn checkout svn://svn.0pointer.net/padevchooser/trunk padevchooser</pre>

<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/padevchooser/">Freshmeat</a>.</p>

<hr/>
<address class="grey">Lennart Poettering &lt;@PACKAGE_BUGREPORT@&gt;, August 2006</address>
<div class="grey"><i>$Id$</i></div>

</body>
</html>