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 # The environment variable ALSOFT_CONF can be used to specify another config
   9 # override
  10
  11 # Option and block names are case-insenstive. The supplied values are only
  12 # hints and may not be honored (though generally it'll try to get as close as
  13 # possible). These are the current available settings:
  14
  15 format = AL_FORMAT_STEREO16  # Sets the output format. Can be one of:
  16                              # AL_FORMAT_MONO8    (8-bit mono)
  17                              # AL_FORMAT_STEREO8  (8-bit stereo)
  18                              # AL_FORMAT_QUAD8    (8-bit 4-channel)
  19                              # AL_FORMAT_51CHN8   (8-bit 5.1 output)
  20                              # AL_FORMAT_61CHN8   (8-bit 6.1 output)
  21                              # AL_FORMAT_71CHN8   (8-bit 7.1 output)
  22                              # AL_FORMAT_MONO16   (16-bit mono)
  23                              # AL_FORMAT_STEREO16 (16-bit stereo)
  24                              # AL_FORMAT_QUAD16   (16-bit 4-channel)
  25                              # AL_FORMAT_51CHN16  (16-bit 5.1 output)
  26                              # AL_FORMAT_61CHN16  (16-bit 6.1 output)
  27                              # AL_FORMAT_71CHN16  (16-bit 7.1 output)
  28                              # Default is AL_FORMAT_STEREO16
  29
  30 cf_level = 0  # Sets the crossfeed level for stereo output. Valid values are:
  31               # 0 - No crossfeed
  32               # 1 - Low crossfeed
  33               # 2 - Middle crossfeed
  34               # 3 - High crossfeed (virtual speakers are closer to itself)
  35               # 4 - Low easy crossfeed
  36               # 5 - Middle easy crossfeed
  37               # 6 - High easy crossfeed
  38               # Default is 0. Users of headphones may want to try various
  39               # settings. Has no effect on non-stereo modes.
  40
  41 frequency = 44100  # Sets the output frequency. Default is 44100
  42
  43 refresh = 4096  # Sets the buffer size, in frames. Default is 4096. Note that
  44                 # the actual granularity may or may not be less than this.
  45
  46 sources = 256  # Sets the maximum number of allocatable sources. Lower values
  47                # may help for systems with apps that try to play more sounds
  48                # than the CPU can handle. Default is 256
  49
  50 stereodup =  # Sets whether to duplicate stereo sounds on the rear and side
  51              # speakers for 4+ channel output. This can make stereo sources
  52              # substantially louder than mono or even 4+ channel sources, but
  53              # provides a "fuller" playback quality. True, yes, on, and non-0
  54              # values will duplicate stereo sources. 0 and anything else will
  55              # cause stereo sounds to only play out the front speakers.
  56              # Default is false
  57
  58 drivers =  # Sets the backend driver list order, comma-seperated. Unknown
  59            # backends and duplicated names are ignored, and unlisted backends
  60            # won't be considered for use. An empty list means the default.
  61            # Default is:
  62            # alsa,oss,solaris,dsound,winmm,port,pulse,wave
  63
  64 excludefx =  # Sets which effects to exclude, preventing apps from using them.
  65              # This can help for apps that try to use effects which are too CPU
  66              # intensive for the system to handle. Available effects are:
  67              # reverb,echo
  68              # Default is empty (all available effects enabled)
  69
  70 slots = 4  # Sets the maximum number of Auxiliary Effect Slots an app can
  71            # create. A slot can use a non-negligible amount of CPU time if an
  72            # effect is set on it even if no sources are feeding it, so this may
  73            # help when apps use more than the system can handle. Default is 4
  74
  75 sends = 2  # Sets the maximum number of auxiliary sends per source. The total
  76            # number of sends possible is defined at compile time and thus can
  77            # not be increased beyond the default. Default is 2
  78
  79 layout_STEREO =  # Sets the speaker layout when using stereo output. Values are
  80                  # specified in degrees, where 0 is straight in front, negative
  81                  # goes left, and positive goes right. The values must define a
  82                  # circular pattern, starting with the back-left at the most
  83                  # negative, around the front to back-center. Unspecified
  84                  # speakers will remain at their default position. Available
  85                  # speakers are front-left(fl) and front-right(fr).
  86                  # The default is:
  87                  # fl=-90, fr=90
  88
  89 layout_QUAD =  # Sets the speaker layout when using quadriphonic output.
  90                # Available speakers are back-left(bl), front-left(fl),
  91                # front-right(fr), and back-right(br).
  92                # The default is:
  93                # bl=-135, fl=-45, fr=45, br=135
  94
  95 layout_51CHN =  # Sets the speaker layout when using 5.1 output. Available
  96                 # speakers are back-left(bl), front-left(fl), front-center(fc),
  97                 # front-right(fr), and back-right(br).
  98                 # The default is:
  99                 # bl=-110, fl=-30, fc=0, fr=30, br=110
 100
 101 layout_61CHN =  # Sets the speaker layout when using 6.1 output. Available
 102                 # speakers are side-left(sl), front-left(fl), front-center(fc),
 103                 # front-right(fr), side-right(sr), and back-center(bc).
 104                 # The default is:
 105                 # sl=-90, fl=-30, fc=0, fr=30, sr=90, bc=180
 106
 107 layout_71CHN =  # Sets the speaker layout when using 7.1 output. Available
 108                 # speakers are back-left(bl), side-left(sl), front-left(fl),
 109                 # front-center(fc), front-right(fr), side-right(sr), and
 110                 # back-right(br).
 111                 # The default is:
 112                 # bl=-150, sl=-90, fl=-30, fc=0, fr=30, sr=90 br=150
 113
 114
 115 [alsa]  # ALSA backend stuff
 116 device = default  # Sets the device name for the default playback device.
 117                   # Default is default
 118
 119 periods = 0  # Sets the number of update buffers for playback. A value of 0
 120              # means auto-select. Default is 0
 121
 122 capture = default  # Sets the device name for the default capture device.
 123                    # Default is default
 124
 125 mmap = true  # Sets whether to try using mmap mode (helps reduce latencies and
 126              # CPU consumption). If mmap isn't available, it will automatically
 127              # fall back to non-mmap mode. True, yes, on, and non-0 values will
 128              # attempt to use mmap. 0 and anything else will force mmap off.
 129              # Default is true.
 130
 131 [oss]  # OSS backend stuff
 132 device = /dev/dsp  # Sets the device name for OSS output. Default is /dev/dsp
 133
 134 periods = 4  # Sets the number of update buffers. Default is 4
 135
 136 capture = /dev/dsp  # Sets the device name for OSS capture. Default is /dev/dsp
 137
 138 [solaris]  # Solaris backend stuff
 139 device = /dev/audio  # Sets the device name for Solaris output. Default is
 140                      # /dev/audio
 141
 142 [dsound]  # DirectSound backend stuff
 143 periods = 4  # Sets the number of updates for the output buffer. Default is 4
 144
 145 [winmm]  # Windows Multimedia backend stuff
 146          # Nothing yet...
 147
 148 [port]  # PortAudio backend stuff
 149 device = -1  # Sets the device index for output. Negative values will use the
 150              # default as given by PortAudio itself. Default is -1
 151
 152 periods = 4  # Sets the number of update buffers. Default is 4
 153
 154 [pulse]  # PulseAudio backend stuff
 155          # Nothing yet...
 156
 157 [wave]  # Wave File Writer stuff
 158 file =  # Sets the filename of the wave file to write to. An empty name
 159         # prevents the backend from opening, even when explicitly requested.
 160         # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
 161         # Default is empty