Skip to content

Commit e8bc0be

Browse files
committed
update docs
1 parent 76fb27d commit e8bc0be

2 files changed

Lines changed: 4 additions & 2 deletions

File tree

docs/advanced/faq.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ The normalization process involves measuring these values (input) and then apply
2626
* It maintains the relative loudness between different parts of the audio.
2727
* It avoids potential artifacts or pumping effects that can occur with dynamic processing.
2828

29-
**Dynamic mode**, on the other hand, can change the volume dynamically throughout the file. While this can achieve more consistent loudness, it may alter the original artistic intent and potentially introduce audible artifacts (possibly due to some bugs in the ffmpeg filter).
29+
**Dynamic mode**, on the other hand, can change the volume dynamically throughout the file. While this can achieve more consistent loudness, it may alter the original artistic intent. There were some bugs in older versions of the `loudnorm` filter that could cause artifacts, but these have been fixed in recent versions of ffmpeg.
3030

3131
For most cases, linear mode is recommended. Dynamic mode should only be used when linear mode is not suitable or when a specific effect is desired. In some cases, `loudnorm` will still fall back to dynamic mode, and a warning will be printed to the console. Here's when this can happen:
3232

@@ -40,6 +40,8 @@ At this time, the `loudnorm` filter in ffmpeg does not provide a way to force li
4040
- Similarly, the `--keep-loudness-range-target` option can be used to keep the input loudness range target.
4141
- The `--lower-only` option can be used to skip the normalization pass completely if the measured loudness is lower than the target loudness.
4242

43+
If instead you want to use dynamic mode, you can use the `--dynamic` option; this will also speed up the normalization process because only one pass is needed.
44+
4345
## The program doesn't work because the "loudnorm" filter can't be found
4446

4547
Make sure you run a recent ffmpeg version and that `loudnorm` is part of the output when you run `ffmpeg -filters`. Many distributions package outdated ffmpeg versions, or (even worse), Libav's `ffmpeg` disguising as a real `ffmpeg` from the FFmpeg project.

docs/usage/options.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ If a mono file is intended for playback on a stereo system, its EBU R128 measure
141141

142142
Force dynamic normalization mode.
143143

144-
Instead of applying linear EBU R128 normalization, choose a dynamic normalization. This is not usually recommended.
144+
Instead of applying linear EBU R128 normalization, choose a dynamic normalization. This uses a one-pass algorithm and skips the initial media scan.
145145

146146
Dynamic mode will automatically change the sample rate to 192 kHz. Use `-ar`/`--sample-rate` to specify a different output sample rate.
147147

0 commit comments

Comments
 (0)