# PulseAudio Volume Control 5.0

## License

This program is free software; you can redistribute it and/or 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.

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.

## News

Sun Aug 15 2021:

Version 5.0 released. Changes:

- Support for switching Bluetooth codecs (new in PulseAudio 15.0).
- 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.
- New translations: Asturian, Basque, Belarusian, Galician, Hebrew, Kazakh, Norwegian Bokmål, Sinhala, Slovenian
- 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.
- Some bug fixes.
- New dependency: json-glib.
- Minimum gtkmm version bumped to 3.22.

Tue Mar 5 2019:

Version 4.0 released. Changes:

- 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.
- Added a "Show volume meters" checkbox to the Configuration tab. Disabling the volume meters reduces CPU use.
- Improve the use of space (remove useless margins and paddings).
- Use a more appropriate icon for the channel lock button.
- Better channel label layout, prevents volume sliders from getting unaligned.
- 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).
- New --version command line option.
- New translations: Chinese (Taiwan), Croatian, Korean, Norwegian Nynorsk, Lithuanian, Valencian.
- Updated translations: Finnish, French, German, Italian, Japanese, Polish, Swedish.
- Dropped support for Gtk+ 2.
- Bumped the minimum supported libpulse version to 5.0.
- Improved compatibility with newer Glade versions.

Tue Mar 24 2015:

Version 3.0 released; improved error handling; remember device selection visibility; window sizing improvements.

Fri Mar 8 2013:

Version 2.0 released.

Tue Sep 27 2011:

Version 1.0 released.

Thu Sep 15 2011:

Version 0.99.2 (v1 RC2) released; digital receiver UI.

Tue Aug 2 2011:

Version 0.99.1 (v1 RC1) released; gtk3 support; source output volume support; key command handling; bugfixes.

Wed Oct 14 2009:

Version 0.9.10 released; minor fixes; translation updates.

Thu Sep 10 2009:

Version 0.9.9 released; allow configuring device ports; various updates.

Mon Apr 13 2009:

Version 0.9.8 released; allow configuring card profiles; various updates.

Tue Sep 9 2008:

Version 0.9.7 released; show volume meter for each stream and device.

Fri Mar 28 2008:

Version 0.9.6 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.

Tue Oct 30 2007:

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

Sat Aug 26 2006:

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

Mon Jul 24 2006:

Version 0.9.3 released; show client names only if they are set

Sat Jul 8 2006:

Version 0.9.2 released; update for PulseAudio 0.9.2

Fri Jun 2 2006:

Version 0.9.1 released; add a `.desktop` file; update icons everywhere

Sat May 27 2006:

Version 0.9.0 released; update for Polypaudio 0.9.0; show client name of playback streams; make volume slider more responsive

Fri Apr 21 2006:

Version 0.8 released; initial release

## Overview

PulseAudio Volume Control (`pavucontrol`) is a simple GTK based volume control tool ("mixer") for the PulseAudio sound server. In contrast to classic mixer tools this one allows you to control both the volume of hardware devices and of each playback stream separately.

Everybody loves screenshots.

## Current Status

Works perfectly.

## Documentation

There is not much to say. Just run `pavucontrol` and see for yourself.

## Requirements

Currently, `pavucontrol` is tested on Linux only. It should work on most Linux distributions.

`pavucontrol` requires `gtkmm` and `glademmm` installed.

Obviously `pavucontrol` requires an installation of PulseAudio.

## Installation

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

## Download

The newest release is always available from http://freedesktop.org/software/pulseaudio/pavucontrol/

The current release is 5.0

Get `pavucontrol`'s development sources from the git repository (GitLab):

    git clone https://gitlab.freedesktop.org/pulseaudio/pavucontrol.git

## Bug Reports

Here's the list of open bug reports: https://gitlab.freedesktop.org/pulseaudio/pavucontrol/issues

And here you can create a new bug report: https://gitlab.freedesktop.org/pulseaudio/pavucontrol/issues/new

## Contributing Code

If you have patches for pavucontrol, the primary method for submitting them is by creating a merge request in GitLab.

## Contributing Translations

Translations can be contributed in Fedora's Weblate translation service. Pavucontrol isn't affiliated with Fedora otherwise, but Fedora kindly offered to host the translation service for us.