alsa-utils/amixer/amixer.1

122 lines
3 KiB
Groff
Raw Permalink Normal View History

.TH AMIXER 1 "11 Aug 2000"
1998-10-06 12:19:04 +02:00
.SH NAME
amixer \- command-line mixer for ALSA soundcard driver
1998-10-06 12:19:04 +02:00
.SH SYNOPSIS
\fBamixer\fP [\fI\-c\fP card] [\fIcmd\fP]
1998-10-06 12:19:04 +02:00
.SH DESCRIPTION
\fBamixer\fP allows command-line control of the mixer for the ALSA
soundcard driver.
\fBamixer\fP supports multiple soundcards.
1998-10-06 12:19:04 +02:00
.SH INVOKING
\fBamixer\fR 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.
1998-10-06 12:19:04 +02:00
.SH COMMANDS
1998-10-06 12:19:04 +02:00
.TP
\fIhelp\fP
Shows syntax.
.TP
\fIinfo\fP
Shows the information about a mixer device.
.TP
\fIscontrols\fP
Shows a complete list of simple mixer controls.
.TP
\fIscontents\fP
Shows a complete list of simple mixer controls with their contents.
.TP
2001-09-26 15:08:14 +02:00
\fIset\fP or \fIsset\fP <\fISCONTROL\fP> <\fIPARAMETER\fP> ...
Sets the simple mixer control contents. The parameter can be the volume
2001-03-16 08:35:25 +01:00
either as a percentage from 0% to 100% or an exact hardware value.
The parameters \fIcap, nocap, mute, unmute, toggle\fP are used to
2001-09-26 15:08:14 +02:00
change capture (recording) and muting for the group specified.
The parameters \fIfront, rear, center, woofer\fP are used to specify
channels to be changed. When plus(+) or minus(\-) letter is appended after
volume value, the volume is incremented or decremented from the current
value, respectively.
A simple mixer control must be specified. Only one device can be controlled
at a time.
.TP
2001-09-26 15:08:14 +02:00
\fIget\fP or \fIsget\fP <\fISCONTROL\fP>
Shows the simple mixer control contents.
A simple mixer control must be specified. Only one device can be controlled
at a time.
.TP
\fIcontrols\fP
Shows a complete list of card controls.
.TP
\fIcontents\fP
Shows a complete list of card controls with their contents.
.TP
2001-03-16 08:35:25 +01:00
\fIcset\fP <\fICONTROL\fP> <\fIPARAMETER\fP> ...
2001-09-26 15:08:14 +02:00
Sets the card control contents. The identifier has these components: iface,
name, index, device, subdevice, numid. The next argument specifies the value
of control.
.TP
2001-03-16 08:35:25 +01:00
\fIcget\fP <\fICONTROL\fP>
2001-09-26 15:08:14 +02:00
Shows the card control contents. The identifier has same syntax as for
the \fIcset\fP command.
1998-10-06 12:19:04 +02:00
.SS Options
.TP
[\fI\-c\fP card]
1998-10-06 12:19:04 +02:00
2002-04-07 22:44:35 +02:00
Select the card number to control. The device name created from this
parameter has syntax 'hw:N' where N is specified card number.
.TP
[\fI\-D\fP device]
2002-04-07 22:44:35 +02:00
Select the device name to control. The default control name is 'default'.
1998-10-06 12:19:04 +02:00
.TP
\fI\-h\fP
1998-10-06 12:19:04 +02:00
Help: show syntax.
.TP
\fI\-q\fP
1998-10-06 12:19:04 +02:00
Quiet mode. Do not show results of changes.
.SS
2001-09-26 15:08:14 +02:00
Example #1:
1998-10-06 12:19:04 +02:00
.TP
\fBamixer \-c 1 sset Line,0 80%,40% unmute cap\fR
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
2001-09-26 15:08:14 +02:00
capture (recording).\fR
.SS
Example #2:
.TP
\fBamixer \-c 2 cset iface=MIXER,name='Line Playback Volume",index=1 40%\fR
2001-09-26 15:08:14 +02:00
will set the third soundcard's second line playback volume(s) to 40%
.SS
Example #3:
.TP
\fBamixer \-c 2 cset numid=34 40%\fR
2001-09-26 15:08:14 +02:00
will set the 34th soundcard element to 40%
1998-10-06 12:19:04 +02:00
.SH BUGS
None known.
.SH AUTHOR
\fBamixer\fP is by Jaroslav Kysela <perex@suse.cz>.
This document is by Paul Winkler <zarmzarm@erols.com> and Jaroslav Kysela <perex@suse.cz>.