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.
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:
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
27 cf_level = 0 # Sets the crossfeed level for stereo output. Valid values are:
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.
38 frequency = 44100 # Sets the output frequency. Default is 44100
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.
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
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.
51 # alsa,oss,dsound,winmm,wave
53 [alsa] # ALSA backend stuff
54 device = default # Sets the device name for the default playback device.
57 periods = 0 # Sets the number of update buffers for playback. A value of 0
58 # means auto-select. Default is 0
60 capture = default # Sets the device name for the default capture device.
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.
69 [oss] # OSS backend stuff
70 device = /dev/dsp # Sets the device name for OSS output. Default is /dev/dsp
72 periods = 4 # Sets the number of update buffers. Default is 4
74 capture = /dev/dsp # Sets the device name for OSS capture. Default is /dev/dsp
76 [dsound] # DirectSound backend stuff
79 [winmm] # Windows Multimedia backend stuff
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!