|
Packit Service |
a9274b |
.TH ALSAMIXER 1 "22 May 2009"
|
|
Packit Service |
a9274b |
.SH NAME
|
|
Packit Service |
a9274b |
alsamixer \- soundcard mixer for ALSA soundcard driver, with ncurses interface
|
|
Packit Service |
a9274b |
.SH SYNOPSIS
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
\fBalsamixer\fP [\fIoptions\fP]
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH DESCRIPTION
|
|
Packit Service |
a9274b |
\fBalsamixer\fP is an ncurses mixer program for use with the ALSA
|
|
Packit Service |
a9274b |
soundcard drivers. It supports multiple soundcards with multiple devices.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH OPTIONS
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
\fI\-h, \-\-help\fP
|
|
Packit Service |
a9274b |
Help: show available flags.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
\fI\-c, \-\-card\fP <card number or identification>
|
|
Packit Service |
a9274b |
Select the soundcard to use, if you have more than one. Cards are
|
|
Packit Service |
a9274b |
numbered from 0 (the default).
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
\fI\-D, \-\-device\fP <device identification>
|
|
Packit Service |
a9274b |
Select the mixer device to control.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
\fI\-V, \-\-view\fP <mode>
|
|
Packit Service |
a9274b |
Select the starting view mode, either \fIplayback\fP, \fIcapture\fP or \fIall\fP.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
\fI\-g, \-\-no\-color\fP
|
|
Packit Service |
a9274b |
Toggle the using of colors.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH MIXER VIEWS
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
The top-left corner of \fBalsamixer\fP is the are to show some basic
|
|
Packit Service |
a9274b |
information: the card name, the mixer chip name, the current view
|
|
Packit Service |
a9274b |
mode and the currently selected mixer item.
|
|
Packit Service |
a9274b |
When the mixer item is switched off, \fI[Off]\fP is displayed in its
|
|
Packit Service |
a9274b |
name.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
Volume bars are located below the basic information area. You can
|
|
Packit Service |
a9274b |
scroll left/right when all controls can't be put in a single screen.
|
|
Packit Service |
a9274b |
The name of each control is shown in the bottom below the volume bars.
|
|
Packit Service |
a9274b |
The currently selected item is drawn in red and/of emphasized.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
Each mixer control with volume capability shows a box and the current
|
|
Packit Service |
a9274b |
volume filled in that box. The volume percentages are displayed below
|
|
Packit Service |
a9274b |
the volume bar for left and right channels. For a mono control, only
|
|
Packit Service |
a9274b |
one value is shown there.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
When a mixer control is turned off, \fIM\fP (mute) appears below the
|
|
Packit Service |
a9274b |
volume bar. When it's turned on, \fIO\fP in green appears instead.
|
|
Packit Service |
a9274b |
You can toggle the switch via \fIm\fP key.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
When a mixer control has capture capability, the capture flag appears
|
|
Packit Service |
a9274b |
below the volume bar, too. When the capture is turned off,
|
|
Packit Service |
a9274b |
\-\-\-\-\-\-\- is shown. \fICAPTURE\fP in red appears when the
|
|
Packit Service |
a9274b |
capture switch is turned on. In addition, \fIL\fP and \fIR\fP letters
|
|
Packit Service |
a9274b |
appear in left and right side to indicate that left and the right
|
|
Packit Service |
a9274b |
channels are turned on.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
Some controls have the enumeration list, and don't show boxes but only
|
|
Packit Service |
a9274b |
texts which indicate the currently active item. You can change the
|
|
Packit Service |
a9274b |
item via up/down keys.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH VIEW MODES
|
|
Packit Service |
a9274b |
\fBalsamixer\fP has three view modes: playback, capture and all.
|
|
Packit Service |
a9274b |
In the playback view, only the controls related with playback are shown.
|
|
Packit Service |
a9274b |
Similarly, only the controls for capture (recording) are shown in the capture
|
|
Packit Service |
a9274b |
view. The all view mode shows all controls. The current view mode is displayed
|
|
Packit Service |
a9274b |
in the top-left position together with the mixer name, etc.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
The default view mode is the playback view. You can change it via
|
|
Packit Service |
a9274b |
\fI-V\fP option.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
Each view mode can be switched via keyboard commands, too.
|
|
Packit Service |
a9274b |
See the next section.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH KEYBOARD COMMANDS
|
|
Packit Service |
a9274b |
\fBalsamixer\fP recognizes the following keyboard commands to control the soundcard.
|
|
Packit Service |
a9274b |
Commands shown here in upper case can also be given in lower case.
|
|
Packit Service |
a9274b |
To be reminded of these keystrokes, hit the \fIh\fP key.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SS
|
|
Packit Service |
a9274b |
General Controls
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
The \fILeft\fP and \fIright arrow\fP keys are used to select the
|
|
Packit Service |
a9274b |
channel (or device, depending on your preferred terminology). You can
|
|
Packit Service |
a9274b |
also use \fIn\fP ("next") and \fIp\fP ("previous").
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
The \fIUp\fP and \fIDown Arrows\fP control the volume for the
|
|
Packit Service |
a9274b |
currently selected device. You can also use \fI+\fP or \fI\-\fP for the
|
|
Packit Service |
a9274b |
same purpose. Both the left and right signals are affected. For
|
|
Packit Service |
a9274b |
independent left and right control, see below.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
The \fIB\fP or \fI=\fP key adjusts the balance of volumes on left and
|
|
Packit Service |
a9274b |
right channels.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
\fIM\fP toggles muting for the current channel (both left and right).
|
|
Packit Service |
a9274b |
If the hardware supports it, you can
|
|
Packit Service |
a9274b |
mute left and right independently by using \fI,\fP (or \fI<\fP) and
|
|
Packit Service |
a9274b |
\fI.\fP (or \fI>\fP) respectively.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
\fISPACE\fP enables recording for the current channel. If any other
|
|
Packit Service |
a9274b |
channels have recording enabled, they will have their recording function
|
|
Packit Service |
a9274b |
disabled first. This only works for valid input channels, of course.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
\fIL\fP re-draws the screen.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SS
|
|
Packit Service |
a9274b |
View Mode Controls
|
|
Packit Service |
a9274b |
Function keys are used to change view modes.
|
|
Packit Service |
a9274b |
You can switch to the help mode and the proc info mode via \fIF1\fP and
|
|
Packit Service |
a9274b |
\fIF2\fP keys, respectively.
|
|
Packit Service |
a9274b |
On terminals that can't use function keys like gnome\-terminal, \fI?\fP and
|
|
Packit Service |
a9274b |
\fI/\fP keys can be used alternatively for help and proc modes.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
\fIF3\fP, \fIF4\fP and \fIF5\fP keys are used to switch to playback, capture
|
|
Packit Service |
a9274b |
and all view mode, respectively. \fITAB\fP key toggles the
|
|
Packit Service |
a9274b |
current view mode circularly.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SS
|
|
Packit Service |
a9274b |
Quick Volume Changes
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
\fIPageUp\fP increases volume by 5.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
\fIPageDown\fP decreases volume by 5.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
\fIEnd\fP sets volume to 0.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
You can also control left & right levels for the current channel
|
|
Packit Service |
a9274b |
independently, as follows:
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
[\fIQ\fP | \fIW\fP | \fIE\fP ] -- turn UP [ left | both | right ]
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
[\fIZ\fP | \fIX\fP | \fIC\fP ] -- turn DOWN [ left | both | right ]
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
If the currently selected mixer channel is not a stereo channel, then
|
|
Packit Service |
a9274b |
all UP keys will work like \fIW\fP, and all DOWN keys will work like \fIX\fP.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
The number keys from \fI0\fP to \fI9\fP are to change the absolute volume
|
|
Packit Service |
a9274b |
quickly. They correspond to 0 to 90% volume.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SS
|
|
Packit Service |
a9274b |
Selecting the Sound Card
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
You can select another sound card by pressing the \fIF6\fP or \fIS\fP keys.
|
|
Packit Service |
a9274b |
This will show a list of available sound cards to choose from,
|
|
Packit Service |
a9274b |
and an entry to enter the mixer device name by hand.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SS
|
|
Packit Service |
a9274b |
Exiting
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
Quit the program with \fIALT Q\fP, or by hitting \fIESC\fP.
|
|
Packit Service |
a9274b |
Please note that you might need to hit \fIESC\fP twice on some terminals
|
|
Packit Service |
a9274b |
since it's regarded as a prefix key.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH VOLUME MAPPING
|
|
Packit Service |
a9274b |
In \fBalsamixer\fP, the volume is mapped to a value that is more natural
|
|
Packit Service |
a9274b |
for a human ear. The mapping is designed so that the position in the
|
|
Packit Service |
a9274b |
interval is proportional to the volume as a human ear would perceive
|
|
Packit Service |
a9274b |
it, i.e. the position is the cubic root of the linear sample
|
|
Packit Service |
a9274b |
multiplication factor. For controls with a small range (24 dB or
|
|
Packit Service |
a9274b |
less), the mapping is linear in the dB values so that each step has
|
|
Packit Service |
a9274b |
the same size visually.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
Only for controls without dB information, a linear mapping of the
|
|
Packit Service |
a9274b |
hardware volume register values is used (this is the same algorithm as
|
|
Packit Service |
a9274b |
used in the old \fBalsamixer\fP).
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH SEE ALSO
|
|
Packit Service |
a9274b |
\fB
|
|
Packit Service |
a9274b |
amixer(1),
|
|
Packit Service |
a9274b |
aplay(1),
|
|
Packit Service |
a9274b |
arecord(1)
|
|
Packit Service |
a9274b |
\fP
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH BUGS
|
|
Packit Service |
a9274b |
Some terminal emulators (e.g. \fBnxterm\fP) may not
|
|
Packit Service |
a9274b |
work quite right with ncurses, but that's their own damn
|
|
Packit Service |
a9274b |
fault. Plain old \fBxterm\fP seems to be fine.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH AUTHOR
|
|
Packit Service |
a9274b |
.B alsamixer
|
|
Packit Service |
a9274b |
has been written by Tim Janik and
|
|
Packit Service |
a9274b |
been further improved by Jaroslav Kysela <perex@perex.cz>
|
|
Packit Service |
a9274b |
and Clemens Ladisch <clemens@ladisch.de>.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
This manual page was provided by Paul Winkler <zarmzarm@erols.com>.
|