README.html.in 10.3 KB
Newer Older
Tanu Kaskinen's avatar
Tanu Kaskinen committed
1
<?xml version="1.0" encoding="utf-8"?> <!-- -*-html-helper-*- -->
2
3
4
5
<!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>
Tanu Kaskinen's avatar
Tanu Kaskinen committed
6
<meta charset="utf-8" />
Lennart Poettering's avatar
Lennart Poettering committed
7
<title>PulseAudio Volume Control @PACKAGE_VERSION@</title>
8
9
10
11
<link rel="stylesheet" type="text/css" href="style.css" />
</head>

<body>
Lennart Poettering's avatar
Lennart Poettering committed
12
<h1><a name="top">PulseAudio Volume Control @PACKAGE_VERSION@</a></h1>
13
14
15
16
17
18
19
20
21
22

<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="#download">Download</a></li>
23
24
    <li><a href="#bugs">Bug Reports</a></li>
    <li><a href="#patches">Contributing Code</a></li>
25
    <li><a href="#translations">Contributing Translations</a></li>
26
27
28
29
30
</ul>

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

<p>This program is free software; you can redistribute it and/or
31
32
33
modify it under the terms of the GNU Public License as published by
the Free Software Foundation, either version 2 of the License, or (at
your option) any later version.</p>
34
35
36
37
38
39
40
41

<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>

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

42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
<div class="news-date">Sun Aug 15 2021: </div>
<p class="news-text">
<a href="@PACKAGE_URL@pavucontrol-5.0.tar.xz">Version 5.0</a> released.
Changes:</p>
<ul>
<li>Support for switching Bluetooth codecs (new in PulseAudio 15.0).</li>
<li>Support for locking card profiles (new in PulseAudio 15.0). Locking
a profile prevents PulseAudio from automatically switching away from that
profile on plug/unplug events.</li>
<li>New translations: Asturian, Basque, Belarusian, Galician, Hebrew, Kazakh,
Norwegian Bokmål, Sinhala, Slovenian</li>
<li>Updated translations: Catalan, Chinese (Simplified), Chinese (Traditional),
Croatian, Danish, Dutch, Finnish, French, German, Hungarian, Italian, Japanese,
Korean, Lithuanian, Norwegian Nynorsk, Polish, Portugese, Portugese (Brazil),
Slovak, Spanish, Swedish, Turkish, Ukrainian.</li>
<li>Some bug fixes.</li>
<li>New dependency: json-glib.</li>
<li>Minimum gtkmm version bumped to 3.22.</li>
</ul>

Tanu Kaskinen's avatar
Tanu Kaskinen committed
62
<div class="news-date">Tue Mar 5 2019: </div>
63
64
65
66
67
68
69
70
71
72
<p class="news-text">
<a href="@PACKAGE_URL@pavucontrol-4.0.tar.xz">Version 4.0</a> released.
Changes:</p>
<ul>
<li>There can now be only one pavucontrol window open at a time. Trying to
start pavucontrol for a second time brings the first window to foreground.</li>
<li>Added a "Show volume meters" checkbox to the Configuration tab. Disabling
the volume meters reduces CPU use.</li>
<li>Improve the use of space (remove useless margins and paddings).</li>
<li>Use a more appropriate icon for the channel lock button.</li>
73
74
<li>Better channel label layout, prevents volume sliders from getting
unaligned.</li>
75
76
77
78
79
<li>Maximum latency offset increased from 2 to 5 seconds to accommodate AirPlay
devices that often have higher latency than 2 seconds (this is not that useful
on newer PulseAudio versions, though, because the latency is reported much more
accurately than before).</li>
<li>New --version command line option.</li>
80
81
82
83
<li>New translations: Chinese (Taiwan), Croatian, Korean, Norwegian Nynorsk,
Lithuanian, Valencian.</li>
<li>Updated translations: Finnish, French, German, Italian, Japanese, Polish,
Swedish.</li>
84
85
86
87
88
<li>Dropped support for Gtk+ 2.</li>
<li>Bumped the minimum supported libpulse version to 5.0.</li>
<li>Improved compatibility with newer Glade versions.</li>
</ul>

89
90
91
92
<div class="news-date">Tue Mar 24
2015: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-3.0.tar.xz">Version
3.0</a> released; improved error handling; remember device selection visibility; window sizing improvements.</p>

93
94
95
96
<div class="news-date">Fri Mar 8
2013: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-2.0.tar.xz">Version
2.0</a> released.</p>

Colin Guthrie's avatar
Colin Guthrie committed
97
98
99
100
<div class="news-date">Tue Sep 27
2011: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-1.0.tar.xz">Version
1.0</a> released.</p>

Colin Guthrie's avatar
Colin Guthrie committed
101
102
<div class="news-date">Thu Sep 15
2011: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-0.99.2.tar.gz">Version
103
0.99.2</a> (v1 RC2) released; digital receiver UI.</p>
Colin Guthrie's avatar
Colin Guthrie committed
104

Colin Guthrie's avatar
Colin Guthrie committed
105
106
107
108
<div class="news-date">Tue Aug 2
2011: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-0.99.1.tar.gz">Version
0.99.1</a> (v1 RC1) released; gtk3 support; source output volume support; key command handling; bugfixes.</p>

Lennart Poettering's avatar
Lennart Poettering committed
109
110
111
112
<div class="news-date">Wed Oct 14
2009: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-0.9.10.tar.gz">Version
0.9.10</a> released; minor fixes; translation updates.</p>

Lennart Poettering's avatar
Lennart Poettering committed
113
114
115
116
<div class="news-date">Thu Sep 10
2009: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-0.9.9.tar.gz">Version
0.9.9</a> released; allow configuring device ports; various updates.</p>

Lennart Poettering's avatar
Lennart Poettering committed
117
118
119
120
<div class="news-date">Mon Apr 13
2009: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-0.9.8.tar.gz">Version
0.9.8</a> released; allow configuring card profiles; various updates.</p>

Lennart Poettering's avatar
Lennart Poettering committed
121
122
123
124
<div class="news-date">Tue Sep 9
2008: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-0.9.7.tar.gz">Version
0.9.7</a> released; show volume meter for each stream and device.</p>

125
126
127
128
129
130
<div class="news-date">Fri Mar 28
2008: </div> <p class="news-text"><a href="@PACKAGE_URL@pavucontrol-0.9.6.tar.gz">Version
0.9.6</a> released; draw radio buttons instead of check boxes when
moving streams; fix crasher when connecting to a PA server that has no
default sink/source configured.</p>

Lennart Poettering's avatar
Lennart Poettering committed
131
132
133
134
<div class="news-date">Tue Oct 30 2007: </div> <p class="news-text"><a
href="@PACKAGE_URL@pavucontrol-0.9.5.tar.gz">Version 0.9.5</a>
released; rework UI; add context menu option to kill a playback stream; add context menu option to select the default device; use prettier channel names; filter non-application streams by default; support muting streams</p>

Lennart Poettering's avatar
Lennart Poettering committed
135
<div class="news-date">Sat Aug 26 2006: </div> <p class="news-text"><a
Lennart Poettering's avatar
Lennart Poettering committed
136
137
138
139
href="@PACKAGE_URL@pavucontrol-0.9.4.tar.gz">Version 0.9.4</a>
released; add the ability to move a stream to another device while it
is playing; limit the list of sinks/sources shown by their type; other cleanups</p>

Lennart Poettering's avatar
Lennart Poettering committed
140
141
142
<div class="news-date">Mon Jul 24 2006: </div> <p class="news-text"><a
href="@PACKAGE_URL@pavucontrol-0.9.3.tar.gz">Version 0.9.3</a> released; show client names only if they are set</p>

Lennart Poettering's avatar
Lennart Poettering committed
143
144
145
146
<div class="news-date">Sat Jul 8 2006: </div> <p class="news-text"><a
href="@PACKAGE_URL@pavucontrol-0.9.2.tar.gz">Version 0.9.2</a> released; update for <a href="http://pulseaudio.org/">PulseAudio 0.9.2</a></p>

<div class="news-date">Fri Jun 2 2006: </div> <p class="news-text"><a
Lennart Poettering's avatar
Lennart Poettering committed
147
148
href="@PACKAGE_URL@pavucontrol-0.9.1.tar.gz">Version 0.9.1</a> released; add a <tt>.desktop</tt> file; update icons everywhere</p>

Lennart Poettering's avatar
Lennart Poettering committed
149
<div class="news-date">Sat May 27 2006: </div> <p class="news-text"><a
Lennart Poettering's avatar
Lennart Poettering committed
150
href="@PACKAGE_URL@pavucontrol-0.9.0.tar.gz">Version 0.9.0</a> released; update for Polypaudio 0.9.0; show client name of playback streams; make volume slider more responsive</p>
Lennart Poettering's avatar
Lennart Poettering committed
151

152
153
154
155
156
<div class="news-date">Fri Apr 21 2006: </div> <p class="news-text"><a
href="@PACKAGE_URL@pavucontrol-0.8.tar.gz">Version 0.8</a> released; initial release</p>

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

Lennart Poettering's avatar
Lennart Poettering committed
157
<p>PulseAudio Volume Control (<tt>pavucontrol</tt>) is a simple GTK
158
based volume control tool ("mixer") for the <a
Tanu Kaskinen's avatar
Tanu Kaskinen committed
159
href="http://pulseaudio.org/">PulseAudio
Lennart Poettering's avatar
Lennart Poettering committed
160
161
sound server</a>. In contrast to classic mixer tools this one allows
you to control both the volume of hardware devices and of each
162
playback stream separately.</p>
163
164
165
166
167

<p>Everybody loves <a href="@PACKAGE_URL@/screenshot.png">screenshots</a>.</p>

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

Lennart Poettering's avatar
Lennart Poettering committed
168
<p>Works perfectly.</p>
Lennart Poettering's avatar
Lennart Poettering committed
169

170
171
172
173
174
175
<h2><a name="documentation">Documentation</a></h2>

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

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

176
177
<p>Currently, <tt>pavucontrol</tt> is tested on Linux only. It should work on
most Linux distributions.</p>
178

Tanu Kaskinen's avatar
Tanu Kaskinen committed
179
<p><tt>pavucontrol</tt> requires <a href="http://www.gtkmm.org"><tt>gtkmm</tt></a> and <tt>glademmm</tt> installed.</p>
180

Tanu Kaskinen's avatar
Tanu Kaskinen committed
181
<p>Obviously <tt>pavucontrol</tt> requires an installation of <a href="http://pulseaudio.org/">PulseAudio</a>.</p>
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196

<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>pavucontrol</tt>.</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@pavucontrol-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p>

197
<p>Get <tt>pavucontrol</tt>'s development sources from the git <a href="https://gitlab.freedesktop.org/pulseaudio/pavucontrol.git">repository</a> (<a href="https://gitlab.freedesktop.org/pulseaudio/pavucontrol">GitLab</a>): </p>
198

199
<pre>git clone https://gitlab.freedesktop.org/pulseaudio/pavucontrol.git</pre>
200

201
202
203
204
205
206
207
208
<h2><a name="bugs">Bug Reports</a></h2>

<p>Here's the list of open bug reports: <a href="https://gitlab.freedesktop.org/pulseaudio/pavucontrol/issues">https://gitlab.freedesktop.org/pulseaudio/pavucontrol/issues</a></p>

<p>And here you can create a new bug report: <a href="https://gitlab.freedesktop.org/pulseaudio/pavucontrol/issues/new">https://gitlab.freedesktop.org/pulseaudio/pavucontrol/issues/new</a></p>

<h2><a name="patches">Contributing Code</a></h2>

209
<p>If you have patches for pavucontrol, the primary method for submitting them is by creating a merge request in <a href="https://gitlab.freedesktop.org/pulseaudio/pavucontrol">GitLab</a>.</p>
210

211
212
213
214
<h2><a name="translations">Contributing Translations</a></h2>

<p>Translations can be contributed in <a href="https://translate.fedoraproject.org/projects/pulseaudio/pavucontrol/">Fedora's Weblate translation service</a>. Pavucontrol isn't affiliated with Fedora otherwise, but Fedora kindly offered to host the translation service for us.</p>

215
216
</body>
</html>