.TH AUMIX 1 
.SH NAME
aumix \- adjust audio mixer
.SH SYNOPSIS
.B aumix
[\-<channel option>[ ]<level>|R[ecord]|P[lay]|q[uery]]
[-d] [-h] [-I{d|c}] [-L] [-q] [-S]

.SH DESCRIPTION
This program adjusts the settings of the audio mixing device.  It can be
used from the command line, in scripts, or interactively with the keyboard
or mouse. 

.SH OPTIONS
.SS CHANNEL OPTIONS
.TP
.I \-v percent|q[uery]
set main volume to
.I percent
of maximum, or print setting
.TP
.I \-b percent|q[uery]
set bass to
.I percent
of maximum, or print setting
.TP
.I \-t percent|q[uery]
set treble to
.I percent
of maximum, or print setting
.TP
.I \-s percent|q[uery]
set synthesizer to
.I percent
of maximum, or print setting
.TP
.I \-w percent|q[uery]
set PCM to
.I percent
of maximum, or print setting
.TP
.I \-p percent|q[uery]
set PC speaker to
.I percent
of maximum, or print setting
.TP
.I \-l percent|q[uery]
set line to
.I percent
of maximum, or print setting
.TP
.I \-m percent|q[uery]
set microphone to
.I percent
of maximum, or print setting
.TP
.I \-c percent|q[uery]
set CD to
.I percent
of maximum, or print setting
.TP
.I \-x percent|q[uery]
set imix to
.I percent
of maximum, or print setting
.TP
.I \-i percent|q[uery]
set line in to
.I percent
of maximum, or print setting
.TP
.I \-o percent|q[uery]
set line out to
.I percent
of maximum, or print setting
.TP
.I \-1 percent|q[uery]
set line1 to
.I percent
of maximum, or print setting
.TP
.I \-2 percent|q[uery]
set line2 to
.I percent
of maximum, or print setting
.TP
.I \-3 percent|q[uery]
set line3 to
.I percent
of maximum, or print setting

.SS OTHER OPTIONS
.TP
.I \-d
adjust secondary mixer
.TP
.I \-h
display information on usage
.TP
.I \-Ic
run
.I aumix
interactively, using the full-screen ncurses-based interface and IBM graphic characters
.TP
.I \-Id
run interactively, without graphic characters
.TP
.I \-L
load settings from $HOME/.aumixrc, or /etc/aumixrc if the former is inaccessible
.TP
.I \-q
query all devices and print their settings
.TP
.I \-S
save settings to $HOME/.aumixrc
.SS EXAMPLE
.TP
aumix -q -v75 -m 0 -c R -m q

prints all settings, sets volume to 75%, sets microphone to 0, sets CD to record, and prints the new settings for the microphone

.RE
.SH INTERACTIVE USE
If no options are given on the command line, and it is compiled with ncurses,
.B aumix
will run interactively.
.SS LAYOUT
The left bank of controls is used for adjusting levels; the right bank is for adjusting balance.  Mixing channels not supported by your hardware will not be shown.  Mixing channels which are stereo-capable will have balance controls.
.SS KEYS
The following keys control
.B aumix
in interactive mode:
.TP
.I "PgUp, PgDn, up and down cursor

select a new control.
.TP
.I Tab, Enter, <, >, comma and period

toggle between level and balance controls

.TP
.I +, -, [, ], left and right cursor

adjust the setting of the current device.  The
.I +
and
.I right cursor
keys increase the level by 5%; the
.I \-
and
.I left cursor
keys decrease it by the same amount.  The
.I [
key sets it to 0% and
.I ]
sets it to 100%.  The same keys work analogously on the balance controls.
.TP
.I Space
toggles between record and play for controls which are capable of 
this.
.TP
.I |
centers the balance of the current device.
.TP
.I K or k
show a description of the functions of keys
.TP
.I L or l
load settings from $HOME/.aumixrc, falling back to /etc/aumixrc
.TP
.I M or m
mute or unmute
.TP
.I S or s
save settings to the rc file
.TP
.I Esc, Q
or
.I q

end the program
.RE
.LP

The
.I C-z,
.I C-d
and
.I C-c
keys also have their normal function (the screen is refreshed when
.B aumix
is brought to the foreground).

.SS MOUSE
In interactive mode,
.B aumix
can accept input from the mouse if
.B gpm
is running and
.B aumix
is compiled with
.B gpm
support.  If gpm is not running but gpm support is included, the message
.I mouse off
will appear at the top of the screen, and only keyboard input will be
accepted.  With
.B gpm
running, most functions can be performed through the mouse.  The mouse is
active whenever one of its buttons is held down.  While active, it works
in the
following ways:

- over a control track, it sets the control to match the position of the
mouse cursor.

- over a record/play indicator, it toggles the record/play state.

- over the 
.I Q
in 
.I Quit,
the
.I L
in
.I Load
or the
.I S
in
.I Save 
at the top of the screen, it causes those actions.
.SH FILES
/etc/aumixrc and $HOME/.aumixrc contain saved settings.
.SH VERSION
This page corresponds to aumix 1.11, released 11 August 1998. 
.SH BUGS
When leaving the program via the
.I Esc
key, there is a slight delay.  Use of the 
.I q
key is encouraged in its place.  Adjusting the level controls affects the balance.

.SH MAINTAINER 
Trevor Johnson <trevor@jpj.net>

.SH SEE ALSO

gpm(1)