AUCTL(1)

📦 version 1.9.5, in fedora 43, fedora 44

✨ AUCTL — like, the manual page, but make it cute ✨

okay bestie, welcome to auctl(1) from the General Commands Manual section — she's the little control freak for your audio server and we're gonna learn her together 💖

🎀 NAME 🎀

auctl — control various audio server parameters

🦋 SYNOPSYS 🦋

(yes the original spells it like that, we respect her 💅)

auctl [-audio servername] [-q] [command...]

💜 DESCRIPTION 💜

So like, the auctl program is your girl for controlling various audio server parameters. She's the one you call when you're plugging in new devices, or when you just wanna set your user preferences and vibe 💫

If you don't give her any command on the program command line, auctl reads commands from the standard output. (fr fr, that's what it says.)

And here's the slay part: if the standard input and the standard output are both attached to a terminal, you get an interactive prompt 🫶

🌸 OPTIONS 🌸

The following options may be used with auctl:

  • -audio servername — this one specifies the Network Audio System server on which the files should be played. iconic behavior honestly 🎧
  • -q — this one indicates that no prompt should be given when reading commands from the standard input. quiet queen energy 🤫

👑 COMMANDS 👑

The following commands may be used with auctl:

  • help — this command prints a list of the commands that may be given. your little cheat sheet, no cap 📝
  • set device id gain [=,+,-] percent — with =, this command sets the gain on the device specified by id to the indicated percentage. Or it alters it by the given number of percentage points if + or - is used. If the id is a decimal number n, the nth device returned by the server (see auinfo) is used. Otherwise, id should be a hexidecimal number specifying the resource identifier of the desired device. volume slider but make it command line 🔥
  • set device id linemode = low — this command sets the linemode of the device specified by id to the lower setting appropriate for microphones 🎤
  • set device id linemode = hi — this command sets the linemode of the device specified by id to the higher setting appropriate for CD players 💿
  • list device id gain — this command lists the gain of the specified device in the form needed to set it. so you can copy-paste it back, we love a self-documenting moment ✨
  • list device id linemode — this command lists the line mode of the specified device in the form needed to set it.
  • list device id — this command lists the gain and line mode of the specified device. the full rundown, she's giving everything 💅
  • quit, exit, or ^D — either of these commands or an end of file causes the program to exit. bye bestie, see you next time 👋

🌈 ENVIRONMENT VARIABLES 🌈

The following environment variables are used by auctl:

  • AUDIOSERVER — this specifies the name of default audio server to contact if no name is explicitly given on the command line.
  • DISPLAY — this specifies the name of an X Window System display that should be assumed to also have a corresponding Network Audio System server.

💖 SEE ALSO 💖

nas(1), auplay(1), audial(1), audemo(1), autool(1)

(the whole friend group, go say hi 🫶)

Copyright 1993, 1994 Network Computing Devices, Inc.

🧚 AUTHOR 🧚

Jim Fulton, Network Computing Devices, Inc.

and that's the whole page, bestie!! 💀✨ she's version 1.9.5, she lives in the General Commands Manual, and she's been serving since the 90s — icon behavior only 👑💖 🎀
📦 where this page comes from