pamix(1)

NAME
PAMIX - Pulseaudio Terminal Mixer

SYONPSIS
pamix

DESCRIPTION
This is a pavucontrol inspired ncurses based pulseaudio mixer for the commandline

CONFIGURATION
pamix is configured using a file called pamix.conf inside the $XDG_CONFIG_HOME or $XDG_CONFIG_DIRS directories or their default values, should they not be set.
$XDG_CONFIG_HOME will be preferred over $XDG_CONFIG_DIRS.

COMMANDS

PAmix conf files support the following commands:
* set * bind * unbind * unbindall

characters after a ';' will be interpreted as comments and ignored

set

SYNOPSIS: set KEY=VALUE

set is used to set a variable. This is currently only relevant for the 'pulseaudio_autospawn' and 'default_tab' options.

bind

SYNOPSIS: bind KEYNAME MIXER-COMMAND [ARGUMENT]

bind is used to bind a keyname to a mixer-command.
Some mixer-commands require an argument.
You can bind a keyname to multiple mixer-commands.

unbind

SYNOPSIS: unbind KEYNAME

unbind will remove all bindings for the given keyname

unbindall

SYNOPSIS: unbindall

unbindall will remove all key bindings

PAMIX-COMMANDS

Pamix-Commands can be bound to keys using the bind command and are used to interact with pamix.
The following pamix-commands are currently supported: * quit * select-tab * select-next * select-prev * set-volume * add-volume * cycle-next * cycle-prev * toggle-lock * set-lock * toggle-mute * set-mute

quit

quit will cause PAmix to exit and takes no arguments.

select-tab

select-tab will select one of the following tabs: Output Devices, Input Devices, Playback, Recording, Cards
select-tab takes the number of the tab to switch to starting at 0 in the order mentioned.

select-next and select-prev

these commands are given the optional argument 'channel' they will select the next and previous channels. if no argument is given they will select the next and previous entry in the displayed tab.

set-volume

this command takes the targetvalue in form of a double as an argument.
depending on weather channels are locked, this command will set the volume of the selected entry/channel to the targetvalue given in the argument.
Example: bind 0 set-volume 1.0 ; this will set the volume to 100%

add-volume

this command takes a deltavalue in form of a double as an argument.
the deltavalue can be negative Example: bind h add-volume -0.05 ; this will reduce the volume by 5%

cycle-next and cycle-prev

these commands will change the device or port of the currently selected entry.
they dont take any arguments.

toggle-lock

this command toggles weather channels should be locked together for the currently selected entry
and takes no arguments.

set-lock

this command takes either '0' or '1' as an argument and sets the channel-lock like the toggle-lock mixer-command.

toggle-mute

toggles weather the currently selected entry is muted
and takes no arguments.

set-mute

works like the set-lock mixer-command, but sets weather the currently selected entry is muted or not

DEFAULT CONFIGURATION
pamix does not autospawn pulseaudio by default

Keybindings:
F1 show Playback tab
F2 show Recording tab
F3 show Output devices tab
F4 show Input devices tab
F4 show Cards tab
0-9 set volume to percentage (10%-100%)
j/down select next channel
J select next entry
k/up select previous channel
K select previous entry
h/left decrease volume
h/right increase volume
c un/lock channels
s/S select next/previous device/port