aumix(1)

1AUMIX(1)                  BSD General Commands Manual                 AUMIX(1)
2

NAME

4     aumix — adjust audio mixer
5

SYNOPSIS

7     aumix [-<channel
8           option>[[+|-][<amount>]]|<level>|R[ecord]|P[lay]|q[uery]] [-dhILqS]
9           [-f <rc file>][-C <color scheme file>]
10

DESCRIPTION

12     This program adjusts the settings of an audio mixing device.  It can be
13     used from the command line, in scripts, or interactively with the key‐
14     board or mouse.
15

OPTIONS

17   CHANNEL OPTIONS
18     -v          main volume
19     -b          bass
20     -c          CD
21     -i          line in
22     -l          line
23     -m          microphone
24     -o          line out
25     -p          PC speaker
26     -s          synthesizer
27     -t          treble
28     -w          PCM
29     -x          imix
30     -1          line 1
31     -2          line 2
32     -3          line 3
33
34     For each channel, q queries, + and - increment and decrement by one, or
35     an amount if one is specified.  If no + or - is given after the channel
36     option, a number sets a specific level (monophonically).
37
38   OTHER OPTIONS
39     -C color_scheme_file
40                 specify the name of a file containing a color scheme.  This
41                 implies -I.
42
43     -d device_file
44                 specify the name of the mixer device (default is /dev/mixer)
45
46     -f rc_file  specify file for saving and loading settings
47
48     -h          display information on usage
49
50     -I          run aumix interactively, using the full-screen ncurses-based
51                 interface.  This is the default if no options are given, but
52                 must be specified in order to have aumix go into interactive
53                 mode after doing things non-interactively.
54
55     -L          load settings from $HOME/.aumixrc, or /etc/aumixrc if the
56                 former is inaccessible
57
58     -q          query all devices and print their settings
59
60     -S          save settings to $HOME/.aumixrc
61

EXAMPLES

63     The command
64
65           aumix -q -v75 -m 0 -c R -c+10 -m q
66
67     prints all settings, sets volume to 75%, sets microphone to 0, sets CD to
68     record, increases the CD level by ten (both left and right), and prints
69     the new settings for the microphone.
70
71     The .aumixrc file containing:
72
73           vol:60:60
74           wait:5000
75           vol:50:50
76
77     sets the volume to 60%, waits five seconds, then reduces the volume to
78     50%.  Note that "wait" lines will not be saved by aumix.  They must be
79     added by hand.
80

INTERACTIVE USE

82     If no options are given on the command line, and aumix is compiled with
83     ncurses, it will run interactively.
84
85   LAYOUT
86     The left bank of controls is used for adjusting levels; the right bank is
87     for adjusting balance.  Mixing channels not supported by your hardware
88     will not be shown.  Mixing channels which are stereo-capable will have
89     balance controls.
90
91   KEYS
92     The following keys control aumix in interactive mode:
93
94     page up, page down, up and down cursor
95                 select a new control.
96
97     Tab, Enter, <, >, comma and period
98                 toggle between level and balance controls
99
100     +, -, [, ], left and right cursor and digits
101                 adjust the setting of the current device.  The + and right
102                 cursor keys increase the level by 3%; the - and left cursor
103                 keys decrease it by the same amount.  The [ key sets it to 0%
104                 and ] sets it to 100%.  The digits 1 to 9 set it to 10%
105                 through 90%.  The same keys work analogously on the balance
106                 controls.
107
108     Space       toggles between record and play for controls which are capa‐
109                 ble of this.
110
111     |           centers the balance of the current device.
112
113     K or k      show a description of the functions of keys
114
115     L or l      load settings from $HOME/.aumixrc, falling back to
116                 /etc/aumixrc
117
118     M or m      mute or unmute
119
120     O or o      “only”: mute all channels but the current one
121
122     S or s      save settings to the rc file
123
124     U or u      undo any muting
125
126     Q or q      end the program
127
128     ^L          refresh screen
129
130     ^Z, ^D and ^C also have their normal function (the screen is refreshed
131     when aumix is brought to the foreground).
132
133   MOUSE
134     In interactive mode, aumix can accept input from the mouse if gpm(8) is
135     running and aumix is compiled with gpm(8) support.  If gpm is not running
136     but gpm support is included, the message ‘mouse off’ will appear at the
137     top of the screen, and only keyboard input will be accepted.  With gpm(8)
138     running, most functions can be performed through the mouse.  The mouse is
139     active whenever one of its buttons is held down.  While active, it works
140     in the following ways:
141     ·   over a control track, it sets the control to match the position of
142         the mouse cursor.
143     ·   over a record/play indicator, it toggles the record/play state.
144     ·   over the ‘Quit’, ‘Load’, ‘Save’, ‘Keys’, ‘Mute’, ‘Only’, or ‘Undo’
145         labels at the top of the screen, it causes those actions to take
146         place.
147

ENVIRONMENT

149     The HOME variable is used.  When aumix is compiled with GTK+ support,
150     DISPLAY is checked, and if set is used.  LANG is used when aumix the
151     ncurses screen is displayed.
152

FILES

154     Saved settings for the mixer are kept in the /etc/aumixrc and
155     $HOME/.aumixrc files, but can be kept anywhere if specified explicitly.
156     Color schemes are normally kept in the directory given by DATADIR at com‐
157     pilation time, but are preferentially loaded from the current directory
158     and can be kept anywhere so long as the path to them is specified.  The
159     format of these files is:
160
161           item foreground background
162
163     where item is one of ‘active’, ‘axis’, ‘handle’, ‘hotkey’, ‘menu’,
164     ‘play’, ‘record’, or ‘track’ and foreground and background are one of
165     ‘black’, ‘red’, ‘green’, ‘yellow’, ‘blue’, ‘magenta’, ‘cyan’, or ‘white’.
166     The words should be separated by whitespace and can be upper-, lower-, or
167     mixed-case.  Lines not matching all these conditions are ignored.  Some
168     samples of color schemes are provided, named after the sort of terminal
169     where they should be most suitable.
170
171     If either foreground or background is given as ‘-’, then the default
172     color for that is used.  The defaults are a white foreground and black
173     background.
174
175     An xpm icon is provided.
176

VERSION

178     This page corresponds to version 2.7.
179

BUGS

181     Suspending with ^Z may make the terminal difficult to use.
182
183     Please send bug reports and other correspondence to the mailing list.
184     Past messages may be read at
185
186     <URL:http://lilax.org/wws/arc/aumix-l>
187
188     and you may wish to join the list via
189
190     <URL:http://lilax.org/wws/info/aumix-l>
191
192     or by sending a message with just ‘subscribe’ in the subject to
193     ⟨aumix-l-request@lilax.org⟩.  To post without subscribing, omit
194     "-request" from the address.
195
196     Information such as the version of aumix, the architecture and operating
197     system, and the model of sound hardware is sometimes needed to diagnose
198     problems, so it is best if you include such details in any bug reports.
199