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 # For Windows, these settings should go into %AppData%\alsoft.ini
   8
   9 # Option and block names are case-insenstive. The supplied values are only
  10 # hints and may not be honored (though generally it'll try to get as close as
  11 # possible). These are the current available settings:
  12
  13 format = AL_FORMAT_STEREO16  # Sets the output format. Can be one of:
  14                              # AL_FORMAT_MONO8    (8-bit mono)
  15                              # AL_FORMAT_STEREO8  (8-bit stereo)
  16                              # AL_FORMAT_QUAD8    (8-bit 4-channel)
  17                              # AL_FORMAT_51CHN8   (8-bit 5.1 output)
  18                              # AL_FORMAT_61CHN8   (8-bit 6.1 output)
  19                              # AL_FORMAT_71CHN8   (8-bit 7.1 output)
  20                              # AL_FORMAT_MONO16   (16-bit mono)
  21                              # AL_FORMAT_STEREO16 (16-bit stereo)
  22                              # AL_FORMAT_QUAD16   (16-bit 4-channel)
  23                              # AL_FORMAT_51CHN16  (16-bit 5.1 output)
  24                              # AL_FORMAT_61CHN16  (16-bit 6.1 output)
  25                              # AL_FORMAT_71CHN16  (16-bit 7.1 output)
  26                              # Default is AL_FORMAT_STEREO16
  27
  28 cf_level = 0  # Sets the crossfeed level for stereo output. Valid values are:
  29               # 0 - No crossfeed
  30               # 1 - Low crossfeed
  31               # 2 - Middle crossfeed
  32               # 3 - High crossfeed (virtual speakers are closer to itself)
  33               # 4 - Low easy crossfeed
  34               # 5 - Middle easy crossfeed
  35               # 6 - High easy crossfeed
  36               # Default is 0. Users of headphones may want to try various
  37               # settings. Has no effect on non-stereo modes.
  38
  39 frequency = 44100  # Sets the output frequency. Default is 44100
  40
  41 refresh = 4096  # Sets the buffer size, in frames. Default is 4096. Note that
  42                 # the actual granularity may or may not be less than this.
  43
  44 sources = 256  # Sets the maximum number of allocatable sources. Lower values
  45                # may help for systems with apps that try to play more sounds
  46                # than the CPU can handle. Default is 256
  47
  48 stereodup =  # Sets whether to duplicate stereo sounds on the rear speakers for
  49              # 4+ channel output. This can make stereo sources substantially
  50              # louder than mono or even 4+ channel sources, but provides a
  51              # "fuller" playback quality. True, yes, on, and non-0 values will
  52              # duplicate stereo sources. 0 and anything else will cause stereo
  53              # sounds to only play out the front speakers.
  54              # Default is false
  55
  56 drivers =  # Sets the backend driver list order, comma-seperated. Unknown
  57            # backends and duplicated names are ignored, and unlisted backends
  58            # won't be considered for use. An empty list means the default.
  59            # Default is:
  60            # alsa,oss,solaris,dsound,winmm,wave
  61
  62 [alsa]  # ALSA backend stuff
  63 device = default  # Sets the device name for the default playback device.
  64                   # Default is default
  65
  66 periods = 0  # Sets the number of update buffers for playback. A value of 0
  67              # means auto-select. Default is 0
  68
  69 capture = default  # Sets the device name for the default capture device.
  70                    # Default is default
  71
  72 mmap = true  # Sets whether to try using mmap mode (helps reduce latencies and
  73              # CPU consumption). If mmap isn't available, it will automatically
  74              # fall back to non-mmap mode. True, yes, on, and non-0 values will
  75              # attempt to use mmap. 0 and anything else will force mmap off.
  76              # Default is true.
  77
  78 [oss]  # OSS backend stuff
  79 device = /dev/dsp  # Sets the device name for OSS output. Default is /dev/dsp
  80
  81 periods = 4  # Sets the number of update buffers. Default is 4
  82
  83 capture = /dev/dsp  # Sets the device name for OSS capture. Default is /dev/dsp
  84
  85 [solaris]  # Solaris backend stuff
  86 device = /dev/audio  # Sets the device name for Solaris output. Default is
  87                      # /dev/audio
  88
  89 [dsound]  # DirectSound backend stuff
  90           # Nothing yet...
  91
  92 [winmm]  # Windows Multimedia backend stuff
  93          # Nothing yet...
  94
  95 [wave]  # Wave File Writer stuff
  96 file =  # Sets the filename of the wave file to write to. An empty name
  97         # prevents the backend from opening, even when explicitly requested.
  98         # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
  99         # Default is empty