pasystray - Man Page
PulseAudio controller for the system tray
Synopsis
pasystray [options]
Description
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:
- adjust the volume of streams and sinks/sources
- transfer streams between sinks/sources
- switch the default sink/source
- set the default server (PULSE_SERVER)
- detect network PulseAudio services
- rename devices
Mouse Bindings
Status icon:
- Middle-click / Alt + Left-click: toggle mute, default sink
- Ctrl + Middle-click / Ctrl + Alt + Left-click: toggle mute, default source
- Scroll up/down: adjust volume, default sink
- Ctrl + Scroll up/down: adjust volume, default source
Source/Sink menu item:
- Scroll up/down: adjust volume
- Left-click: set as default source/sink
- Middle-click / Alt + Left-click: toggle mute
- Right-click: open menu to move all outputs/inputs to this source/sink or rename it
Playback/record stream menu item:
- Scroll up/down: adjust volume
- Middle-click: toggle mute
Optional Pulseaudio Modules
pasystray can make use of the following PulseAudio modules:
- module-device-manager - device renaming
- module-zeroconf-discover - network device discovery
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.
Options
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.
- --include-monitors
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.