Xfce Wiki

Sub domains


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:

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

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:

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

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

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)


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

  • xfce4-mixer 4.18.1 released (2023/05/01 20:21)


Back to Top

Source Code Repository

Reporting Bugs

Back To Top

Return to Main Xfce documentation page