summaryrefslogtreecommitdiffstats
path: root/alsoftrc.sample
blob: 855b862e306bd58665a4d4ccadc8a77fe790865e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
# OpenAL config file. Options that are not under a block or are under the
# [general] block are for general, non-backend-specific options. Blocks may
# appear multiple times, and duplicated options will take the last value
# specified.
# The system-wide settings can be put in /etc/openal/alsoft.conf and user-
# specific override settings in ~/.alsoftrc.
# For Windows, these settings should go into %AppData%\alsoft.ini
# The environment variable ALSOFT_CONF can be used to specify another config
# override

# Option and block names are case-insenstive. The supplied values are only
# hints and may not be honored (though generally it'll try to get as close as
# possible). These are the current available settings:

format = AL_FORMAT_STEREO16  # Sets the output format. Can be one of:
                             # AL_FORMAT_MONO8    (8-bit mono)
                             # AL_FORMAT_STEREO8  (8-bit stereo)
                             # AL_FORMAT_QUAD8    (8-bit 4-channel)
                             # AL_FORMAT_51CHN8   (8-bit 5.1 output)
                             # AL_FORMAT_61CHN8   (8-bit 6.1 output)
                             # AL_FORMAT_71CHN8   (8-bit 7.1 output)
                             # AL_FORMAT_MONO16   (16-bit mono)
                             # AL_FORMAT_STEREO16 (16-bit stereo)
                             # AL_FORMAT_QUAD16   (16-bit 4-channel)
                             # AL_FORMAT_51CHN16  (16-bit 5.1 output)
                             # AL_FORMAT_61CHN16  (16-bit 6.1 output)
                             # AL_FORMAT_71CHN16  (16-bit 7.1 output)
                             # Default is AL_FORMAT_STEREO16

cf_level = 0  # Sets the crossfeed level for stereo output. Valid values are:
              # 0 - No crossfeed
              # 1 - Low crossfeed
              # 2 - Middle crossfeed
              # 3 - High crossfeed (virtual speakers are closer to itself)
              # 4 - Low easy crossfeed
              # 5 - Middle easy crossfeed
              # 6 - High easy crossfeed
              # Default is 0. Users of headphones may want to try various
              # settings. Has no effect on non-stereo modes.

frequency = 44100  # Sets the output frequency. Default is 44100

refresh = 4096  # Sets the buffer size, in frames. Default is 4096. Note that
                # the actual granularity may or may not be less than this.

sources = 256  # Sets the maximum number of allocatable sources. Lower values
               # may help for systems with apps that try to play more sounds
               # than the CPU can handle. Default is 256

stereodup =  # Sets whether to duplicate stereo sounds on the rear and side
             # speakers for 4+ channel output. This can make stereo sources
             # substantially louder than mono or even 4+ channel sources, but
             # provides a "fuller" playback quality. True, yes, on, and non-0
             # values will duplicate stereo sources. 0 and anything else will
             # cause stereo sounds to only play out the front speakers.
             # Default is false

drivers =  # Sets the backend driver list order, comma-seperated. Unknown
           # backends and duplicated names are ignored, and unlisted backends
           # won't be considered for use. An empty list means the default.
           # Default is:
           # alsa,oss,solaris,dsound,winmm,port,wave

excludefx =  # Sets which effects to exclude, preventing apps from using them.
             # This can help for apps that try to use effects which are too CPU
             # intensive for the system to handle. Available effects are:
             # reverb,echo
             # Default is empty (all available effects enabled)

slots = 4  # Sets the maximum number of Auxiliary Effect Slots an app can
           # create. A slot can use a non-negligible amount of CPU time if an
           # effect is set on it even if no sources are feeding it, so this may
           # help when apps use more than the system can handle. Default is 4

layout_STEREO =  # Sets the speaker layout when using stereo output. Values are
                 # specified in degrees, where 0 is straight in front, negative
                 # goes left, and positive goes right. The values must define a
                 # circular pattern, starting with the back-left at the most
                 # negative, around the front to back-center. Unspecified
                 # speakers will remain at their default position. Available
                 # speakers are front-left(fl) and front-right(fr).
                 # The default is:
                 # fl=-90, fr=90

layout_QUAD =  # Sets the speaker layout when using quadriphonic output.
               # Available speakers are back-left(bl), front-left(fl),
               # front-right(fr), and back-right(br).
               # The default is:
               # bl=-135, fl=-45, fr=45, br=135

layout_51CHN =  # Sets the speaker layout when using 5.1 output. Available
                # speakers are back-left(bl), front-left(fl), front-center(fc),
                # front-right(fr), and back-right(br).
                # The default is:
                # bl=-110, fl=-30, fc=0, fr=30, br=110

layout_61CHN =  # Sets the speaker layout when using 6.1 output. Available
                # speakers are side-left(sl), front-left(fl), front-center(fc),
                # front-right(fr), side-right(sr), and back-center(bc).
                # The default is:
                # sl=-90, fl=-30, fc=0, fr=30, sr=90, bc=180

layout_71CHN =  # Sets the speaker layout when using 7.1 output. Available
                # speakers are back-left(bl), side-left(sl), front-left(fl),
                # front-center(fc), front-right(fr), side-right(sr), and
                # back-right(br).
                # The default is:
                # bl=-150, sl=-90, fl=-30, fc=0, fr=30, sr=90 br=150


[alsa]  # ALSA backend stuff
device = default  # Sets the device name for the default playback device.
                  # Default is default

periods = 0  # Sets the number of update buffers for playback. A value of 0
             # means auto-select. Default is 0

capture = default  # Sets the device name for the default capture device.
                   # Default is default

mmap = true  # Sets whether to try using mmap mode (helps reduce latencies and
             # CPU consumption). If mmap isn't available, it will automatically
             # fall back to non-mmap mode. True, yes, on, and non-0 values will
             # attempt to use mmap. 0 and anything else will force mmap off.
             # Default is true.

[oss]  # OSS backend stuff
device = /dev/dsp  # Sets the device name for OSS output. Default is /dev/dsp

periods = 4  # Sets the number of update buffers. Default is 4

capture = /dev/dsp  # Sets the device name for OSS capture. Default is /dev/dsp

[solaris]  # Solaris backend stuff
device = /dev/audio  # Sets the device name for Solaris output. Default is
                     # /dev/audio

[dsound]  # DirectSound backend stuff
periods = 4  # Sets the number of updates for the output buffer. Default is 4

[winmm]  # Windows Multimedia backend stuff
         # Nothing yet...

[port]  # PortAudio backend stuff
device = -1  # Sets the device index for output. Negative values will use the
             # default as given by PortAudio itself. Default is -1

periods = 4  # Sets the number of update buffers. Default is 4

[wave]  # Wave File Writer stuff
file =  # Sets the filename of the wave file to write to. An empty name
        # prevents the backend from opening, even when explicitly requested.
        # THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION!
        # Default is empty