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 sources = 256  # Sets the maximum number of allocatable sources. Lower values
  44                # may help for systems with apps that try to play more sounds
  45                # than the CPU can handle. Default is 256
  46
  47 stereodup =  # Sets whether to duplicate stereo sounds on the rear speakers for
  48              # 4+ channel output. This can make stereo sources substantially
  49              # louder than mono or even 4+ channel sources, but provides a
  50              # "fuller" playback quality. True, yes, on, and non-0 values will
  51              # duplicate stereo sources. 0 and anything else will cause stereo
  52              # sounds to only play out the front speakers.
  53              # Default is false
  54
  55 drivers =  # Sets the backend driver list order, comma-seperated. Unknown
  56            # backends and duplicated names are ignored, and unlisted backends
  57            # won't be considered for use. An empty list means the default.
  58            # Default is:
  59            # alsa,oss,dsound,winmm,wave
  60
  61 [alsa]  # ALSA backend stuff
  62 device = default  # Sets the device name for the default playback device.
  63                   # Default is default
  64
  65 periods = 0  # Sets the number of update buffers for playback. A value of 0
  66              # means auto-select. Default is 0
  67
  68 capture = default  # Sets the device name for the default capture device.
  69                    # Default is default
  70
  71 mmap = true  # Sets whether to try using mmap mode (helps reduce latencies and
  72              # CPU consumption). If mmap isn't available, it will automatically
  73              # fall back to non-mmap mode. True, yes, on, and non-0 values will
  74              # attempt to use mmap. 0 and anything else will force mmap off.
  75              # Default is true.
  76
  77 [oss]  # OSS backend stuff
  78 device = /dev/dsp  # Sets the device name for OSS output. Default is /dev/dsp
  79
  80 periods = 4  # Sets the number of update buffers. Default is 4
  81
  82 capture = /dev/dsp  # Sets the device name for OSS capture. Default is /dev/dsp
  83
  84 [dsound]  # DirectSound backend stuff
  85           # Nothing yet...
  86
  87 [winmm]  # Windows Multimedia backend stuff
  88          # Nothing yet...
  89
  90 [wave]  # Wave File Writer stuff
  91 file =  # Sets the filename of the wave file to write to. An empty name
  92         # prevents the backend from opening, even when explicitly requested.
  93         # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
  94         # Default is empty