Clarify OpenAL backend selection

This commit is contained in:
Brandon McGinty (chatgpt)
2026-08-09 12:58:00 -04:00
committed by Brandon McGinty
parent e1d8cad061
commit 5db174e92f
+2 -2
View File
@@ -149,7 +149,7 @@ To clear your inputdevice or outputdevice options and set them to defaults, set
### Audio Backends (ALSA, PipeWire, PulseAudio) ### Audio Backends (ALSA, PipeWire, PulseAudio)
Barnard uses OpenAL Soft for audio. By default it will pick the first available backend (often ALSA), but you can force a specific driver: Barnard uses OpenAL Soft for audio. The default backend order is determined by the installed OpenAL Soft build and its configuration; it is not guaranteed to prefer PipeWire or PulseAudio. You can force a specific driver:
- Command line: `./barnard --audio-driver pipewire` (or `pulse`, `alsa`, `jack`) - Command line: `./barnard --audio-driver pipewire` (or `pulse`, `alsa`, `jack`)
- Config file: add `audiodriver = "pipewire"` to your `~/.barnard.toml` - Config file: add `audiodriver = "pipewire"` to your `~/.barnard.toml`
@@ -157,7 +157,7 @@ Barnard uses OpenAL Soft for audio. By default it will pick the first available
If PipeWire or PulseAudio support is missing, install OpenAL Soft with the corresponding backend enabled (e.g., `libopenal1` or `openal-soft` packages built with PipeWire). After changing drivers, rerun with `--list_devices` to confirm the desired devices appear. If PipeWire or PulseAudio support is missing, install OpenAL Soft with the corresponding backend enabled (e.g., `libopenal1` or `openal-soft` packages built with PipeWire). After changing drivers, rerun with `--list_devices` to confirm the desired devices appear.
Leaving `audiodriver` empty in the config keeps the OpenAL default ordering (PipeWire/Pulse first if available, then ALSA). Leaving `audiodriver` empty uses the OpenAL Soft default ordering from the installed library.
## Keystrokes ## Keystrokes