amixer(1)

1AMIXER(1)                   General Commands Manual                  AMIXER(1)
2
3
4

NAME

6       amixer - command-line mixer for ALSA soundcard driver
7

SYNOPSIS

9       amixer [-option] [cmd]
10

DESCRIPTION

12       amixer  allows command-line control of the mixer for the ALSA soundcard
13       driver.  amixer supports multiple soundcards.
14
15       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
19

COMMANDS

21       help   Shows syntax.
22
23
24       info   Shows the information about a mixer device.
25
26
27       scontrols
28              Shows a complete list of simple mixer controls.
29
30
31       scontents
32              Shows a complete list of simple mixer controls with  their  con‐
33              tents.
34
35
36       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
45              The  parameters  cap,  nocap,  mute,  unmute, toggle are used to
46              change capture (recording) and muting for the group specified.
47
48              The optional modifiers can be put as extra parameters before the
49              value to specify the stream direction or channels to apply.  The
50              modifiers playback and capture specify the stream, and the modi‐
51              fiers  front,  frontleft, frontright, frontcenter, center, rear,
52              rearright, rearleft, woofer are used to specify channels  to  be
53              changed.
54
55              A simple mixer control must be specified. Only one device can be
56              controlled at a time.
57
58
59       get or sget <SCONTROL>
60              Shows the simple mixer control contents.
61
62              A simple mixer control must be specified. Only one device can be
63              controlled at a time.
64
65
66       controls
67              Shows a complete list of card controls.
68
69
70       contents
71              Shows a complete list of card controls with their contents.
72
73
74       cset <CONTROL> <PARAMETER> ...
75              Sets  the card control contents. The identifier has these compo‐
76              nents: iface, name, index, device, subdevice,  numid.  The  next
77              argument specifies the value of control.
78
79
80       cget <CONTROL>
81              Shows  the card control contents. The identifier has same syntax
82              as for the cset command.
83
84

ADVANCED COMMANDS

86       sevents
87              Shows the events for the simple mixer controls.
88
89
90       events Shows the events for the mixer controls.
91
92

OPTIONS

94       -c card
95
96              Select the card number to control. The device name created  from
97              this  parameter has syntax 'hw:N' where N is specified card num‐
98              ber.
99
100
101       -D device
102
103              Select the device name to control. The default control  name  is
104              'default'.
105
106
107       -s | --stdin
108
109              Read  from  stdin  and  execute the command on each line sequen‐
110              tially.  When this option is given, the command in  command-line
111              arguments is ignored.
112
113              Only  sset  and  cset are accepted.  Other commands are ignored.
114              The commands to unmatched ids are ignored without errors too.
115
116
117       -h     Help: show syntax.
118
119
120       -q     Quiet mode. Do not show results of changes.
121
122
123       -R     Use the raw value for evaluating the percentage  representation.
124              This is the default mode.
125
126
127       -M     Use  the mapped volume for evaluating the percentage representa‐
128              tion like alsamixer, to be more natural for human ear.
129
130

EXAMPLES

132       amixer -c 1 sset Line,0 80%,40% unmute cap
133              will set the second soundcard's left line input  volume  to  80%
134              and  right  line  input  to  40%,  unmute it, and select it as a
135              source for capture (recording).
136
137
138       amixer -c 1 -- sset Master playback -20dB
139              will set the master volume of the second card to -20dB.  If  the
140              master  has  multiple channels, all channels are set to the same
141              value.
142
143
144       amixer -c 1 set PCM 2dB+
145              will increase the PCM volume of the second card with 2dB.   When
146              both playback and capture volumes exist, this is applied to both
147              volumes.
148
149
150       amixer -c 2 cset iface=MIXER,name='Line Playback Volume",index=1 40%
151              will set the third soundcard's second line playback volume(s) to
152              40%
153
154
155       amixer -c 2 cset numid=34 40%
156              will set the 34th soundcard element to 40%
157
158

BUGS

164       None known.
165
166

AUTHOR

168       amixer  is  by  Jaroslav  Kysela <perex@perex.cz>.  This document is by
169       Paul Winkler <zarmzarm@erols.com> and Jaroslav Kysela <perex@perex.cz>.
170
171
172
173                                  11 Aug 2000                        AMIXER(1)