1 AUDIOCTL(1)                      User Commands                     AUDIOCTL(1)
   2 
   3 
   4 
   5 NAME
   6        audioctl - audio device control command line interface
   7 
   8 SYNOPSIS
   9        audioctl list-devices
  10 
  11 
  12        audioctl show-device [-v] [-d device]
  13 
  14 
  15        audioctl show-control [-v] [-d device] [control ...]
  16 
  17 
  18        audioctl set-control [-v] [-d device] control value
  19 
  20 
  21        audioctl save-controls [-d device] [-f] file
  22 
  23 
  24        audioctl load-controls [-d device] file
  25 
  26 
  27        audioctl help
  28 
  29 
  30 DESCRIPTION
  31        The audioctl command is used to control various settings and features
  32        of audio devices, including mixer settings such as playback volume and
  33        record gain.
  34 
  35 SUBCOMMANDS
  36        The audioctl command supports the following subcommands.
  37 
  38        list-devices
  39 
  40            List all the audio devices on the system.
  41 
  42 
  43        show-device [-v] [-d device]
  44 
  45            Display an informational overview of device (or the default device
  46            if not specified).  If the -v option is specified, then more detail
  47            will be displayed.
  48 
  49 
  50        show-control [-v] [-d device] [control ... ]
  51 
  52            Display the control settings for one or more controls of a device
  53            (or the default device if not specified).  If no control is
  54            specified, then the settings for all controls will be displayed. If
  55            the -v option is specified, then more detail will be displayed.
  56 
  57 
  58        set-control [-v] [-d device] control value
  59 
  60            Set the control settings for a control of a device (or the default
  61            device if not specified) to value.  If the -v option is specified,
  62            then more verbose output be displayed.
  63 
  64 
  65        save-controls [-f] [-d device] file
  66 
  67            Save all control settings of the device (or the default device if
  68            not specified) to the named file.  This subcommand will not replace
  69            or modify an existing file unless -f (force) is specified.
  70 
  71 
  72        load-controls [-d device] file
  73 
  74            Load previously saved control settings from a file into a device
  75            (or all audio devices if not specified).
  76 
  77 
  78        help
  79 
  80            Display the usage message.
  81 
  82 
  83 ENVIRONMENT VARIABLES
  84        AUDIODEV
  85                    The full path name of the default audio device to use if
  86                    one is not specified on the command line.  If this variable
  87                    is not set, /dev/audio is used.
  88 
  89 
  90 ATTRIBUTES
  91        The audioctl command and its subcommands are Committed.  The names of
  92        controls, their values, and device names are Uncommitted.  The display
  93        output is intended for human consumption, and is Not An Interface.  The
  94        format of the state files used by the save-controls and load-controls
  95        subcommands is Committed Private.
  96 
  97 SEE ALSO
  98        audioplay(1), audiorecord(1), dsp(7I), mixer(7I)
  99 
 100 
 101 
 102                                February 8, 2020                    AUDIOCTL(1)