AUMIX(1)

💖 AUMIX — adjust audio mixer 💖

okay bestie, gather round, because this is aumix, the Unix manual page for adjusting your audio mixer, and it is genuinely iconic. ✨

---

🌸 SYNOPSIS 🌸

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

---

🎀 DESCRIPTION 🎀

So this program adjusts the settings of an audio mixing device. That's the whole vibe. You can run it from the command line, you can drop it in scripts, or you can go full interactive with your keyboard or your mouse. Choose your own adventure, fr fr. 🦋

---

✨ OPTIONS ✨

🎚️ CHANNEL OPTIONS 🎚️

Each of these is one channel, okay? One bullet per channel, no skips, no cuts:

• -v — main volume
• -b — bass
• -c — CD
• -i — input gain
• -l — line
• -m — microphone
• -o — output gain
• -p — PC speaker
• -r — record
• -s — synthesizer
• -t — treble
• -w — PCM
• -W — PCM 2
• -x — mix monitor
• -1 — line 1
• -2 — line 2
• -3 — line 3

Okay so here's the tea on how those behave: for each channel, q queries it, + and - increment and decrement by one — or by an amount, if you specified one. And if there's no + or - after the channel option, then a number just sets a specific level (monophonically). Periodt. 💅

🌈 OTHER OPTIONS 🌈

• -C color_scheme_file — names the file that holds a color scheme. Heads up: this implies -I. The color scheme file can live in your current working directory or in the aumix data directory, which is typically /usr/share/aumix or /usr/share/aumix-gtk if you're on the GTK-enabled aumix package. You can use this option to force the ncurses interface while running a GTK version — and in that case, no need to give a filename at all. 🎨
• -d device_file — names the mixer device (default is /dev/mixer)
• -f rc_file — the file to save settings to and load settings from
• -h — shows you info on usage
• -I — runs aumix interactively with the full-screen ncurses-based interface. This is the default when no options are given, but you must specify it if you want aumix to go into interactive mode after it does stuff non-interactively. Also: to force the ncurses interface with the GTK version, pass -C (no filename needed).
• -L — loads settings from $HOME/.aumixrc, or from /etc/aumixrc if the former is inaccessible
• -q — queries all devices and prints their settings
• -S — saves settings to $HOME/.aumixrc

---

🍓 EXAMPLES 🍓

The command

aumix -q -v75 -m 0 -c R -c+10 -m q

prints all settings, sets volume to 75%, sets microphone to 0, sets CD to record, increases the CD level by ten (both left and right), and prints the new settings for the microphone. Look at her go. 👑

And the .aumixrc file containing:

vol:60:60
wait:5000
vol:50:50

sets the volume to 60%, waits five seconds, then reduces the volume to 50%. Important note tho: wait lines will not be saved by aumix. You have to add them by hand, bestie. No autosave for those. 😭

---

🎮 INTERACTIVE USE 🎮

If no options are given on the command line, and aumix is compiled with ncurses, it'll just run interactively. Main character energy, no notes. 💖

🧚 LAYOUT 🧚

The left bank of controls is for adjusting levels; the right bank is for adjusting balance. Mixing channels your hardware doesn't support won't be shown at all — they simply do not exist here. And mixing channels that are stereo-capable get balance controls. Fancy. ✨

⌨️ KEYS ⌨️

The following keys control aumix in interactive mode:

• page up, page down, up and down cursor — select a new control.
• Tab, Enter, <, >, comma and period — toggle between level and balance controls
• +, -, [, ], left and right cursor and digits — adjust the setting of the current device. The + and right cursor keys increase the level by 3%; the - and left cursor keys decrease it by the same amount. The [ key sets it to 0% and ] or 0 set it to 100%. The digits 1 to 9 set it to 10% through 90%. The digit 0 sets it to 100% (not 0%). The same keys work analogously on the balance controls. 🎛️
• Space — toggles between record and play for controls which are capable of this.
• | — centers the balance of the current device.
• K or k — show a description of the functions of keys
• L or l — load settings from $HOME/.aumixrc, falling back to /etc/aumixrc
• M or m — mute or unmute
• O or o — "only": mute all channels but the current one
• S or s — save settings to the rc file
• U or u — undo any muting
• Q or q — end the program
• ^L — refresh screen
• ^Z, ^D and ^C also have their normal function (the screen is refreshed when aumix is brought to the foreground).

🖱️ MOUSE 🖱️

In interactive mode, aumix can accept input from the mouse if gpm(8) is running and aumix is compiled with gpm(8) support. If gpm is not running but gpm support is included, the message mouse off will appear at the top of the screen, and only keyboard input will be accepted. With gpm(8) running, most functions can be performed through the mouse. The mouse is active whenever one of its buttons is held down. While active, it works in the following ways:

• over a control track, it sets the control to match the position of the mouse cursor.
• over a record/play indicator, it toggles the record/play state.
• over the Quit, Load, Save, Keys, Mute, Only, or Undo labels at the top of the screen, it causes those actions to take place.

---

🌈 ENVIRONMENT 🌈

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

---

🦋 FILES 🦋

Saved settings for the mixer are kept in the /etc/aumixrc and $HOME/.aumixrc files, but can be kept anywhere if specified explicitly. Color schemes are normally kept in the directory given by DATADIR at compilation time, but are preferentially loaded from the current directory and can be kept anywhere so long as the path to them is specified. The format of these files is:

item foreground background

where item is one of active, axis, handle, hotkey, menu, play, record, or track and foreground and background are one of black, red, green, yellow, blue, magenta, cyan, or white. The words should be separated by whitespace and can be upper-, lower-, or mixed-case. Lines not matching all these conditions are ignored. Some samples of color schemes are provided, named after the sort of terminal where they should be most suitable. 🌸

If either foreground or background is given as -, then the default color for that is used. If aumix is linked against ncurses, then the terminal's default fore or background will be used; else the default foreground is white and the default background is black.

An xpm icon is provided. 🖼️

---

⭐ VERSION ⭐

This page corresponds to version 2.9.1.

---

💀 BUGS 💀

Suspending with ^Z may make the terminal difficult to use. Not cute, be careful. 🙈

---

👑 HOME PAGE 👑

http://jpj.net/~trevor/aumix.html

---

📬 MAILING LISTS 📬

https://gna.org/mail/?group=aumix

---

🔥 SEE ALSO 🔥

gpm(1), moused(8), sb(4), xaumix(1)

---

and that's the whole page, bestie — every flag, every file, every key, no crumbs left behind. 💜 This one came from Debian, dated July 13, 2000, under AUMIX(1). slay. 💅✨