AUCTL(1)

📦 version 1.9.4, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ AUCTL ✨ (section 1 of the manual, bestie)

okay so bestie, meet auctl — a whole little program that lets u control various audio server parameters. that's the whole vibe. 💅

🎀 NAME 🎀

auctl — control various audio server parameters ✨

🌸 SYNOPSYS 🌸

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

🦋 DESCRIPTION 🦋

so the auctl program can be used to control various audio server parameters. no cap, that's literally its job. it's typically used when you're connecting up new devices, or when you wanna set user preferences. main character energy for your audio setup fr fr.

here's the tea tho 👀 — if no command is specified on the program command line, auctl reads commands from the standard output. and if the standard input and the standard output are both attached to a terminal, you get an interactive prompt. so cozy. so demure. 🫶

💖 OPTIONS 💖

the following options may be used with auctl:

  • -audio servername — this option specifies the Network Audio System server on which the files should be played. telling it where the party is at 🎉
  • -q — this option indicates that no prompt should be given when reading commands from the standard input. quiet mode. stealth mode. 🤫

👑 COMMANDS 👑

the following commands may be used with auctl:

  • help — this command prints a list of the commands that may be given. it's giving "help me help u" 💁‍♀️
  • set device id gain [=,+,-] percent — with =, this command sets the gain on the device specified by id to the indicated percentage, or alters it by the given number of percentage points if + or - is used. so: = = set it, + / - = nudge it. cute. now the id part 👇 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. iykyk 💅
  • 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. it's giving "here's exactly what u'd type back" ✨
  • list device id linemode — this command lists the line mode of the specified device in the form needed to set it. same energy, different setting 🌈
  • list device id — this command lists the gain and line mode of the specified device. the whole lil combo platter 🍓
  • quit, exit, or ^D — either of these commands or an end of file causes the program to exit. bye bestie, u slayed 👋

🌈 ENVIRONMENT VARIABLES 🌈

the following environment variables are used by auctl:

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

💜 SEE ALSO 💜

nas(1), auplay(1), audial(1), audemo(1), autool(1) — go read the whole friend group, they're all iconic 🔥

Copyright 1993, 1994 Network Computing Devices, Inc.

🧚 AUTHOR 🧚

Jim Fulton, Network Computing Devices, Inc.

and that's the whole page bestie, no notes 💅 this was the General Commands Manual entry for AUCTL, sitting pretty at version 1.9.4 — mwah, periodt. 🎀✨🦋

📦 where this page comes from