~~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. Along with OSS and ALSA, it also upports PulseAudio and Sndio.

The Xfce panel plugin presents itself with a nice speaker icon. Clicking onto the icon, the volume can be changed:

<figure "xfce4-mixer Speaker Icon">
{{:apps:xfce4-mixer:volume.png|xfce4-mixer Speaker Icon}}
</figure>

There's also the well-known context menu, providing muting functionality, running the mixer application or opening the properties dialog:

<figure "xfce4-mixer Context Menu">
{{:apps:xfce4-mixer:menu.png|xfce4-mixer Context Menu Window}}
</figure>

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:

<figure "xfce4-mixer Sound Card and Channel Dialog">
{{:apps:xfce4-mixer:settings.png |xfce4-mixer Sound Card and Channel Dialog Window}}
</figure>

In addition, it provides a simple-to-use mixer application. Of course, everything is fully translated into many different languages:

<figure "xfce4-mixer Application">
{{:apps:xfce4-mixer:alsa.png?600|xfce4-mixer Application Window}} 
</figure>

The mixer works smoothly not only with the well-known ALSA setup, but also with PulseAudio:

<figure "xfce4-mixer using PulseAudio">
{{:apps:xfce4-mixer:mixer.png?600|xfce4-mixer using PulseAudio}}
</figure>

----

===== 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]]** (older versions of this component are also available here)

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

----

===== Reporting Bugs =====
  * **[[:apps:xfce4-mixer:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports


[[|Back To Top]]
----
[[ :start:|Return to Xfce Main Documentation Page]]