summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorThomas Weißschuh <thomas@t-8ch.de>2022-01-06 21:54:21 +0100
committerPhilip Langdale <github.philipl@overt.org>2022-01-17 11:43:02 -0800
commit87aba146eddd2bc3fe8819180e2814e7947ff1f2 (patch)
treef70d9220675e53e22e128127dd682baa0895771a /DOCS
parent1ba0547bfbe08b6b0a84760730d4ddaeea9f1d0d (diff)
downloadmpv-87aba146eddd2bc3fe8819180e2814e7947ff1f2.tar.bz2
mpv-87aba146eddd2bc3fe8819180e2814e7947ff1f2.tar.xz
ao_pipewire: Add PipeWire audio backend
The AO provides a way for mpv to directly submit audio to the PipeWire audio server. Doing this directly instead of going through the various compatibility layers provided by PipeWire has the following advantages: * It reduces complexity of going through the compatibility layers * It allows a richer integration between mpv and PipeWire (for example for metadata) * Some users report issues with the compatibility layers that to not occur with the native AO For now the AO is ordered after all the other relevant AOs, so it will most probably not be picked up by default. This is for the following reasons: * Currently it is not possible to detect if the PipeWire daemon that mpv connects to is actually driving the system audio. (https://gitlab.freedesktop.org/pipewire/pipewire/-/issues/1835) * It gives the AO time to stabilize before it is used by everyone. Based-on-patch-by: Oschowa <oschowa@web.de> Based-on-patch-by: Andreas Kempf <aakempf@gmail.com> Helped-by: Ivan <etircopyhdot@gmail.com>
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/ao.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/DOCS/man/ao.rst b/DOCS/man/ao.rst
index cc4cea0036..91ddb49067 100644
--- a/DOCS/man/ao.rst
+++ b/DOCS/man/ao.rst
@@ -144,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