aumix 1.7 README

This is an audio mixer which can be used from the command line or scripts, or interactively at the console or a terminal with a full-screen, ncurses-based interface. A recent version of the ncurses libraries is recommended. Versions 1.9.9g and 4.0 are known to work with aumix. If you wish to compile aumix with GPM support you'll need libgpm. Version 1.12 is recommended. Compiling with neither of these will yield a much smaller binary. You will need the sound driver in your kernel or as a module.

Installation:

Precompiled:

Two i486-linux binaries are provided: aumix, linked against libc 5 and libncurses 1.9.9g (3.4); and aumix-libc6, linked against libc 6 and libncurses 4.0. Both are also linked to libgpm. Do

make install

to install the libc 5 one into /usr/local/bin and the man page into /usr/local/man/man1. To install the libc 6 version, do

mv aumix-libc6 aumix; make install

Roll-Your-Own:

To compile, edit Makefile and comment out -DGPM or both that and -DNCURSES from OPTS if you wish to disable GPM support or full-screen mode. If you do this, also comment out -lgpm or both that and -lncurses from the LIBS line. Then do

make clean install

which removes the precompiled binaries, builds new ones, places them in /usr/local/bin, and places the man page in /usr/local/man/man1 (change BINDIR and MANDIR in Makefile if you want them elsewhere).

Changes:

New in version 1.7:

• more efficient code for handling options
• in full-screen mode, balance/level legend no longer so dim
• in full-screen mode, changing levels from the keyboard doesn't set balance to center (work is still needed here)
• try to load settings from /etc/aumixrc if ~/.aumixrc can't be opened
• continue gracefully if settings file refers to nonexistent devices

New in version 1.6.1:

• fixed problem with conditional compilation

New in version 1.6:

• ability to save settings to a file and load them in again
• option to use a restricted character set in interactive mode, when IBM graphic characters are not available
• support for second mixer
• changed meaning of "<" and ">" keys (now same as Tab or Enter)
• "," and "." function synonymously with "<" and ">" so users need not shift when using US keyboard
• prettified device names removed, to save space and to allow for future changes to the sound driver
• added labels for banks of level and balance controls
• record/play information updated more often
• record/play information gets printed on query

New in version 1.5:

• "q" options for command line to print settings without changing
• command-line section modularized for compactness
• widened controls in interactive mode for greater precision in setting and reading
• balance controls get redrawn after levels adjusted
• added command-line options for imix, altpcm, reclev, igain, ogain, line1, line2 and line3

New in version 1.4:

• mouse support and interactive mode now optional
• added balance controls to interactive mode
• changed layout of interactive mode
• improved error messages
• bass, treble, synth and mic devices can be set from the command line
• should work better when multiple instances, or other mixer programs, are running

New in version 1.3:

• added mouse support by incorporating code from rmev.c by Alessandro Rubini (packaged with gpm)
• changed color of controls from white to cyan/green so the mouse cursor would be more visible
• added Quit button for use with mouse
• added "Q" key to quit from program
• removed use of two different graphic characters to show controls in use or not in use, because it didn't make sense with both the mouse and keyboard being usable
• added man page

New in version 1.2:

• two banks of horizontal controls, no special treatment of volume, bass, and treble (layout idea borrowed from CAM), so labels don't have to be jammed together
• record/play indicators now show the letters "R" and "P" rather than just a red or green square, so they should be more self-explanatory and more monochrome-friendly
• added use of "[" and "]" keys to set controls to 0% or 100%
• changed effect of up and down curser keys so they go from one control to another

New in version 1.1:

• fewer colors and no border to simplify full-screen interface
• knobs are highlighted as you move to them, then brighten and leave a trail behind when you adjust them
• controls which won't work are no longer drawn, to simplify the display
• horizontal knobs now drawn with same characters as vertical ones
• vertical controls spaced more closely so they fit in 80 columns
• added use of "<" and ">" for cursor motion, and "q" to quit program
• use of tab, "+" and "-" keys now shown on help line
• added -h option to display usage
• Makefile changed so that optimization flags are user-defined and dbmeter is installed

New in version 1.0:

• added command-line interface

New in version 0.2:

• doesn't assume existence of any device (volume, bass, etc)
• some bug fixes to work correctly with SB Pro
• should now work correctly when multiple copies are run simutaneously
• some minor bug fixes

To Do:

• fix balance controls
• automatic configuration (autoconf or the like)
• multilingual documentation
• portability to various Unices

For information on the authors, copyright and license, please read the beginning of aumix.c.

Comments, questions, bug reports (please be detailed), and especially patches are welcome. Send them to the maintainer, trevor@jpj.net.