NAME

aumix - adjust audio mixer SYNOPSIS

aumix [[- DESCRIPTION

This program adjusts the settings of an audio mixing device. It can be used from the command line, in scripts, or inter- actively with the keyboard or mouse. OPTIONS

CHANNEL OPTIONS

• v main volume

• bbass-cCD-iline in-lline-mmicrophone-oline out-pPC speaker-ssynthesizer-ttreble-wPCM-ximix-1line 1-2line 2-3line 3For each channel, q queries, + and - increment and decrementby one, or an amount if one is specified. If no + or - isgiven after the channel option, a number sets a specificlevel (monophonically).OTHER OPTIONS-C color_scheme_filespecify the name of a file containing a colorscheme. This implies -I. This option can beused to force the ncurses interface with a GTKversion. No need to specify a filename in thatcase.-d device_filespecify the name of the mixer device (default is/dev/mixer ). IMPORTANT: if you use this option, specify it before any other options; it won't take effect on preceding options/commands.
• f rc_file

specify file for saving and loading settings

• h

display information on usage

• I

run aumix interactively, using the default user interface (GTK or ncurses, depending on the ver- sion). This is the default if no options are given, but must be specified in order to have aumix go into interactive mode after doing things non-interactively. To force use of the ncurses interface with the GTK version, specify -C (no need to give a file- name).

• L

load settings from $HOME/.aumixrc, or /etc/aumixrc if the former is inaccessible

• q

query all devices and print their settings

• S

save settings to $HOME/.aumixrc

EXAMPLES

The command

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 micro- phone.

The .aumixrc file containing:

vol:60:60 wait:5000 vol:50:50 sets the volume to 60%, waits five seconds, then reduces the volume to 50%. Note that INTERACTIVE USE

If no options are given on the command line, and aumix is compiled with ncurses, it will run interactively.

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 chan- nels which are stereo-capable will have balance controls.

KEYS

The following keys control aumix in interactive

mode

page up, page down, up and down cursor

select a new control.Tab, Enter, and right cursor keys increase the level by 3%; the - and left cursor keys decrease it by the same amount. The [ 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.

Space toggles between record and play for controls which are capable of this.

| centers the balance of the current device.

K or k show a description of the functions of keys

L or l load settings from $HOME/.aumixrc, falling back to /etc/aumixrc

M or m mute or unmute

O or o ``only'': mute all channels but the current one

S or s save settings to the rc file

U or u undo any muting

Q or q end the program

^L refresh screen

^Z, ^D and ^C also have their normal function (the screen is refreshed when aumix is brought to the foreground).

MOUSE In interactive mode, aumix can accept input from the mouse if gpm(8)? is running and aumix is compiled with gpm(8)? sup- port. 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(8)? run- ning, 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 Quit, Load, Save, Keys, Mute, Only, or Undo labels at the top of the screen, it causes those actions to take place.

ENVIRONMENT

The HOME variable is used. When aumix is compiled with GTK+ support, DISPLAY is checked, and if set is used. LANG is used when aumix the ncurses screen is displayed. FILES

Saved settings for the mixer are kept in the /etc/aumixrc and $HOME/.aumixrc files, but can be kept anywhere if speci- fied explicitly. Color schemes are normally kept in the directory given by DATADIR 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, 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. If aumix is linked against ncurses, then the terminal's default fore or background will be used; else the default foreground is white and the default background is black.

An xpm icon is provided. VERSION

This page corresponds to version 2.7. BUGS

Suspending with ^Z may make the terminal difficult to use.

Please send bug reports and other correspondence to the mailing list. 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. To post without subscrib- ing, omit

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

gpm(1)?, moused(8)?, sb(4)?, xaumix(1)

BSD July 13, 2000 1