path: root/README.md

pavucontrol-qt
Overview
pavucontrol-qt is the Qt port of volume control pavucontrol of sound server PulseAudio.   
As such it can be used to adjust all controls provided by PulseAudio as well as some additional settings.   
The software belongs to the LXQt project but its usage isn't limited to this desktop environment.   
Installation
Compiling source code
Runtime dependencies are qtbase and PulseAudio client library libpulse. 

Additional build dependencies are CMake and liblxqt as well as optionally Git to pull latest VCS checkouts. The localization files were outsourced to repository lxqt-l10n so the corresponding dependencies are needed, too. Please refer to this repository's README.md for further information.
Code configuration is handled by CMake. CMake variable CMAKE_INSTALL_PREFIX has to be set to /usr on most operating systems.   
To build run make, to install make install which accepts variable DESTDIR as usual.   
Binary packages
On Arch Linux the package pavucontrol-qt can be used and pavucontrol-qt-git is to build current checkouts of branch master.
On FreeBSD the binary package is available as pavucontrol-qt and can be installed with pkg install pavucontrol-qt.
Debian
Package pavucontrol-qt is available in the official repositories as of Debian buster. 
Fedora
Package pavucontrol-qt is available in the official repositories as of Fedora 31. 
OpenSuse
Package pavucontrol-qt is available in the official repositories as of openSUSE Leap:15.2 
Usage
In LXQt sessions the binary is placed in sub-menu "Sound & Video" of the panel's main menu.   
The usage itself should be self-explanatory.
Translations
Translations can be done in LXQt-Weblate.