Manpage of UMIX
Section: Sound Utilities (1)
Updated: 08 Jun 2002
Return to Main Contents
umix - adjust soundcard mixers
is a program for adjusting soundcard mixers.
With it you can adjust your soundcard volumes, balances and
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
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 available channels are set to the specified value.
is the volume you want to set, with both left
and right specified as the same, or in
You can also specify optional
+ or -
for increasing or decreasing the volume for
R or P
at the end of the
argument sets the
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:
is the volume you want to slide the volume from, and
is the volume you want to increase or decrease in steps to.
specifies the number of steps between the two volumes, and
the delay between two steps. Default values for
is 20, and 20ms for
+ or -
have no effect when sliding volumes.
can be between 0 and 5 seconds, specified in milliseconds.
Maximum value for
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
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.
- -q, --query
Query and print all active channel volumes and stats from
all available devices. Interactive UI is not started.
- -l, --load
Load previously saved settings from
is specified as '-', settings are loaded from
standard input. Clears the
- -s, --save
Save current mixer settings to
is specified as '-', settings are printed to
standard output. Clears the
- -f configpath, --file=configpath
Specify the file used to read and save settings.
- -d device, --device=device
Specify the device used. Defaults to
- -r driver, --driver=driver
Specify the driver used. Defaults to
- -i, --interactive
Start interactive user interface after processing
non-interactive command-line options.
- -g, --globals
Print current global options. This is useful for finding out what
is the default device etc.
- -h, --help
Display help and exit.
- -v, --version
Display version information and exit.
- umix -q
Prints all volumes of active channels and their stats.
The output should be self-explanatory.
- umix volume 100 bass 88 treble 80 pcm 94
Sets the volume to 100, bass to 88,
treble to 80 and PCM to 94.
- umix vol 100:80 syn 90:30
Here channel names are shortened and stereo settings are used.
Sets volume`s left to 100, right to 80 and synth`s
left to 90 and right to 30.
- umix bass 20- pcm 20:10+ ogain 40:45-
Here volumes are incremented or decremented from their
original values. Decreases bass by 20, increases
PCM`s left by 20 and right by 10 and the last one
decreases output gain`s left by 40 and right by 45.
- umix mic R synth 20P line 10p-
This sets the mic as a recording source,
synth as normal play with volume 20 and line
as normal play with volume decreased by 10.
- umix pcm 0,60,30,25 vol 100,70 synth 50:50,25:50
Here sliding is demonstrated. The first slides pcm from 0 to 60
with 30 steps and a 25 ms delay, then slides vol from 100 to 70 with
default steps and delay and the last one slides synth from 50:50 to
- umix -f /some/path/umixrc -l
Here the config path is specified as
and settings are loaded from that file.
- umix -d /dev/mixer2 -f /somepath/umsettings
The device that is used for mixing is specified as
config path is set as
and the interactive user interface is automatically
-f and -d
NCURSES USER INTERFACE
The (n)curses based user interface. Designed to be used
from a console or x-terminal.
On 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
Moving up and down selects the current channel, moving
left and right adjusts the volume or balance,
depending on which menu you are in.
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.
- j / ^n / arrow down
- k / ^p / arrow up
- h / ^b / arrow left
Decrease volume / balance left.
- l / ^f / arrow right
Increase volume / balance right.
- ] / .
Increase volume by fifth of maximum amount.
- [ / ,
Decrease volume by fifth of maximum amount.
Toggle between volume and balance menus.
Toggle play / record source.
Specify the config path. This presents a dialog in the lower
border. If no string is given, the path remains unchanged.
Enter channel volume manually for the current channel.
Same rules apply as with command-line channel settings,
so you can set balances and recording sources too.
Cycles through available mixer devices. You can see the currently
active mixer and the total number of initialized mixers in the
Mutes all those channels that are not already mute. If pressed
again, returns volumes back to the state before muting.
Excludes the current channel. Same as
but only with the current channel.
Displays the help.
Exit the program.
Refresh the screen.
The config consists of global options and mixer settings.
Global options come after the keyword
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
The mixer device that settings are loaded for is specified with the keyword
The string after
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.
The default configuration file.
Used as the config file if exists.
When 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)
Sakari Lehtonen <email@example.com>
- NCURSES USER INTERFACE
- KEY BINDINGS
- CONFIG FILE
This document was created by
using the manual pages.
Time: 14:36:12 GMT, August 23, 2003