mirror of
https://github.com/alsa-project/alsa-utils
synced 2024-11-10 00:15:43 +01:00
82 lines
2.4 KiB
Groff
82 lines
2.4 KiB
Groff
.TH AMIXER 1 "30 Sep 1998"
|
|
.SH NAME
|
|
amixer \- commandline mixer for ALSA soundcard driver
|
|
.SH SYNOPSIS
|
|
\fBamixer\fP [\fI-c\fP card] [\fI-d\fP dev] device [vol|L:R]
|
|
[\fImute\fP|\fIunmute\fP] [\fIrec\fP|\fInorec\fP]
|
|
.SH DESCRIPTION
|
|
\fBamixer\fP allows command-line control of the mixer for the ALSA
|
|
soundcard driver. The settings can be written to or read from a resource
|
|
file, making \fBamixer\fP ideal for invoking via a boot-time script.
|
|
\fBamixer\fP supports multiple soundcards with multiple devices.
|
|
.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 devices (aka mixer channels) you can control.
|
|
|
|
\fImute, unmute, rec,\fP and \fInorec\fP are used to toggle muting and
|
|
recording for the device specified.
|
|
|
|
The volume can be specified either as a percentage from 0 to 100, or as
|
|
a
|
|
colon-separated pair of percentages if independent control of Left and
|
|
Right
|
|
is
|
|
needed. A mixer device must be specified. Only one device can be
|
|
controlled at a time, except when using the \fI-r\fP flag.
|
|
|
|
.SS Options
|
|
|
|
.TP
|
|
[\fI-c\fP card] [\fI-d\fP device]
|
|
|
|
Select the card and device number to control. Cards are numbered from 1
|
|
(the default). Devices are numbered from 0 (the default). Note that
|
|
here,
|
|
"device" does \fBnot\fP mean "mixer channel", but refers to the
|
|
architecture of your soundcard. Many
|
|
soundcards will only have device 0. Some more complex cards may have
|
|
more
|
|
devices. Try using \fI-d 1\fP and if anything useful happens, now you
|
|
know
|
|
more
|
|
than I do. :)
|
|
|
|
.TP
|
|
\fI-h\fP
|
|
Help: show syntax.
|
|
.TP
|
|
[\fI-p\fP path] \fI-r\fP
|
|
Read settings from $HOME/.amixerrc or from optional <path>. If <path>
|
|
is ``\-'', reads from the standard input.
|
|
.TP
|
|
[\fI-p\fP path] \fI-w\fP
|
|
Write the current mixer settings into $HOME/.amixerrc or optional <path>.
|
|
If <path> is ``\-'', writes to the standard output.
|
|
.TP
|
|
\fI-q\fP
|
|
Quiet mode. Do not show results of changes.
|
|
|
|
.SS
|
|
Example:
|
|
|
|
.RS
|
|
\fBamixer -c 2 line-in 80:50 unmute rec\fR
|
|
|
|
.ID
|
|
will set the second soundcard's line-in left volume to 80%, line-in
|
|
right volume to 50%, unmute it, and select it as a source for recording.
|
|
.SH FILES
|
|
.I
|
|
$HOME/.amixerrc
|
|
is automatically generated from the current mixer settings by invoking
|
|
amixer with the
|
|
.I
|
|
-w
|
|
flag. It should probably not be modified by hand.
|
|
.SH BUGS
|
|
None known.
|
|
.SH AUTHOR
|
|
\fBamixer\fP is by Andy Lo A Foe <arloafoe@cs.vu.nl>.
|
|
This document is by Paul Winkler <zarmzarm@erols.com>.
|