alsa-utils/alsamixer
Takashi Iwai 8e3e09dd0b Add check of ncurses*-config
The recent ncurses package provides ncurses*-config program to give the
proper cflags and libs.  Let's use them if available.

Right now, the ncurses version (5) is hard-coded.  It should be better
to be variable as well, but it'd be messy.  Hope the ncurses version won't
change rapidly.
2008-04-16 14:39:41 +02:00
..
alsamixer.1 Changed Jaroslav Kysela's e-mail from perex@suse.cz to perex@perex.cz 2007-10-15 10:25:17 +02:00
alsamixer.c alsamixer: add 8-channel support 2008-01-07 12:28:43 +01:00
go amixer/alsamixer - updated go scripts for debugging 2007-07-11 10:12:24 +02:00
Makefile.am Add check of ncurses*-config 2008-04-16 14:39:41 +02:00
README Changed Jaroslav Kysela's e-mail from perex@suse.cz to perex@perex.cz 2007-10-15 10:25:17 +02: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@perex.cz>.
This document was provided by Paul Winkler <zarmzarm@erols.com>.