Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/christophgysin/pasystray
PulseAudio system tray
https://github.com/christophgysin/pasystray
Last synced: about 1 month ago
JSON representation
PulseAudio system tray
- Host: GitHub
- URL: https://github.com/christophgysin/pasystray
- Owner: christophgysin
- License: lgpl-2.1
- Created: 2011-10-08T15:16:53.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2023-08-29T19:41:01.000Z (over 1 year ago)
- Last Synced: 2024-09-02T00:55:10.937Z (3 months ago)
- Language: C
- Homepage:
- Size: 445 KB
- Stars: 442
- Watchers: 15
- Forks: 43
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- awesome - pasystray - System Tray (Installation / Program List)
README
# PulseAudio System Tray
[](https://github.com/christophgysin/pasystray/actions/workflows/build.yml)
A replacement for the deprecated padevchooser.
pasystray allows setting the default PulseAudio source/sink and moving
streams on the fly between sources/sinks without restarting the client
applications.
## Usage
```
Help Options:
-h, --help Show help options
--help-all Show all help options
--help-gtk Show GTK+ Options
Application Options:
-V, --version Print version and exit
-d, --debug Print debugging information
-m, --volume-max=N Maximum volume (in percent)
-i, --volume-inc=N Volume increment
-r, --reverse-scroll Reverse volume scroll direction
-t, --no-icon-tooltip Disable the status icon tooltip for the connected state
-n, --no-notify Deprecated, use --notify=none instead
-a, --always-notify Deprecated, use --notify=all instead
--include-monitors Include monitor sources
-g, --key-grabbing Grab volume control keys
-N, --notify=OPTION Set notification options, use --notify=help for a list of valid options
--display=DISPLAY X display to use
```
## Features
* switch default sink/source
* move playback/record stream to a different sink/source on the fly
* detect pulseaudio instances on the network with avahi
* set X property PULSE_SERVER (like padevchooser's "set default server")
* adjust volume/toggle mute of sinks/sources and playback/record streams
* rename devices (pulseaudio must have module-device-manager loaded)
To detect remote sinks/sources you need to enable module-zeroconf-discover on
the local PulseAudio instance and module-zeroconf-publish on the remote side.
To control a different server than the local instance, run pasystray as:
```bash
$ PULSE_SERVER=remote_host pasystray
```
## Mouse Bindings
over status icon:
* left/right-click: open menu
* ctrl + left-click: start pavucontrol
* middle-click / alt + left-click: toggle mute default sink
* ctrl + middle-click / ctrl + alt + left-click: toggle mute default source
* scroll up/down: adjust the default sink volume
* ctrl + scroll: adjust the default source volume
over source/sink:
* scroll up/down: adjust the volume of respective stream
* 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
over playback/record stream:
* scroll up/down: adjust the volume of respective stream
* middle-click: toggle mute
## Troubleshooting
If the pasystray icon is not displayed in your Unity system tray, you will have
to whitelist it. Read this for instructions:
http://askubuntu.com/questions/30742/how-do-i-access-and-enable-more-icons-to-be-in-the-system-tray
For Ubuntu 13.04 and above, AppIndicator is mandatory. Unfortunately, the
ctrl + click / ctrl + scroll bindings don't work with AppIndicator.