PASYSTRAY(1)

💅 PASYSTRAY — bestie edition ✨

okay so real talk: this is the manual page for pasystray, from the General Commands Manual section of your local man pages. she's a PulseAudio controller that lives in your X11 system tray, and she is lowkey iconic. let's get into it 🫶

---

🌸 NAME 🌸

pasystray — PulseAudio controller for the system tray. that's it, that's the vibe. 💖

---

✨ SYNOPSIS ✨

pasystray [options]

yes bestie, that's the whole thing. run it, pass it some options, watch it serve. 👑

---

🦋 DESCRIPTION 🦋

pasystray lets you control a bunch of your PulseAudio server settings right from the X11 system tray. click the tray icon and a graphical menu pops up, letting you:

• 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 ✏️

literally the whole audio situation, in one tiny icon. main character energy fr fr.

---

🖱️ 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. no cap, you might have to go load them yourself. 🙈

---

📡 REMOTE SINKS/SOURCES 📡

so if you wanna detect remote sinks/source, and also enable module-zeroconf-discover locally — module-zeroconf-publish must be enabled on the remote server. both sides gotta cooperate, it's giving teamwork. 🫶

---

🌐 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. point her at the host, she handles the rest. ✨

---

🎀 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. 🔔

bestie note: those two deprecated ones? they're on their way out. --notify=none and --notify=all are the glow-ups. don't get attached. 💅

---

👑 SEE ALSO 👑

• pulseaudio(1)
• pactl(1)

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

---

and that's a wrap on the PASYSTRAY(1) page, bestie — this version of the manual was dated June 14, 2018, and it's filed under PASYSTRAY(1) in the General Commands Manual. slay, go adjust some volumes. 💖✨🎀