---
name: "pasystray"
section: "1"
platform: "linux"
package: "pasystray"
version: "0.8.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pasystray"
---

# pasystray(1)

PulseAudio controller for the system tray

## 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)](/pactl/1.md) 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.

## SEE ALSO

[**pulseaudio**(1)](/pulseaudio/1.md), [**pactl**(1)](/pactl/1.md).

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