alsa-utils/alsamixer
Jaroslav Kysela 6bd266995e Changed location of asoundlib.h from sys dir to alsa dir.
(it means that official location is '#include <alsa/asoundlib.h>')
2001-09-11 09:34:14 +00:00
..
alsamixer.1 Updated 2001-05-15 12:25:43 +00:00
alsamixer.c Changed location of asoundlib.h from sys dir to alsa dir. 2001-09-11 09:34:14 +00:00
Makefile.am Recoded alsamixer utility to use the latest alsa-lib's API. 2001-02-14 12:22:47 +00:00
README Changed e-mail from <perex@jcu.cz> to <perex@suse.cz>.. 1999-05-11 22:18:49 +00:00

Using Alsamixer
===============

Alsamixer uses an ncurses interface, which may not display properly in
an xterm.

Start it by typing "alsamixer".

Optional flags:
alsamixer -h displays the available flags.
alsamixer -e starts in "exact" mode. See below...
alsamixer -c N selects the soundcard to control, where N is the number of
the card, counting from 1.
alsamixer -m selects which mixer device to control, counting from 0. This
is only applicable to soundcards that have more than one mixer to 
control. It is the same as the amixer -d flag.


Keyboard commands:
==================

Left & right arrow keys are used to select the channel (or device,
depending on your preferred terminology). You can also use n (next) 
and p (previous).

Up/down arrows control the volume for the currently selected device.
Both the left & right signals are controlled.
You can also use "+" or "-" to turn volumes up or down.

"M" toggles muting for the current channel (both left and right). You can
mute left and right independently by using , and . respectively.

SPACE toggles recording: the current channel will be added or removed from
the sources used for recording. This only works on valid input channels,
of course.

"L" re-draws the screen.

TAB does something interesting: it toggles the mode for volume display.
This affects the numbers you see, but not the operation of the level
controls. There seem to be two modes: one is percentages from 0-100, the
other is called "exact mode" and varies from channel to channel. This
shows you the settings as the soundcard understands them. All the channel
level ranges are from 0 to a power of 2 minus one (e.g. 0-31 or 0-63).

Quick Volume Changes
--------------------

PageUp increases volume by 10.
PageDown decreases volume by 10.
Home sets volume to 100.
End sets volume to 0.

You can also control left & right levels for the current channel
independently,
according to this chart:

Q  |  W  |  E    <-- UP
-------------
Z  |  X  |  C    <---DOWN

^     ^     ^
|     |     +-- Right
|     |
|     +--- Both
|
Left


If the current mixer channel is not a stereo channel, then all UP keys
will work like W, and all DOWN keys will work like X.


Exiting
=======

You can exit with ALT + Q, or by hitting ESC.


-----------------------------------------------------------------

Alsamixer has been written by Tim Janik <timj@gtk.org> and
been furtherly improved by Jaroslav Kysela <perex@suse.cz>.
This document was provided by Paul Winkler <zarmzarm@erols.com>.