alsoftrc.sample

   1 # OpenAL config file. Options that are not under a block or are under the
   2 # [general] block are for general, non-backend-specific options. Blocks may
   3 # appear multiple times, and duplicated options will take the last value
   4 # specified.
   5 # The system-wide settings can be put in /etc/openal/alsoft.conf and user-
   6 # specific override settings in ~/.alsoftrc.
   7
   8 # Option and block names are case-insenstive. The supplied values are only
   9 # hints and may not be honored (though generally it'll try to get as close as
  10 # possible). These are the current available settings:
  11
  12 format = AL_FORMAT_STEREO16  # Sets the output format. Can be one of:
  13                              # AL_FORMAT_MONO8    (8-bit mono)
  14                              # AL_FORMAT_STEREO8  (8-bit stereo)
  15                              # AL_FORMAT_QUAD8    (8-bit 4-channel)
  16                              # AL_FORMAT_51CHN8   (8-bit 5.1 output)
  17                              # AL_FORMAT_61CHN8   (8-bit 6.1 output)
  18                              # AL_FORMAT_71CHN8   (8-bit 7.1 output)
  19                              # AL_FORMAT_MONO16   (16-bit mono)
  20                              # AL_FORMAT_STEREO16 (16-bit stereo)
  21                              # AL_FORMAT_QUAD16   (16-bit 4-channel)
  22                              # AL_FORMAT_51CHN16  (16-bit 5.1 output)
  23                              # AL_FORMAT_61CHN16  (16-bit 6.1 output)
  24                              # AL_FORMAT_71CHN16  (16-bit 7.1 output)
  25                              # Default is AL_FORMAT_STEREO16
  26
  27 cf_level = 0  # Sets the crossfeed level for stereo output. Valid values are:
  28               # 0 - No crossfeed
  29               # 1 - Low crossfeed
  30               # 2 - Middle crossfeed
  31               # 3 - High crossfeed (virtual speakers are closer to itself)
  32               # 4 - Low easy crossfeed
  33               # 5 - Middle easy crossfeed
  34               # 6 - High easy crossfeed
  35               # Default is 0. Users of headphones may want to try various
  36               # settings. Has no effect on non-stereo modes.
  37
  38 frequency = 44100  # Sets the output frequency. Default is 44100
  39
  40 refresh = 8192  # Sets the buffer size, in frames. Default is 8192. Note that
  41                 # the actual granularity may or may not be less than this.
  42
  43 drivers =  # Sets the backend driver list order, comma-seperated. Unknown
  44            # backends and duplicated names are ignored, and unlisted backends
  45            # won't be considered for use. An empty list means the default.
  46            # Default is:
  47            # alsa,oss,dsound,winmm,wave
  48
  49 [alsa]  # ALSA backend stuff
  50 device = default  # Sets the device name for the default playback device.
  51                   # Default is default
  52
  53 periods = 0  # Sets the number of update buffers for playback. A value of 0
  54              # means auto-select. Default is 0
  55
  56 capture = default  # Sets the device name for the default capture device.
  57                    # Default is default
  58
  59 mmap = true  # Sets whether to try using mmap mode (helps reduce latencies and
  60              # CPU consumption). If mmap isn't available, it will automatically
  61              # fall back to non-mmap mode. True, yes, on, and non-0 values will
  62              # attempt to use mmap. 0 and anything else will force mmap off.
  63              # Default is true.
  64
  65 [oss]  # OSS backend stuff
  66 device = /dev/dsp  # Sets the device name for OSS output. Default is /dev/dsp
  67
  68 periods = 4  # Sets the number of update buffers. Default is 4
  69
  70 capture = /dev/dsp  # Sets the device name for OSS capture. Default is /dev/dsp
  71
  72 [dsound]  # DirectSound backend stuff
  73           # Nothing yet...
  74
  75 [winmm]  # Windows Multimedia backend stuff
  76          # Nothing yet...
  77
  78 [wave]  # Wave File Writer stuff
  79 file =  # Sets the filename of the wave file to write to. An empty name
  80         # prevents the backend from opening, even when explicitly requested.
  81         # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
  82         # Default is empty