pasystray(1)

PulseAudio controller for the system tray

Section 1 pasystray bookworm source

Description

PASYSTRAY

NAME

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