diff options
Diffstat (limited to 'DOCS/man/ao.rst')
-rw-r--r-- | DOCS/man/ao.rst | 36 |
1 files changed, 27 insertions, 9 deletions
diff --git a/DOCS/man/ao.rst b/DOCS/man/ao.rst index cc42ec23a6..69ee4da498 100644 --- a/DOCS/man/ao.rst +++ b/DOCS/man/ao.rst @@ -14,7 +14,7 @@ in the list. See ``--ao=help`` for a list of compiled-in audio output drivers. The driver ``--ao=alsa`` is preferred. ``--ao=pulse`` is preferred on systems - where PulseAudio is used. + where PulseAudio is used. On BSD systems, ``--ao=oss`` is preferred. Available audio output drivers are: @@ -35,6 +35,9 @@ Available audio output drivers are: with automatic upmixing with shared access, so playing stereo and multichannel audio at the same time will work as expected. +``oss`` + OSS audio output driver + ``jack`` JACK (Jack Audio Connection Kit) audio output driver. @@ -65,8 +68,8 @@ Available audio output drivers are: mode is probably not very useful, other than for debugging or when used with fixed setups. -``coreaudio`` (Mac OS X only) - Native Mac OS X audio output driver using AudioUnits and the CoreAudio +``coreaudio`` (macOS only) + Native macOS audio output driver using AudioUnits and the CoreAudio sound server. Automatically redirects to ``coreaudio_exclusive`` when playing compressed @@ -92,12 +95,12 @@ Available audio output drivers are: extreme care. -``coreaudio_exclusive`` (Mac OS X only) - Native Mac OS X audio output driver using direct device access and +``coreaudio_exclusive`` (macOS only) + Native macOS audio output driver using direct device access and exclusive mode (bypasses the sound server). ``openal`` - OpenAL audio output driver. This is broken and does not work. + OpenAL audio output driver. ``--openal-num-buffers=<2-128>`` Specify the number of audio buffers to use. Lower values are better for @@ -109,9 +112,7 @@ Available audio output drivers are: ``--openal-direct-channels=<yes|no>`` Enable OpenAL Soft's direct channel extension when available to avoid - tinting the sound with ambisonics or HRTF. - Channels are dropped when when they are not available as downmixing - will be disabled. Default: no. + tinting the sound with ambisonics or HRTF. Default: yes. ``pulse`` PulseAudio audio output driver @@ -143,6 +144,17 @@ Available audio output drivers are: Allow mpv to use PulseAudio even if the sink is suspended (default: no). Can be useful if PulseAudio is running as a bridge to jack and mpv has its sink-input set to the one jack is using. +``pipewire`` + PipeWire audio output driver + + The following global options are supported by this audio output: + + ``--pipewire-buffer=<1-2000|native>`` + Set the audio buffer size in milliseconds. A higher value buffers + more data, and has a lower probability of buffer underruns. A smaller + value makes the audio stream react faster, e.g. to playback speed + changes. + ``sdl`` SDL 1.2+ audio output driver. Should work on any platform supported by SDL 1.2, but may require the ``SDL_AUDIODRIVER`` environment variable to be set @@ -216,5 +228,11 @@ Available audio output drivers are: ``no-waveheader`` option - with ``waveheader`` it's broken, because it will write a WAVE header every time the file is opened. +``sndio`` + Audio output to the OpenBSD sndio sound system + + (Note: only supports mono, stereo, 4.0, 5.1 and 7.1 channel + layouts.) + ``wasapi`` Audio output to the Windows Audio Session API. |