1# OpenAL config file. 2# 3# Option blocks may appear multiple times, and duplicated options will take the 4# last value specified. Environment variables may be specified within option 5# values, and are automatically substituted when the config file is loaded. 6# Environment variable names may only contain alpha-numeric characters (a-z, 7# A-Z, 0-9) and underscores (_), and are prefixed with $. For example, 8# specifying "$HOME/file.ext" would typically result in something like 9# "/home/user/file.ext". To specify an actual "$" character, use "$$". 10# 11# Device-specific values may be specified by including the device name in the 12# block name, with "general" replaced by the device name. That is, general 13# options for the device "Name of Device" would be in the [Name of Device] 14# block, while ALSA options would be in the [alsa/Name of Device] block. 15# Options marked as "(global)" are not influenced by the device. 16# 17# The system-wide settings can be put in /etc/openal/alsoft.conf and user- 18# specific override settings in $HOME/.alsoftrc. 19# For Windows, these settings should go into $AppData\alsoft.ini 20# 21# Option and block names are case-senstive. The supplied values are only hints 22# and may not be honored (though generally it'll try to get as close as 23# possible). Note: options that are left unset may default to app- or system- 24# specified values. These are the current available settings: 25 26## 27## General stuff 28## 29[general] 30 31## disable-cpu-exts: (global) 32# Disables use of specialized methods that use specific CPU intrinsics. 33# Certain methods may utilize CPU extensions for improved performance, and 34# this option is useful for preventing some or all of those methods from being 35# used. The available extensions are: sse, sse2, sse3, sse4.1, and neon. 36# Specifying 'all' disables use of all such specialized methods. 37#disable-cpu-exts = 38 39## drivers: (global) 40# Sets the backend driver list order, comma-seperated. Unknown backends and 41# duplicated names are ignored. Unlisted backends won't be considered for use 42# unless the list is ended with a comma (e.g. 'oss,' will try OSS first before 43# other backends, while 'oss' will try OSS only). Backends prepended with - 44# won't be considered for use (e.g. '-oss,' will try all available backends 45# except OSS). An empty list means to try all backends. 46#drivers = 47 48## channels: 49# Sets the output channel configuration. If left unspecified, one will try to 50# be detected from the system, and defaulting to stereo. The available values 51# are: mono, stereo, quad, surround51, surround51rear, surround61, surround71, 52# ambi1, ambi2, ambi3. Note that the ambi* configurations provide ambisonic 53# channels of the given order (using ACN ordering and SN3D normalization by 54# default), which need to be decoded to play correctly on speakers. 55#channels = 56 57## sample-type: 58# Sets the output sample type. Currently, all mixing is done with 32-bit float 59# and converted to the output sample type as needed. Available values are: 60# int8 - signed 8-bit int 61# uint8 - unsigned 8-bit int 62# int16 - signed 16-bit int 63# uint16 - unsigned 16-bit int 64# int32 - signed 32-bit int 65# uint32 - unsigned 32-bit int 66# float32 - 32-bit float 67#sample-type = float32 68 69## frequency: 70# Sets the output frequency. If left unspecified it will try to detect a 71# default from the system, otherwise it will default to 44100. 72#frequency = 73 74## period_size: 75# Sets the update period size, in sample frames. This is the number of frames 76# needed for each mixing update. Acceptable values range between 64 and 8192. 77# If left unspecified it will default to 1/50th of the frequency (20ms, or 882 78# for 44100, 960 for 48000, etc). 79#period_size = 80 81## periods: 82# Sets the number of update periods. Higher values create a larger mix ahead, 83# which helps protect against skips when the CPU is under load, but increases 84# the delay between a sound getting mixed and being heard. Acceptable values 85# range between 2 and 16. 86#periods = 3 87 88## stereo-mode: 89# Specifies if stereo output is treated as being headphones or speakers. With 90# headphones, HRTF or crossfeed filters may be used for better audio quality. 91# Valid settings are auto, speakers, and headphones. 92#stereo-mode = auto 93 94## stereo-encoding: 95# Specifies the encoding method for non-HRTF stereo output. 'panpot' (default) 96# uses standard amplitude panning (aka pair-wise, stereo pair, etc) between 97# -30 and +30 degrees, while 'uhj' creates stereo-compatible two-channel UHJ 98# output, which encodes some surround sound information into stereo output 99# that can be decoded with a surround sound receiver. If crossfeed filters are 100# used, UHJ is disabled. 101#stereo-encoding = panpot 102 103## ambi-format: 104# Specifies the channel order and normalization for the "ambi*" set of channel 105# configurations. Valid settings are: fuma, ambix (or acn+sn3d), acn+n3d 106#ambi-format = ambix 107 108## hrtf: 109# Controls HRTF processing. These filters provide better spatialization of 110# sounds while using headphones, but do require a bit more CPU power. While 111# HRTF is used, the cf_level option is ignored. Setting this to auto (default) 112# will allow HRTF to be used when headphones are detected or the app requests 113# it, while setting true or false will forcefully enable or disable HRTF 114# respectively. 115#hrtf = auto 116 117## hrtf-mode: 118# Specifies the rendering mode for HRTF processing. Setting the mode to full 119# (default) applies a unique HRIR filter to each source given its relative 120# location, providing the clearest directional response at the cost of the 121# highest CPU usage. Setting the mode to ambi1, ambi2, or ambi3 will instead 122# mix to a first-, second-, or third-order ambisonic buffer respectively, then 123# decode that buffer with HRTF filters. Ambi1 has the lowest CPU usage, 124# replacing the per-source HRIR filter for a simple 4-channel panning mix, but 125# retains full 3D placement at the cost of a more diffuse response. Ambi2 and 126# ambi3 increasingly improve the directional clarity, at the cost of more CPU 127# usage (still less than "full", given some number of active sources). 128#hrtf-mode = full 129 130## hrtf-size: 131# Specifies the impulse response size, in samples, for the HRTF filter. Larger 132# values increase the filter quality, while smaller values reduce processing 133# cost. A value of 0 (default) uses the full filter size in the dataset, and 134# the default dataset has a filter size of 32 samples at 44.1khz. 135#hrtf-size = 0 136 137## default-hrtf: 138# Specifies the default HRTF to use. When multiple HRTFs are available, this 139# determines the preferred one to use if none are specifically requested. Note 140# that this is the enumerated HRTF name, not necessarily the filename. 141#default-hrtf = 142 143## hrtf-paths: 144# Specifies a comma-separated list of paths containing HRTF data sets. The 145# format of the files are described in docs/hrtf.txt. The files within the 146# directories must have the .mhr file extension to be recognized. By default, 147# OS-dependent data paths will be used. They will also be used if the list 148# ends with a comma. On Windows this is: 149# $AppData\openal\hrtf 150# And on other systems, it's (in order): 151# $XDG_DATA_HOME/openal/hrtf (defaults to $HOME/.local/share/openal/hrtf) 152# $XDG_DATA_DIRS/openal/hrtf (defaults to /usr/local/share/openal/hrtf and 153# /usr/share/openal/hrtf) 154#hrtf-paths = 155 156## cf_level: 157# Sets the crossfeed level for stereo output. Valid values are: 158# 0 - No crossfeed 159# 1 - Low crossfeed 160# 2 - Middle crossfeed 161# 3 - High crossfeed (virtual speakers are closer to itself) 162# 4 - Low easy crossfeed 163# 5 - Middle easy crossfeed 164# 6 - High easy crossfeed 165# Users of headphones may want to try various settings. Has no effect on non- 166# stereo modes. 167#cf_level = 0 168 169## resampler: (global) 170# Selects the default resampler used when mixing sources. Valid values are: 171# point - nearest sample, no interpolation 172# linear - extrapolates samples using a linear slope between samples 173# cubic - extrapolates samples using a Catmull-Rom spline 174# bsinc12 - extrapolates samples using a band-limited Sinc filter (varying 175# between 12 and 24 points, with anti-aliasing) 176# fast_bsinc12 - same as bsinc12, except without interpolation between down- 177# sampling scales 178# bsinc24 - extrapolates samples using a band-limited Sinc filter (varying 179# between 24 and 48 points, with anti-aliasing) 180# fast_bsinc24 - same as bsinc24, except without interpolation between down- 181# sampling scales 182#resampler = linear 183 184## rt-prio: (global) 185# Sets real-time priority for the mixing thread. Not all drivers may use this 186# (eg. PortAudio) as they already control the priority of the mixing thread. 187# 0 and negative values will disable it. Note that this may constitute a 188# security risk since a real-time priority thread can indefinitely block 189# normal-priority threads if it fails to wait. Disable this if it turns out to 190# be a problem. 191#rt-prio = 1 192 193## sources: 194# Sets the maximum number of allocatable sources. Lower values may help for 195# systems with apps that try to play more sounds than the CPU can handle. 196#sources = 256 197 198## slots: 199# Sets the maximum number of Auxiliary Effect Slots an app can create. A slot 200# can use a non-negligible amount of CPU time if an effect is set on it even 201# if no sources are feeding it, so this may help when apps use more than the 202# system can handle. 203#slots = 64 204 205## sends: 206# Limits the number of auxiliary sends allowed per source. Setting this higher 207# than the default has no effect. 208#sends = 6 209 210## front-stablizer: 211# Applies filters to "stablize" front sound imaging. A psychoacoustic method 212# is used to generate a front-center channel signal from the front-left and 213# front-right channels, improving the front response by reducing the combing 214# artifacts and phase errors. Consequently, it will only work with channel 215# configurations that include front-left, front-right, and front-center. 216#front-stablizer = false 217 218## output-limiter: 219# Applies a gain limiter on the final mixed output. This reduces the volume 220# when the output samples would otherwise clamp, avoiding excessive clipping 221# noise. 222#output-limiter = true 223 224## dither: 225# Applies dithering on the final mix, for 8- and 16-bit output by default. 226# This replaces the distortion created by nearest-value quantization with low- 227# level whitenoise. 228#dither = true 229 230## dither-depth: 231# Quantization bit-depth for dithered output. A value of 0 (or less) will 232# match the output sample depth. For int32, uint32, and float32 output, 0 will 233# disable dithering because they're at or beyond the rendered precision. The 234# maximum dither depth is 24. 235#dither-depth = 0 236 237## volume-adjust: 238# A global volume adjustment for source output, expressed in decibels. The 239# value is logarithmic, so +6 will be a scale of (approximately) 2x, +12 will 240# be a scale of 4x, etc. Similarly, -6 will be x1/2, and -12 is about x1/4. A 241# value of 0 means no change. 242#volume-adjust = 0 243 244## excludefx: (global) 245# Sets which effects to exclude, preventing apps from using them. This can 246# help for apps that try to use effects which are too CPU intensive for the 247# system to handle. Available effects are: eaxreverb,reverb,autowah,chorus, 248# compressor,distortion,echo,equalizer,flanger,modulator,dedicated,pshifter, 249# fshifter,vmorpher. 250#excludefx = 251 252## default-reverb: (global) 253# A reverb preset that applies by default to all sources on send 0 254# (applications that set their own slots on send 0 will override this). 255# Available presets are: None, Generic, PaddedCell, Room, Bathroom, 256# Livingroom, Stoneroom, Auditorium, ConcertHall, Cave, Arena, Hangar, 257# CarpetedHallway, Hallway, StoneCorridor, Alley, Forest, City, Moutains, 258# Quarry, Plain, ParkingLot, SewerPipe, Underwater, Drugged, Dizzy, Psychotic. 259#default-reverb = 260 261## trap-alc-error: (global) 262# Generates a SIGTRAP signal when an ALC device error is generated, on systems 263# that support it. This helps when debugging, while trying to find the cause 264# of a device error. On Windows, a breakpoint exception is generated. 265#trap-alc-error = false 266 267## trap-al-error: (global) 268# Generates a SIGTRAP signal when an AL context error is generated, on systems 269# that support it. This helps when debugging, while trying to find the cause 270# of a context error. On Windows, a breakpoint exception is generated. 271#trap-al-error = false 272 273## 274## Ambisonic decoder stuff 275## 276[decoder] 277 278## hq-mode: 279# Enables a high-quality ambisonic decoder. This mode is capable of frequency- 280# dependent processing, creating a better reproduction of 3D sound rendering 281# over surround sound speakers. Enabling this also requires specifying decoder 282# configuration files for the appropriate speaker configuration you intend to 283# use (see the quad, surround51, etc options below). Currently, up to third- 284# order decoding is supported. 285#hq-mode = true 286 287## distance-comp: 288# Enables compensation for the speakers' relative distances to the listener. 289# This applies the necessary delays and attenuation to make the speakers 290# behave as though they are all equidistant, which is important for proper 291# playback of 3D sound rendering. Requires the proper distances to be 292# specified in the decoder configuration file. 293#distance-comp = true 294 295## nfc: 296# Enables near-field control filters. This simulates and compensates for low- 297# frequency effects caused by the curvature of nearby sound-waves, which 298# creates a more realistic perception of sound distance. Note that the effect 299# may be stronger or weaker than intended if the application doesn't use or 300# specify an appropriate unit scale, or if incorrect speaker distances are set 301# in the decoder configuration file. 302#nfc = false 303 304## nfc-ref-delay 305# Specifies the reference delay value for ambisonic output when NFC filters 306# are enabled. If channels is set to one of the ambi* formats, this option 307# enables NFC-HOA output with the specified Reference Delay parameter. The 308# specified value can then be shared with an appropriate NFC-HOA decoder to 309# reproduce correct near-field effects. Keep in mind that despite being 310# designed for higher-order ambisonics, this also applies to first-order 311# output. When left unset, normal output is created with no near-field 312# simulation. Requires the nfc option to also be enabled. 313#nfc-ref-delay = 314 315## quad: 316# Decoder configuration file for Quadraphonic channel output. See 317# docs/ambdec.txt for a description of the file format. 318#quad = 319 320## surround51: 321# Decoder configuration file for 5.1 Surround (Side and Rear) channel output. 322# See docs/ambdec.txt for a description of the file format. 323#surround51 = 324 325## surround61: 326# Decoder configuration file for 6.1 Surround channel output. See 327# docs/ambdec.txt for a description of the file format. 328#surround61 = 329 330## surround71: 331# Decoder configuration file for 7.1 Surround channel output. See 332# docs/ambdec.txt for a description of the file format. Note: This can be used 333# to enable 3D7.1 with the appropriate configuration and speaker placement, 334# see docs/3D7.1.txt. 335#surround71 = 336 337## 338## Reverb effect stuff (includes EAX reverb) 339## 340[reverb] 341 342## boost: (global) 343# A global amplification for reverb output, expressed in decibels. The value 344# is logarithmic, so +6 will be a scale of (approximately) 2x, +12 will be a 345# scale of 4x, etc. Similarly, -6 will be about half, and -12 about 1/4th. A 346# value of 0 means no change. 347#boost = 0 348 349## 350## PulseAudio backend stuff 351## 352[pulse] 353 354## spawn-server: (global) 355# Attempts to autospawn a PulseAudio server whenever needed (initializing the 356# backend, enumerating devices, etc). Setting autospawn to false in Pulse's 357# client.conf will still prevent autospawning even if this is set to true. 358#spawn-server = true 359 360## allow-moves: (global) 361# Allows PulseAudio to move active streams to different devices. Note that the 362# device specifier (seen by applications) will not be updated when this 363# occurs, and neither will the AL device configuration (sample rate, format, 364# etc). 365#allow-moves = true 366 367## fix-rate: 368# Specifies whether to match the playback stream's sample rate to the device's 369# sample rate. Enabling this forces OpenAL Soft to mix sources and effects 370# directly to the actual output rate, avoiding a second resample pass by the 371# PulseAudio server. 372#fix-rate = false 373 374## adjust-latency: 375# Attempts to adjust the overall latency of device playback. Note that this 376# may have adverse effects on the resulting internal buffer sizes and mixing 377# updates, leading to performance problems and drop-outs. However, if the 378# PulseAudio server is creating a lot of latency, enabling this may help make 379# it more manageable. 380#adjust-latency = false 381 382## 383## ALSA backend stuff 384## 385[alsa] 386 387## device: (global) 388# Sets the device name for the default playback device. 389#device = default 390 391## device-prefix: (global) 392# Sets the prefix used by the discovered (non-default) playback devices. This 393# will be appended with "CARD=c,DEV=d", where c is the card id and d is the 394# device index for the requested device name. 395#device-prefix = plughw: 396 397## device-prefix-*: (global) 398# Card- and device-specific prefixes may be used to override the device-prefix 399# option. The option may specify the card id (eg, device-prefix-NVidia), or 400# the card id and device index (eg, device-prefix-NVidia-0). The card id is 401# case-sensitive. 402#device-prefix- = 403 404## custom-devices: (global) 405# Specifies a list of enumerated playback devices and the ALSA devices they 406# refer to. The list pattern is "Display Name=ALSA device;...". The display 407# names will be returned for device enumeration, and the ALSA device is the 408# device name to open for each enumerated device. 409#custom-devices = 410 411## capture: (global) 412# Sets the device name for the default capture device. 413#capture = default 414 415## capture-prefix: (global) 416# Sets the prefix used by the discovered (non-default) capture devices. This 417# will be appended with "CARD=c,DEV=d", where c is the card id and d is the 418# device number for the requested device name. 419#capture-prefix = plughw: 420 421## capture-prefix-*: (global) 422# Card- and device-specific prefixes may be used to override the 423# capture-prefix option. The option may specify the card id (eg, 424# capture-prefix-NVidia), or the card id and device index (eg, 425# capture-prefix-NVidia-0). The card id is case-sensitive. 426#capture-prefix- = 427 428## custom-captures: (global) 429# Specifies a list of enumerated capture devices and the ALSA devices they 430# refer to. The list pattern is "Display Name=ALSA device;...". The display 431# names will be returned for device enumeration, and the ALSA device is the 432# device name to open for each enumerated device. 433#custom-captures = 434 435## mmap: 436# Sets whether to try using mmap mode (helps reduce latencies and CPU 437# consumption). If mmap isn't available, it will automatically fall back to 438# non-mmap mode. True, yes, on, and non-0 values will attempt to use mmap. 0 439# and anything else will force mmap off. 440#mmap = true 441 442## allow-resampler: 443# Specifies whether to allow ALSA's built-in resampler. Enabling this will 444# allow the playback device to be set to a different sample rate than the 445# actual output, causing ALSA to apply its own resampling pass after OpenAL 446# Soft resamples and mixes the sources and effects for output. 447#allow-resampler = false 448 449## 450## OSS backend stuff 451## 452[oss] 453 454## device: (global) 455# Sets the device name for OSS output. 456#device = /dev/dsp 457 458## capture: (global) 459# Sets the device name for OSS capture. 460#capture = /dev/dsp 461 462## 463## Solaris backend stuff 464## 465[solaris] 466 467## device: (global) 468# Sets the device name for Solaris output. 469#device = /dev/audio 470 471## 472## QSA backend stuff 473## 474[qsa] 475 476## 477## JACK backend stuff 478## 479[jack] 480 481## spawn-server: (global) 482# Attempts to autospawn a JACK server whenever needed (initializing the 483# backend, opening devices, etc). 484#spawn-server = false 485 486## custom-devices: (global) 487# Specifies a list of enumerated devices and the ports they connect to. The 488# list pattern is "Display Name=ports regex;Display Name=ports regex;...". The 489# display names will be returned for device enumeration, and the ports regex 490# is the regular expression to identify the target ports on the server (as 491# given by the jack_get_ports function) for each enumerated device. 492#custom-devices = 493 494## connect-ports: 495# Attempts to automatically connect the client ports to physical server ports. 496# Client ports that fail to connect will leave the remaining channels 497# unconnected and silent (the device format won't change to accommodate). 498#connect-ports = true 499 500## buffer-size: 501# Sets the update buffer size, in samples, that the backend will keep buffered 502# to handle the server's real-time processing requests. This value must be a 503# power of 2, or else it will be rounded up to the next power of 2. If it is 504# less than JACK's buffer update size, it will be clamped. This option may 505# be useful in case the server's update size is too small and doesn't give the 506# mixer time to keep enough audio available for the processing requests. 507#buffer-size = 0 508 509## 510## WASAPI backend stuff 511## 512[wasapi] 513 514## 515## DirectSound backend stuff 516## 517[dsound] 518 519## 520## Windows Multimedia backend stuff 521## 522[winmm] 523 524## 525## PortAudio backend stuff 526## 527[port] 528 529## device: (global) 530# Sets the device index for output. Negative values will use the default as 531# given by PortAudio itself. 532#device = -1 533 534## capture: (global) 535# Sets the device index for capture. Negative values will use the default as 536# given by PortAudio itself. 537#capture = -1 538 539## 540## Wave File Writer stuff 541## 542[wave] 543 544## file: (global) 545# Sets the filename of the wave file to write to. An empty name prevents the 546# backend from opening, even when explicitly requested. 547# THIS WILL OVERWRITE EXISTING FILES WITHOUT QUESTION! 548#file = 549 550## bformat: (global) 551# Creates AMB format files using first-order ambisonics instead of a standard 552# single- or multi-channel .wav file. 553#bformat = false 554