summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2015-10-05 18:53:02 +0200
committerwm4 <wm4@nowhere>2015-10-05 19:12:23 +0200
commit54fbda2ba40de1d94d49cef2c46160eb7ffa195a (patch)
tree0749d3a757f8abee199222bf08f802b2a7c2a4f1 /DOCS
parente694d6736699d385772a3942aad52bba4bb7caf9 (diff)
downloadmpv-54fbda2ba40de1d94d49cef2c46160eb7ffa195a.tar.bz2
mpv-54fbda2ba40de1d94d49cef2c46160eb7ffa195a.tar.xz
audio: add option for falling back to ao_null
The manpage entry explains this. (Maybe this option could be always enabled and removed. I don't quite remember what valid use-cases there are for just disabling audio entirely, other than that this is also needed for audio decoder init failure.)
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst1
-rw-r--r--DOCS/man/options.rst8
2 files changed, 9 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 2bdf8e25d9..6efd5a5105 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -20,6 +20,7 @@ Interface changes
::
--- mpv 0.12.0 ---
+ - add --audio-fallback-to-null option
- replace vf_format outputlevels suboption with "video-output-levels" global
property/option; also remove "colormatrix-output-range" property
- vo_opengl: remove sharpen3/sharpen5 scale filters, add sharpen sub-option
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 783fe665e0..2d11020be1 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -917,6 +917,14 @@ Audio
Currently not implemented for most AOs.
+``--audio-fallback-to-null=<yes|no>``
+ If no audio device can be opened, behave as if ``--ao=null`` was given. This
+ is useful in combination with ``--audio-device``: instead of causing an
+ error if the selected device does not exist, the client API user (or a
+ Lua script) could let playback continue normally, and check the
+ ``current-ao`` and ``audio-device-list`` properties to make high-level
+ decisions about how to continue.
+
``--ao=<driver1[:suboption1[=value]:...],driver2,...[,]>``
Specify a priority list of audio output drivers to be used. For
interactive use one would normally specify a single one to use, but in