1AMIXER(1) General Commands Manual AMIXER(1)
2
6 amixer - command-line mixer for ALSA soundcard driver
7
9 amixer [-option] [cmd]
10
12 amixer allows command-line control of the mixer for the ALSA soundcard
13 driver. amixer supports multiple soundcards.
14 amixer with no arguments will display the current mixer settings for
16 the default soundcard and device. This is a good way to see a list of
17 the simple mixer controls you can use.
18
21 help Shows syntax.
22 info Shows the information about a mixer device.
25 scontrols
28 Shows a complete list of simple mixer controls.
29 scontents
32 Shows a complete list of simple mixer controls with their con‐
33 tents.
34 set or sset <SCONTROL> <PARAMETER> ...
37 Sets the simple mixer control contents. The parameter can be the
38 volume either as a percentage from 0% to 100% with % suffix, a
39 dB gain with dB suffix (like -12.5dB), or an exact hardware
40 value. The dB gain can be used only for the mixer elements with
41 available dB information. When plus(+) or minus(-) letter is
42 appended after volume value, the volume is incremented or decre‐
43 mented from the current value, respectively.
44 The parameters cap, nocap, mute, unmute, toggle are used to
46 change capture (recording) and muting for the group specified.
47 The optional modifiers can be put as extra parameters to specify
49 the stream direction or channels to apply. The modifiers play‐
50 back and capture specify the stream, and the modifiers front,
51 rear, center, woofer are used to specify channels to be changed.
52 A simple mixer control must be specified. Only one device can be
54 controlled at a time.
55 get or sget <SCONTROL>
58 Shows the simple mixer control contents.
59 A simple mixer control must be specified. Only one device can be
61 controlled at a time.
62 controls
65 Shows a complete list of card controls.
66 contents
69 Shows a complete list of card controls with their contents.
70 cset <CONTROL> <PARAMETER> ...
73 Sets the card control contents. The identifier has these compo‐
74 nents: iface, name, index, device, subdevice, numid. The next
75 argument specifies the value of control.
76 cget <CONTROL>
79 Shows the card control contents. The identifier has same syntax
80 as for the cset command.
81
84 -c card
85 Select the card number to control. The device name created from
87 this parameter has syntax 'hw:N' where N is specified card num‐
88 ber.
89 -D device
92 Select the device name to control. The default control name is
94 'default'.
95 -s | --stdin
98 Read from stdin and execute the command on each line sequen‐
100 tially. When this option is given, the command in command-line
101 arguments is ignored.
102 Only sset and cset are accepted. Other commands are ignored.
104 The commands to unmatched ids are ignored without errors too.
105 -h Help: show syntax.
108 -q Quiet mode. Do not show results of changes.
110
113 amixer -c 1 sset Line,0 80%,40% unmute cap
114 will set the second soundcard's left line input volume to 80%
115 and right line input to 40%, unmute it, and select it as a
116 source for capture (recording).
117 amixer -c 1 -- sset Master playback -20dB
120 will set the master volume of the second card to -20dB. If the
121 master has multiple channels, all channels are set to the same
122 value.
123 amixer -c 1 set PCM 2dB+
126 will increase the PCM volume of the second card with 2dB. When
127 both playback and capture volumes exist, this is applied to both
128 volumes.
129 amixer -c 2 cset iface=MIXER,name='Line Playback Volume",index=1 40%
132 will set the third soundcard's second line playback volume(s) to
133 40%
134 amixer -c 2 cset numid=34 40%
137 will set the 34th soundcard element to 40%
138
141 None known.
142
144 amixer is by Jaroslav Kysela <perex@perex.cz>. This document is by
145 Paul Winkler <zarmzarm@erols.com> and Jaroslav Kysela <perex@perex.cz>.
146 11 Aug 2000 AMIXER(1)