man-pages/man1/amixer.1.html
2021-03-31 01:06:50 +01:00

190 lines
6.0 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of AMIXER</TITLE>
</HEAD><BODY>
<H1>AMIXER</H1>
Section: User Commands (1)<BR>Updated: 11 Aug 2000<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
amixer - command-line mixer for ALSA soundcard driver
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>amixer</B> [<I>-option</I>] [<I>cmd</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>amixer</B> allows command-line control of the mixer for the ALSA
soundcard driver.
<B>amixer</B> supports multiple soundcards.
<P>
<B>amixer</B> with no arguments will display the current mixer settings
for the default soundcard and device. This is a good way to see a list
of the simple mixer controls you can use.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>COMMANDS</H2>
<P>
<DL COMPACT>
<DT id="1"><I>help</I><DD>
Shows syntax.
<P>
<DT id="2"><I>info</I><DD>
Shows the information about a mixer device.
<P>
<DT id="3"><I>scontrols</I><DD>
Shows a complete list of simple mixer controls.
<P>
<DT id="4"><I>scontents</I><DD>
Shows a complete list of simple mixer controls with their contents.
<P>
<DT id="5"><I>set</I> or <I>sset</I> &lt;<I>SCONTROL</I>&gt; &lt;<I>PARAMETER</I>&gt; ...<DD>
Sets the simple mixer control contents. The parameter can be the volume
either as a percentage from 0% to 100% with <I>%</I> suffix,
a dB gain with <I>dB</I> suffix (like -12.5dB), or an exact hardware value.
The dB gain can be used only for the mixer elements with available
dB information.
When plus(+) or minus(-) letter is appended after
volume value, the volume is incremented or decremented from the current
value, respectively.
<P>
The parameters <I>cap, nocap, mute, unmute, toggle</I> are used to
change capture (recording) and muting for the group specified.
<P>
The optional modifiers can be put as extra parameters to specify
the stream direction or channels to apply.
The modifiers <I>playback</I> and <I>capture</I> specify the stream,
and the modifiers <I>front, rear, center, woofer</I> are used to specify
channels to be changed.
<P>
A simple mixer control must be specified. Only one device can be controlled
at a time.
<P>
<DT id="6"><I>get</I> or <I>sget</I> &lt;<I>SCONTROL</I>&gt;<DD>
Shows the simple mixer control contents.
<P>
A simple mixer control must be specified. Only one device can be controlled
at a time.
<P>
<DT id="7"><I>controls</I><DD>
Shows a complete list of card controls.
<P>
<DT id="8"><I>contents</I><DD>
Shows a complete list of card controls with their contents.
<P>
<DT id="9"><I>cset</I> &lt;<I>CONTROL</I>&gt; &lt;<I>PARAMETER</I>&gt; ...<DD>
Sets the card control contents. The identifier has these components: iface,
name, index, device, subdevice, numid. The next argument specifies the value
of control.
<P>
<DT id="10"><I>cget</I> &lt;<I>CONTROL</I>&gt;<DD>
Shows the card control contents. The identifier has same syntax as for
the <I>cset</I> command.
<P>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>OPTIONS</H2>
<P>
<DL COMPACT>
<DT id="11"><I>-c</I> card<DD>
<P>
Select the card number to control. The device name created from this
parameter has syntax 'hw:N' where N is specified card number.
<P>
<DT id="12"><I>-D</I> device<DD>
<P>
Select the device name to control. The default control name is 'default'.
<P>
<DT id="13"><I>-s</I> | <I>--stdin</I><DD>
<P>
Read from stdin and execute the command on each line sequentially.
When this option is given, the command in command-line arguments is ignored.
<P>
Only sset and cset are accepted. Other commands are ignored.
The commands to unmatched ids are ignored without errors too.
<P>
<DT id="14"><I>-h</I> <DD>
Help: show syntax.
<P>
<DT id="15"><I>-q</I><DD>
Quiet mode. Do not show results of changes.
<P>
<DT id="16"><I>-R</I> <DD>
Use the raw value for evaluating the percentage representation.
This is the default mode.
<P>
<DT id="17"><I>-M</I> <DD>
Use the mapped volume for evaluating the percentage representation
like <B>alsamixer</B>, to be more natural for human ear.
<P>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>EXAMPLES</H2>
<P>
<DL COMPACT>
<DT id="18"><B>amixer -c 1 sset Line,0 80%,40% unmute cap</B><DD>
will set the second soundcard's left line input volume to 80% and
right line input to 40%, unmute it, and select it as a source for
capture (recording).
<P>
<DT id="19"><B>amixer -c 1 -- sset Master playback -20dB</B><DD>
will set the master volume of the second card to -20dB. If the master
has multiple channels, all channels are set to the same value.
<P>
<DT id="20"><B>amixer -c 1 set PCM 2dB+</B><DD>
will increase the PCM volume of the second card with 2dB. When both
playback and capture volumes exist, this is applied to both volumes.
<P>
<DT id="21"><B>amixer -c 2 cset iface=MIXER,name='Line Playback Volume&quot;,index=1 40%</B><DD>
will set the third soundcard's second line playback volume(s) to 40%
<P>
<DT id="22"><B>amixer -c 2 cset numid=34 40%</B><DD>
will set the 34th soundcard element to 40%
<P>
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<B>
<A HREF="/cgi-bin/man/man2html?1+alsamixer">alsamixer</A>(1)
</B>
<P>
<A NAME="lbAI">&nbsp;</A>
<H2>BUGS </H2>
None known.
<P>
<A NAME="lbAJ">&nbsp;</A>
<H2>AUTHOR</H2>
<B>amixer</B> is by Jaroslav Kysela &lt;<A HREF="mailto:perex@perex.cz">perex@perex.cz</A>&gt;.
This document is by Paul Winkler &lt;<A HREF="mailto:zarmzarm@erols.com">zarmzarm@erols.com</A>&gt; and Jaroslav Kysela &lt;<A HREF="mailto:perex@perex.cz">perex@perex.cz</A>&gt;.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="23"><A HREF="#lbAB">NAME</A><DD>
<DT id="24"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="25"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="26"><A HREF="#lbAE">COMMANDS</A><DD>
<DT id="27"><A HREF="#lbAF">OPTIONS</A><DD>
<DT id="28"><A HREF="#lbAG">EXAMPLES</A><DD>
<DT id="29"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="30"><A HREF="#lbAI">BUGS </A><DD>
<DT id="31"><A HREF="#lbAJ">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>