.\" $Aumix: aumix/doc/aumix.1,v 1.3 2002/09/07 09:12:32 trevor Exp $.\" from mdoc.samples(7).\".\" The following requests are required for all man pages..\"           .Dd Month day, year.\"           .Os OPERATING_SYSTEM [version/release].\"           .Dt DOCUMENT_TITLE [section number] [volume].\"           .Sh NAME.\"           .Nm name.\"           .Nd one line description of name.\"           .Sh SYNOPSIS.\"           .Sh DESCRIPTION.\" The following requests should be uncommented and.\" used where appropriate.  This next request is.\" for sections 2, 3 and 9 function return values only..\" .Sh RETURN VALUES.\" This next request is for sections 1, 6, 7, 8 & 9 only.\" .Sh ENVIRONMENT.\" .Sh FILES.\" .Sh EXAMPLES.\" This next request is for sections 1, 6, 7, 8 & 9 only.\"     (command return values (to shell) and.\"       fprintf/stderr type diagnostics).\" .Sh DIAGNOSTICS.\" The next request is for sections 2, 3 and 9 error.\" and signal handling only..\" .Sh ERRORS.\" .Sh SEE ALSO.\" .Sh STANDARDS.\" .Sh HISTORY.\" .Sh AUTHORS.\" .Sh BUGS.\".Dd July 13, 2000.Os.Dt AUMIX 1.Sh NAME.Nm aumix.Nd adjust audio mixer.Sh SYNOPSIS.Nm[-<channel option>[[+|-][<amount>]]|<level>|R[ecord]|P[lay]|q[uery]][-dhILqS] [-f <rc file>][-C <color scheme file>].Sh DESCRIPTIONThis program adjusts the settings of an audio mixing device.It can be used from the command line, in scripts, or interactivelywith the keyboard or mouse..Sh OPTIONS.Ss CHANNEL OPTIONS.Bl -tag -width Fl -compact.It Fl vmain volume.It Fl bbass.It Fl cCD.It Fl iline in.It Fl lline.It Fl mmicrophone.It Fl oline out.It Fl pPC speaker.It Fl ssynthesizer.It Fl ttreble.It Fl wPCM.It Fl ximix.It Fl 1line 1.It Fl 2line 2.It Fl 3line 3.El.PpFor each channel, .Cm qqueries, .Cm +and.Cm \-increment and decrement by one, or an amount if one is specified.If no.Cm +or.Cm \-is given after the channel option, a number sets a specific level(monophonically)..Ss OTHER OPTIONS.Bl -tag -width Fl.It Fl C Ar color_scheme_filespecify the name of a file containing a color scheme.This implies.Fl I ..It Fl d Ar device_filespecify the name of the mixer device (default is.Pa /dev/mixer ).It Fl f Ar rc_filespecify file for saving and loading settings.It Fl hdisplay information on usage.It Fl Irun.Nminteractively, using the full-screen ncurses-based interface.This is the default if no options are given, but must be specifiedin order to have.Nmgo into interactive mode after doing things non-interactively..It Fl Lload settings from.Pa $HOME/.aumixrc ,or.Pa /etc/aumixrcif the former is inaccessible.It Fl qquery all devices and print their settings.It Fl Ssave settings to.Pa $HOME/.aumixrc.El.Sh EXAMPLESThe command.Bd -literal -offset indentaumix -q -v75 -m 0 -c R -c+10 -m q.Ed.Ppprints all settings, sets volume to 75%, sets microphone to 0, setsCD to record, increases the CD level by ten (both left and right),and prints the new settings for the microphone..PpThe .aumixrc file containing:.Bd -literal -offset indentvol:60:60wait:5000vol:50:50.Ed.Ppsets 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..Sh INTERACTIVE USEIf no options are given on the command line, and.Nmis compiled with ncurses, it will run interactively..Ss LAYOUTThe left bank of controls is used for adjusting levels; the rightbank 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 KEYSThe following keys control.Nmin interactive mode:.Bl -tag -width Fl.It page up, page down, up and down cursorselect a new control..It Tab, Enter, <, >, comma and periodtoggle between level and balance controls.It + , \- , \&[ , \&] , left and right cursor and digitsadjust the setting of the current device.The.Li +and right cursor keys increase the level by 3%; the.Li \-and left cursor keys decrease it by the same amount.The.Li \&[key sets it to 0% and.Li \&]sets it to 100%.The digits.Li 1to.Li 9set it to 10% through 90%.The same keys work analogously on the balance controls..It Spacetoggles between record and play for controls which are capable of this..It |centers the balance of the current device..It K or kshow a description of the functions of keys.It L or lload settings from.Pa $HOME/.aumixrc ,falling back to.Pa /etc/aumixrc.It M or mmute or unmute.It O or o.Dq only :mute all channels but the current one.It S or ssave settings to the rc file.It U or uundo any muting.It Q or qend the program.It ^Lrefresh screen.El.Pp^Z, ^D and ^C also have their normal function (the screen is refreshed when.Nmis brought to the foreground)..Ss MOUSEIn interactive mode,.Nmcan accept input from the mouse if.Xr gpm 8is running and.Nmis compiled with.Xr gpm 8support.If gpm is not running but gpm support is included, the message.Ql mouse offwill appear at the top of the screen, and only keyboard input will beaccepted.With.Xr gpm 8running, 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:.Bl -bullet -compact.Itover a control track, it sets the control to match the position ofthe mouse cursor..Itover a record/play indicator, it toggles the record/play state..Itover the .Ql Quit ,.Ql Load ,.Ql Save ,.Ql Keys ,.Ql Mute ,.Ql Only ,or.Ql Undolabels at the top of the screen, it causes those actions to take place..El.Sh ENVIRONMENTThe.Ev HOMEvariable is used.When.Nmis compiled with GTK+ support,.Ev DISPLAYis checked, and if set is used..Ev LANGis used when.Nmthe ncurses screen is displayed..Sh FILESSaved settings for the mixer are kept in the.Pa /etc/aumixrcand.Pa $HOME/.aumixrcfiles, but can be kept anywhere if specified explicitly.Color schemes are normally kept in the directory givenby.Ev DATADIRat compilation time, but are preferentially loadedfrom the current directory and can be kept anywhere so long as thepath to them is specified.The format of these files is:.Bd -filled -offset indent.Ar item.Ar foreground.Ar background.Ed .Ppwhere.Ar itemis one of.Ql active ,.Ql axis ,.Ql handle ,.Ql hotkey ,.Ql menu ,.Ql play ,.Ql record ,or.Ql trackand.Ar foregroundand.Ar backgroundare one of.Ql black ,.Ql red ,.Ql green ,.Ql yellow ,.Ql blue ,.Ql magenta ,.Ql cyan ,or.Ql 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, namedafter the sort of terminal where they should be most suitable..PpIf either foreground or background is given as.Ql \- ,then the default color for that is used.The defaults are a white foreground and black background..PpAn xpm icon is provided..Sh VERSIONThis page corresponds to version 2.7..Sh BUGSSuspending with ^Z may make the terminal difficult to use..PpPlease send bug reports and other correspondence to the mailing list.Past messages may be read at.Bd -literal<URL:http://lilax.org/wws/arc/aumix-l>.Ed.Ppand you may wish to join the list via.Bd -literal<URL:http://lilax.org/wws/info/aumix-l>.Ed.Ppor by sending a message with just.Ql subscribein the subject to.Aq aumix-l-request@lilax.org .To post without subscribing, omit "-request" from the address..PpInformation such as the version of aumix, the architecture andoperating system, and the model of sound hardware is sometimes neededto diagnose problems, so it is best if you include such details inany bug reports..Sh SEE ALSO.Xr gpm 1 ,.Xr moused 8 ,.Xr sb 4 ,.Xr xaumix 1