|
NAMEumix - adjust soundcard mixersSYNOPSISumix [channel volume|left:right][R|P][+|-] device] [-r driver] [-f configpath] [-ghilqsv]DESCRIPTIONumix is a program for adjusting soundcard mixers. With it you can adjust your soundcard volumes, balances and recording sources. It can be used flexibly from the command-line, or from an interactive user interface.You can save your soundcard volumes to a file, and load them afterwards, for example when when booting the machine. Channel names are used to specify the volume you want to adjust. You can check what channels are supported with the -q option. Channel names can also be shortened if they have enough distinctive letters to identify the channel, eg. 'volume' can be shortened to 'vol'. If channel name is specified as all , all available channels are set to the specified value. For each channel specified, volume is the volume you want to set, with both left and right specified as the same, or in left:right format. You can also specify optional + or - after the volume for increasing or decreasing the volume for channel, with amount volume. The optional R or P at the end of the channel argument sets the channel as a current recording source or normal play, respectively. You can use both upper- and lowercase letters. You can slide volumes smoothly in steps from one point to another. The format is following: startvol,endvol,steps,delay. Here startvol is the volume you want to slide the volume from, and endvol is the volume you want to increase or decrease in steps to. Optional parameter steps specifies the number of steps between the two volumes, and delay the delay between two steps. Default values for steps is 20, and 20ms for delay. The optional + or - have no effect when sliding volumes. The delay can be between 0 and 5 seconds, specified in milliseconds. Maximum value for steps is the difference between the starting and destination volume, so that the minimum raise or decrease in one step is always 1. All volume settings are parsed the same, so you can use sliding in your config file too, you just have to edit the config manually. For example the line pcm 0,100,25,50 in your config file would slide the volume of 'pcm' from 0 to 100 in 25 steps and with a 50 ms delay when loading settings. Umix needs read and write permissions to the mixer device. I suggest that you create a group for this and change permissions so that group has write and read access to the devices, then add necessary users to that group. OPTIONS
EXAMPLES
NCURSES USER INTERFACEThe (n)curses based user interface. Designed to be used from a console or x-terminal.USAGEOn the left side is the channel menu, which consists of channel names, stats and volumes. On the right side is the balance menu. The currently chosen channel is indicated with highlighting its name and drawing arrows around the chosen menu. You can move around with default vi/emacs/arrow keys.Moving up and down selects the current channel, moving left and right adjusts the volume or balance, depending on which menu you are in. Tab toggles between volume and balance menus. If the channel does not support stereo mixing (it`s left and right values cannot differ), then a '|' at center of the balance is drawn. KEY BINDINGS
CONFIG FILEThe config consists of global options and mixer settings. Global options come after the keyword [global]. Global options are read before loading any mixer settings or parsing command-line options. Global options are the defaults to use if no command-line options are given.Mixer settings come after the keyword [mixers]. The mixer device that settings are loaded for is specified with the keyword mixer. The string after mixer= is the path of the mixer device. Then comes the settings for that mixer. These are parsed like command-line options. Comments and all other characters are ignored. FILES
BUGSWhen used with terminals that have columns below 35, the output is not optimal with the ncurses UI.If the number of channels is greater than number of lines on screen, you cannot adjust channels that exceed the number of lines in the ncurses UI (rare, but to be fixed soon) AUTHORSakari Lehtonen <sakari@ionstream.fi>
Visit the GSP FreeBSD Man Page Interface. |