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 drivers =  # Sets the backend driver list order, comma-seperated. Unknown
  48            # backends and duplicated names are ignored, and unlisted backends
  49            # won't be considered for use. An empty list means the default.
  50            # Default is:
  51            # alsa,oss,dsound,winmm,wave
  52
  53 [alsa]  # ALSA backend stuff
  54 device = default  # Sets the device name for the default playback device.
  55                   # Default is default
  56
  57 periods = 0  # Sets the number of update buffers for playback. A value of 0
  58              # means auto-select. Default is 0
  59
  60 capture = default  # Sets the device name for the default capture device.
  61                    # Default is default
  62
  63 mmap = true  # Sets whether to try using mmap mode (helps reduce latencies and
  64              # CPU consumption). If mmap isn't available, it will automatically
  65              # fall back to non-mmap mode. True, yes, on, and non-0 values will
  66              # attempt to use mmap. 0 and anything else will force mmap off.
  67              # Default is true.
  68
  69 [oss]  # OSS backend stuff
  70 device = /dev/dsp  # Sets the device name for OSS output. Default is /dev/dsp
  71
  72 periods = 4  # Sets the number of update buffers. Default is 4
  73
  74 capture = /dev/dsp  # Sets the device name for OSS capture. Default is /dev/dsp
  75
  76 [dsound]  # DirectSound backend stuff
  77           # Nothing yet...
  78
  79 [winmm]  # Windows Multimedia backend stuff
  80          # Nothing yet...
  81
  82 [wave]  # Wave File Writer stuff
  83 file =  # Sets the filename of the wave file to write to. An empty name
  84         # prevents the backend from opening, even when explicitly requested.
  85         # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
  86         # Default is empty