Your company here, and a link to your site. Click to find out more.

pasystray - Man Page

PulseAudio controller for the system tray


pasystray [options]


pasystray enables control of various PulseAudio server settings from the X11 system tray. Clicking the tray icon will display a graphical menu, allowing the user to:

Mouse Bindings

Status icon:

Source/Sink menu item:

Playback/record stream menu item:

Optional Pulseaudio Modules

pasystray can make use of the following PulseAudio modules:

These modules may need to be loaded, using e.g. pactl(1) or pasystray itself.

Remote Sinks/Sources

In order to detect remote sinks/source, as well as enabling module-zeroconf-discover locally, module-zeroconf-publish must be enabled on the remote server.

Remote Server

As with most PulseAudio-aware applications, the environment variable PULSE_SERVER may be set to the address of a remote host in order to use pasystray to control the server running on that host.


This program follows the usual GNU command line syntax, with long options starting with two dashes (`-').

-V,  --version

Show the program version.

-d,  --debug

Print debugging information.

-m,  --volume-max=N

Set the maximum volume (in percent).

-i,  --volume-inc=N

Set the volume increment.

-r,  --reverse-scroll

Reverse the direction of volume adjustment with the mouse scroll wheel.

-t,  --no-icon-tooltip

Disable the status icon tooltip for the connected state.

-n,  --no-notify

Disable all notifications. Deprecated; use --notify=none instead.

-a,  --always-notify

Enable notifications for all changes in pulsaudio. Deprecated; use --notify=all instead.


Show monitor sources.

-g,  --key-grabbing

Enable keyboard volume control and mute keys to adjust volume settings.

-N,  --notify=option

Set notification options; use --notify=help for a list of valid options.

See Also

pulseaudio(1), pactl(1).

Homepage: https://github.com/christophgysin/pasystray


June 14, 2018