~~NOTOC~~

====== xfce4-mixer ======

  * **[[#Keyboard Shortcuts|Keyboard Shortcuts]]**
  * **[[#Xfconf Configuration|Xfconf Configuration]]**
  * **[[#Debugging|Debugging]]**
  * **[[#Known Problems with GStreamer|Known Problems with GStreamer]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

This package contains a volume control application based on GStreamer written
to conceptually fit into the Xfce desktop environment. It also includes a plugin for the Xfce panel. Apart from OSS and ALSA, it supports PulseAudio and Sndio.

The Xfce panel plugin presents itself with a nice speaker icon. Clicking onto the icon, volume can be changed:
{{ :apps:xfce4-mixer:volume.png?nolink |}}

There's also the well-known context menu, providing muting functionality, running the mixer application or opening the properties dialog:
{{ :apps:xfce4-mixer:menu.png?nolink |}}

For the plugin and volume settings to work, you have to have the correct sound card and channel selected in the plugin's properties dialog:
{{ :apps:xfce4-mixer:settings.png?nolink |}}

In addition, it provides a simple-to-use mixer application. Of course, everything is fully translated into many different languages:
{{ :apps:xfce4-mixer:alsa.png?nolink |}} 

The mixer works smoothly not only with the well-known ALSA setup, but also with PulseAudio:
{{ :apps:xfce4-mixer:mixer.png?nolink |}}


----

===== Keyboard Shortcuts =====

The panel plugin optionally supports global keyboard shortcuts for raising and
lowering the volume, as well as muting the selected track if compiled against
libkeybinder. The plugin will then handle the XF86AudioRaiseVolume,
XF86AudioLowerVolume, and XF86AudioMute keyboard symbols.

----

===== Xfconf Configuration =====

The mixer application supports the following properties in the xfce4-mixer
channel:

  * ''/window-width''               width of the main window (integer)
  * ''/window-height''              height of the main window width (integer)
  * ''/sound-card''                 selected sound card (string)
  * ''/sound-cards/*''              visible controls of a particular sound card (array of strings)

The panel plugin supports the following properties:

  * ''sound-card''                  selected sound card (string)
  * ''track''                       selected track (string)
  * ''command''                     command which can be run from the plugin menu (string)
  * ''enable-keyboard-shortcuts''   enables or disables keyboard shortcuts (boolean)

----

===== Debugging =====

Both the mixer application and the panel plugin have a builtin debugging mode
which will print additional diagnostic output useful for bug reports. For
xfce4-mixer it can be activated by specifying the ''<nowiki>--</nowiki>debug'' command line option,
diagnostic messages will be printed to stderr. For the panel plugin, please
follow the instructions at http://docs.xfce.org/xfce/xfce4-panel/debugging and
set the ''PANEL_DEBUG'' environment variable to ''xfce4-mixer-plugin,gdb'', the
diagnostic output will be printed to stderr and backtraces will appear in the
log file corresponding to the plugin.

----

===== Known Problems with GStreamer =====


  * No sound card detected: if this happens, you're probably missing a GStreamer plugin for your sound system. If you get this message on a Debian or Ubuntu system and you're using ALSA then installing gstreamer0.10-alsa should fix it. On OpenBSD installing gst-plugins-good might help.

----

===== Latest Release =====
{{rss>https://archive.xfce.org/feeds/project/xfce4-mixer 1 date 2h}}

[[https://gitlab.xfce.org/apps/xfce4-mixer/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/apps/xfce4-mixer/|Download current release]]** (link also contains older versions)

[[|Back to Top]]
----
===== Source Code Repository =====
[[https://gitlab.xfce.org/apps/xfce4-mixer|]]

----

===== Reporting Bugs =====
  * **[[:apps:xfce4-mixer:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs


[[|Back To Top]]
----
[[ :start:|Return to Main Xfce documentation page]]