Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
UNTITLED()			      LOCAL			      UNTITLED()

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  op-
     tion, a number sets a specific level (monophonically).

   OTHER OPTIONS
     -C color_scheme_file
		 specify the name of a file containing a color scheme.	This im-
		 plies -I.

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

     -L 	 load settings from $HOME/.aumixrc, or /etc/aumixrc if the  for-
		 mer 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 cur-
		 sor 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 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)  run-
     ning,  most functions can be performed through the mouse.	The mouse is ac-
     tive 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'  la-
	 bels 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 compi-
     lation  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  back-
     ground.

     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

SEE ALSO
     gpm(1), moused(8), sb(4), xaumix(1)

FreeBSD ports 15.1		  July 13, 2000 			AUMIX(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=aumix&sektion=1&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help