Ubuntu Manpage: aumix — adjust audio mixer

NAME

       aumix — adjust audio mixer

SYNOPSIS

       aumix  [-<channel  option>[[+|-][<amount>]]|<level>|R[ecord]|P[lay]|q[uery]]  [-dhILqS] [-f <rc file>][-C
             <color scheme file>]

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.

OPTIONS

   CHANNEL OPTIONS
       -v          main volume
       -b          bass
       -c          CD
       -i          input gain
       -l          line
       -m          microphone
       -o          output gain
       -p          PC speaker
       -r          record
       -s          synthesizer
       -t          treble
       -w          PCM
       -W          PCM 2
       -x          mix monitor
       -1          line 1
       -2          line 2
       -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).

   OTHER OPTIONS
       -C color_scheme_file
                   specify the name of a file containing a color scheme.  This implies  -I.   The  color  scheme
                   file  may  reside  in the current working directory or in the aumix data directory, typically
                   /usr/share/aumix or /usr/share/aumix-gtk if you are using the GTK-enabled aumix package. This
                   option can be used to force the ncurses interface with a GTK version.  No need to  specify  a
                   filename in that case.

       -d device_file
                   specify the name of the mixer device (default is /dev/mixer)

       -f rc_file  specify file for saving and loading settings

       -h          display information on usage

       -I          run  aumix 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  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
                   filename).

       -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 microphone.

       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 "wait" lines will
       not be saved by aumix.  They must be added by hand.

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 channels 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, <, >, comma and period
toggle between level and balance controls

+, -, [, ], left and right cursor and digits
adjust the setting of the current device. The + 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 ]
or 0 set it to 100%. The digits 1 to 9 set it to 10% through 90%. The digit 0 sets it to
100% (not 0%). 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) 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(8) 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 ‘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 specified 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’, ‘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.  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.9.1.

BUGS

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

HOME PAGE

       http://jpj.net/~trevor/aumix.html

MAILING LISTS

       https://gna.org/mail/?group=aumix