255 lines
8.8 KiB
HTML
255 lines
8.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of ALSAMIXER</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>ALSAMIXER</H1>
|
|
Section: User Commands (1)<BR>Updated: 22 May 2009<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
alsamixer - soundcard mixer for ALSA soundcard driver, with ncurses interface
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<P>
|
|
<B>alsamixer</B> [<I>options</I>]
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>alsamixer</B> is an ncurses mixer program for use with the ALSA
|
|
soundcard drivers. It supports multiple soundcards with multiple devices.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="1"><I>-h, --help</I><DD>
|
|
Help: show available flags.
|
|
<P>
|
|
<DT id="2"><I>-c, --card</I> <card number or identification><DD>
|
|
Select the soundcard to use, if you have more than one. Cards are
|
|
numbered from 0 (the default).
|
|
<P>
|
|
<DT id="3"><I>-D, --device</I> <device identification><DD>
|
|
Select the mixer device to control.
|
|
<P>
|
|
<DT id="4"><I>-V, --view</I> <mode><DD>
|
|
Select the starting view mode, either <I>playback</I>, <I>capture</I> or <I>all</I>.
|
|
<P>
|
|
<DT id="5"><I>-g, --no-color</I><DD>
|
|
Toggle the using of colors.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>MIXER VIEWS</H2>
|
|
|
|
<P>
|
|
The top-left corner of <B>alsamixer</B> is the are to show some basic
|
|
information: the card name, the mixer chip name, the current view
|
|
mode and the currently selected mixer item.
|
|
When the mixer item is switched off, <I>[Off]</I> is displayed in its
|
|
name.
|
|
<P>
|
|
Volume bars are located below the basic information area. You can
|
|
scroll left/right when all controls can't be put in a single screen.
|
|
The name of each control is shown in the bottom below the volume bars.
|
|
The currently selected item is drawn in red and/of emphasized.
|
|
<P>
|
|
Each mixer control with volume capability shows a box and the current
|
|
volume filled in that box. The volume percentages are displayed below
|
|
the volume bar for left and right channels. For a mono control, only
|
|
one value is shown there.
|
|
<P>
|
|
When a mixer control is turned off, <I>M</I> (mute) appears below the
|
|
volume bar. When it's turned on, <I>O</I> in green appears instead.
|
|
You can toggle the switch via <I>m</I> key.
|
|
<P>
|
|
When a mixer control has capture capability, the capture flag appears
|
|
below the volume bar, too. When the capture is turned off,
|
|
------- is shown. <I>CAPTURE</I> in red appears when the
|
|
capture switch is turned on. In addition, <I>L</I> and <I>R</I> letters
|
|
appear in left and right side to indicate that left and the right
|
|
channels are turned on.
|
|
<P>
|
|
Some controls have the enumeration list, and don't show boxes but only
|
|
texts which indicate the currently active item. You can change the
|
|
item via up/down keys.
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>VIEW MODES</H2>
|
|
|
|
<B>alsamixer</B> has three view modes: playback, capture and all.
|
|
In the playback view, only the controls related with playback are shown.
|
|
Similarly, only the controls for capture (recording) are shown in the capture
|
|
view. The all view mode shows all controls. The current view mode is displayed
|
|
in the top-left position together with the mixer name, etc.
|
|
<P>
|
|
The default view mode is the playback view. You can change it via
|
|
<I>-V</I> option.
|
|
<P>
|
|
Each view mode can be switched via keyboard commands, too.
|
|
See the next section.
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>KEYBOARD COMMANDS</H2>
|
|
|
|
<B>alsamixer</B> recognizes the following keyboard commands to control the soundcard.
|
|
Commands shown here in upper case can also be given in lower case.
|
|
To be reminded of these keystrokes, hit the <I>h</I> key.
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H3>General Controls</H3>
|
|
|
|
<P>
|
|
The <I>Left</I> and <I>right arrow</I> keys are used to select the
|
|
channel (or device, depending on your preferred terminology). You can
|
|
also use <I>n</I> ("next") and <I>p</I> ("previous").
|
|
<P>
|
|
The <I>Up</I> and <I>Down Arrows</I> control the volume for the
|
|
currently selected device. You can also use <I>+</I> or <I>-</I> for the
|
|
same purpose. Both the left and right signals are affected. For
|
|
independent left and right control, see below.
|
|
<BR>
|
|
The <I>B</I> or <I>=</I> key adjusts the balance of volumes on left and
|
|
right channels.
|
|
<P>
|
|
<I>M</I> toggles muting for the current channel (both left and right).
|
|
If the hardware supports it, you can
|
|
mute left and right independently by using <I>,</I> (or <I><</I>) and
|
|
<I>.</I> (or <I>></I>) respectively.
|
|
<P>
|
|
<I>SPACE</I> enables recording for the current channel. If any other
|
|
channels have recording enabled, they will have their recording function
|
|
disabled first. This only works for valid input channels, of course.
|
|
<P>
|
|
<I>L</I> re-draws the screen.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>View Mode Controls</H3>
|
|
|
|
Function keys are used to change view modes.
|
|
You can switch to the help mode and the proc info mode via <I>F1</I> and
|
|
<I>F2</I> keys, respectively.
|
|
On terminals that can't use function keys like gnome-terminal, <I>?</I> and
|
|
<I>/</I> keys can be used alternatively for help and proc modes.
|
|
<P>
|
|
<I>F3</I>, <I>F4</I> and <I>F5</I> keys are used to switch to playback, capture
|
|
and all view mode, respectively. <I>TAB</I> key toggles the
|
|
current view mode circularly.
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H3>Quick Volume Changes</H3>
|
|
|
|
<P>
|
|
<I>PageUp</I> increases volume by 5.
|
|
<P>
|
|
<I>PageDown</I> decreases volume by 5.
|
|
<P>
|
|
<I>End</I> sets volume to 0.
|
|
<P>
|
|
You can also control left & right levels for the current channel
|
|
independently, as follows:
|
|
<P>
|
|
[<I>Q</I> | <I>W</I> | <I>E</I> ] -- turn UP [ left | both | right ]
|
|
<P>
|
|
[<I>Z</I> | <I>X</I> | <I>C</I> ] -- turn DOWN [ left | both | right ]
|
|
<P>
|
|
If the currently selected mixer channel is not a stereo channel, then
|
|
all UP keys will work like <I>W</I>, and all DOWN keys will work like <I>X</I>.
|
|
<P>
|
|
The number keys from <I>0</I> to <I>9</I> are to change the absolute volume
|
|
quickly. They correspond to 0 to 90% volume.
|
|
<P>
|
|
<A NAME="lbAL"> </A>
|
|
<H3>Selecting the Sound Card</H3>
|
|
|
|
<P>
|
|
You can select another sound card by pressing the <I>F6</I> or <I>S</I> keys.
|
|
This will show a list of available sound cards to choose from,
|
|
and an entry to enter the mixer device name by hand.
|
|
<P>
|
|
<A NAME="lbAM"> </A>
|
|
<H3>Exiting</H3>
|
|
|
|
<P>
|
|
Quit the program with <I>ALT Q</I>, or by hitting <I>ESC</I>.
|
|
Please note that you might need to hit <I>ESC</I> twice on some terminals
|
|
since it's regarded as a prefix key.
|
|
<P>
|
|
<A NAME="lbAN"> </A>
|
|
<H2>VOLUME MAPPING</H2>
|
|
|
|
In <B>alsamixer</B>, the volume is mapped to a value that is more natural
|
|
for a human ear. The mapping is designed so that the position in the
|
|
interval is proportional to the volume as a human ear would perceive
|
|
it, i.e. the position is the cubic root of the linear sample
|
|
multiplication factor. For controls with a small range (24 dB or
|
|
less), the mapping is linear in the dB values so that each step has
|
|
the same size visually.
|
|
<P>
|
|
Only for controls without dB information, a linear mapping of the
|
|
hardware volume register values is used (this is the same algorithm as
|
|
used in the old <B>alsamixer</B>).
|
|
<P>
|
|
<A NAME="lbAO"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B>
|
|
<A HREF="/cgi-bin/man/man2html?1+amixer">amixer</A>(1),
|
|
<A HREF="/cgi-bin/man/man2html?1+aplay">aplay</A>(1),
|
|
<A HREF="/cgi-bin/man/man2html?1+arecord">arecord</A>(1)
|
|
</B>
|
|
<P>
|
|
<A NAME="lbAP"> </A>
|
|
<H2>BUGS </H2>
|
|
|
|
Some terminal emulators (e.g. <B>nxterm</B>) may not
|
|
work quite right with ncurses, but that's their own damn
|
|
fault. Plain old <B>xterm</B> seems to be fine.
|
|
<P>
|
|
<A NAME="lbAQ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<B>alsamixer</B>
|
|
|
|
has been written by Tim Janik and
|
|
been further improved by Jaroslav Kysela <<A HREF="mailto:perex@perex.cz">perex@perex.cz</A>>
|
|
and Clemens Ladisch <<A HREF="mailto:clemens@ladisch.de">clemens@ladisch.de</A>>.
|
|
<P>
|
|
This manual page was provided by Paul Winkler <<A HREF="mailto:zarmzarm@erols.com">zarmzarm@erols.com</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="6"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="7"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="8"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="9"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="10"><A HREF="#lbAF">MIXER VIEWS</A><DD>
|
|
<DT id="11"><A HREF="#lbAG">VIEW MODES</A><DD>
|
|
<DT id="12"><A HREF="#lbAH">KEYBOARD COMMANDS</A><DD>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAI">General Controls</A><DD>
|
|
<DT id="14"><A HREF="#lbAJ">View Mode Controls</A><DD>
|
|
<DT id="15"><A HREF="#lbAK">Quick Volume Changes</A><DD>
|
|
<DT id="16"><A HREF="#lbAL">Selecting the Sound Card</A><DD>
|
|
<DT id="17"><A HREF="#lbAM">Exiting</A><DD>
|
|
</DL>
|
|
<DT id="18"><A HREF="#lbAN">VOLUME MAPPING</A><DD>
|
|
<DT id="19"><A HREF="#lbAO">SEE ALSO</A><DD>
|
|
<DT id="20"><A HREF="#lbAP">BUGS </A><DD>
|
|
<DT id="21"><A HREF="#lbAQ">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:06 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|