AUMIX (1)
aumix, xaumix
adjust audio mixer
SYNOPSIS
aumix
[-<channel option>[[+|-][<amount>]]|[ ]<level>|R[ecord]|P[lay]|q[uery]]
[-d] [-f <rc file>][-C <color scheme file>][-h] [-I] [-L] [-q] [-S]
DESCRIPTION
This program adjusts the settings of an audio mixing device. It can be used from the command line, in scripts, or interactively with the keyboard or mouse. The
xaumix
script uses the
which
utility to find an terminal emulator for X (xterm, for example), and runs
aumix
in that.
OPTIONS
-tag -width Op
Fl v
main volume
Fl b
bass
Fl t
treble
Fl s
synthesizer
Fl w
PCM
Fl p
PC speaker
Fl l
line
Fl m
microphone
Fl c
CD
Fl x
imix
Fl i
line in
Fl o
line out
Fl 1
line 1
Fl 2
line 2
Fl 3
line 3
For each channel,
q
queries,
+
and
-
increment and decrement by one, or an amount if one is specified. If no
+
or
-
is given after the channel option, a number sets a specific level (monophonically).
-tag -width Op
Fl C Ar color scheme file
specify the name of a file containing a color scheme. This implies -I.
Fl d Ar device file
specify the name of the mixer device (default is /dev/mixer)
Fl f Ar rc file
specify file for saving and loading settings
Fl h
display information on usage
Fl I
run
interactively, using the full-screen ncurses-based interface. This is the default if no options are given, but must be specified in order to have
go into interactive mode after doing things non-interactively.
Fl L
load settings from $HOME/.aumixrc, or /etc/aumixrc if the former is inaccessible
Fl q
query all devices and print their settings
Fl S
save settings to $HOME/.aumixrc
EXAMPLE
aumix -q -v75 -m 0 -c R -c+10 -m q
prints all settings, sets volume to 75%, sets microphone to 0, sets CD to record, increases the CD level by ten (both left and right), and prints the new settings for the microphone.
INTERACTIVE USE
If no options are given on the command line, and
is compiled with ncurses, it will run interactively.
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.
The following keys control
in interactive mode:
-tag -width Op
Em page up, page down, up and down cursor
select a new control.
Em Tab, Enter, <, >, comma and period
toggle between level and balance controls
+ No , Em - No , Em [
,
] No , Em left and right cursor
and Em digits
adjust the setting of the current device. The
+ No and Em right cursor
keys increase the level by 3%; the
-
and
left cursor
keys decrease it by the same amount. The
off
[
key sets it to 0% and
]
sets it to 100%. The digits
1
to
9
set it to 10% through 90%. The same keys work analogously on the balance controls.
-tag -width Op
Em Space
toggles between record and play for controls which are capable of
this.
Em | centers the balance of the current device.
Em K No or Em k
show a description of the functions of keys
Em L No or Em l
load settings from $HOME/.aumixrc, falling back to /etc/aumixrc
Em M No or Em m
mute or unmute
Em O No or Em o
("only"): mute all channels but the current one
Em S No or Em s
save settings to the rc file
Em U No or Em u
undo any muting
Em Q , No or Em q
end the program
Em ^L
refresh screen
^Z,
^D
and
^C
also have their normal function (the screen is refreshed when
is brought to the foreground).
In interactive mode,
can accept input from the mouse if
gpm
is running and
is compiled with
gpm
support. If gpm is not running but gpm support is included, the message
mouse off
will appear at the top of the screen, and only keyboard input will be
accepted. With
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:
-bullet -compact
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
Q
in
Quit ,
the
L
in
Load ,
the
S
in
Save ,
the
K
in
Keys ,
the
M
in
Mute ,
the
O
in
Only ,
or the
U
in
Undo
at the top of the screen, it causes those actions to take place.
ENVIRONMENT
The
HOME
variable is used.
FILES
Saved settings for the mixer are kept in the /etc/aumixrc and $HOME/.aumixrc files, but can be kept anywhere if specified explicitly. Color schemes are normally kept in the directory given by DATADIRNAME at compilation time, but are preferentially
loaded from the current directory and can be kept anywhere so long as the path to them is specified. The format of these files is:
item foreground background
where item is one of "active", "axis", "handle", "hotkey", "menu", "play", "record", or "track" and foreground and background are one of "black", "red", "green", "yellow", "blue", "magenta", "cyan", or "white". The words should be separated by
whitespace and can be upper-, lower-, or mixed-case. Lines not matching all these conditions are ignored. Some samples of color schemes are provided, named after the sort of terminal where they should be most suitable.
If either foreground or background is given as "-", then the default color for that is used. The defaults are a white foreground and black background.
Two xpm icons are provided.
VERSION
This page corresponds to version 1.30.1.
BUGS
Suspending with control-Z may make the terminal difficult to use.
Please send bug reports and other correspondence to the mailing list,
aumix\@linuxatlax\.org. Past messages may be read at
http\://www\.linuxatlax\.org/archives/private/aumix/
and you may wish to join the list via
http://linuxatlax.org/lists/aumix/
or by sending a message with just "subscribe" in the body to
aumix-request@linuxatlax.org.
Information such as the version of aumix, the architecture and
operating system,and the model of sound hardware is sometimes needed
to diagnose problems, so it is best if you include such details in
any bug reports.
SEE ALSO
| 
