summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst2
-rw-r--r--DOCS/man/af.rst3
-rw-r--r--DOCS/man/options.rst20
3 files changed, 25 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 464435bcbe..aadbf159d0 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -22,6 +22,8 @@ Interface changes
--- mpv 0.26.0 ---
- remove remaining deprecated audio device options, like --alsa-device
Some of them were removed in earlier releases.
+ - introduce --replaygain... options, which replace the same functionality
+ provided by the deprecated --af=volume:replaygain... mechanism.
--- mpv 0.25.0 ---
- remove opengl-cb dxva2 dummy hwdec interop
(see git "vo_opengl: remove dxva2 dummy hwdec backend")
diff --git a/DOCS/man/af.rst b/DOCS/man/af.rst
index 9dff18ebbe..bc25a9f7b3 100644
--- a/DOCS/man/af.rst
+++ b/DOCS/man/af.rst
@@ -208,6 +208,9 @@ Available filters are:
best to use the *Master* volume control of your sound card or the volume
knob on your amplifier.
+ *WARNING*: This filter is deprecated. Use the top-level options like
+ ``--volume`` and ``--replaygain...`` instead.
+
*NOTE*: This filter is not reentrant and can therefore only be enabled
once for every audio stream.
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 7d3070fda0..1f66b77225 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -1182,6 +1182,26 @@ Audio
Since mpv 0.18.1, this always controls the internal mixer (aka "softvol").
+``--replaygain-track=<yes|no>``
+ Adjust volume gain according to the track-gain replaygain value stored
+ in the file metadata.
+
+``--replaygain-album=<yes|no>``
+ Like replaygain-track, but using the album-gain value instead.
+
+``--replaygain-preamp=<db>``
+ Pre-amplification gain in dB to apply to the selected replaygain gain
+ (default: 0).
+
+``--replaygain-clip=<yes|no>``
+ Prevent clipping caused by replaygain by automatically lowering the
+ gain (default). Use ``--replaygain-clip=no`` to disable this.
+
+``--replaygain-fallback=<db>``
+ Gain in dB to apply if the file has no replay gain tags. This option
+ is always applied if the replaygain logic is somehow inactive. If this
+ is applied, no other replaygain options are applied.
+
``--balance=<value>``
How much left/right channels contribute to the audio. (The implementation
of this feature is rather odd. It doesn't change the volumes of each