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
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
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:
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
30 cf_level = 0 # Sets the crossfeed level for stereo output. Valid values are:
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.
41 frequency = 44100 # Sets the output frequency. Default is 44100
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.
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
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.
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.
62 # alsa,oss,solaris,dsound,winmm,port,pulse,wave
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:
68 # Default is empty (all available effects enabled)
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
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
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).
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).
93 # bl=-135, fl=-45, fr=45, br=135
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).
99 # bl=-110, fl=-30, fc=0, fr=30, br=110
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).
105 # sl=-90, fl=-30, fc=0, fr=30, sr=90, bc=180
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
112 # bl=-150, sl=-90, fl=-30, fc=0, fr=30, sr=90 br=150
115 [alsa] # ALSA backend stuff
116 device = default # Sets the device name for the default playback device.
119 periods = 0 # Sets the number of update buffers for playback. A value of 0
120 # means auto-select. Default is 0
122 capture = default # Sets the device name for the default capture device.
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.
131 [oss] # OSS backend stuff
132 device = /dev/dsp # Sets the device name for OSS output. Default is /dev/dsp
134 periods = 4 # Sets the number of update buffers. Default is 4
136 capture = /dev/dsp # Sets the device name for OSS capture. Default is /dev/dsp
138 [solaris] # Solaris backend stuff
139 device = /dev/audio # Sets the device name for Solaris output. Default is
142 [dsound] # DirectSound backend stuff
143 periods = 4 # Sets the number of updates for the output buffer. Default is 4
145 [winmm] # Windows Multimedia backend stuff
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
152 periods = 4 # Sets the number of update buffers. Default is 4
154 [pulse] # PulseAudio backend stuff
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!