@@ -12,6 +12,7 @@ _shtab_ffmpeg_normalize_commands() {
1212
1313_shtab_ffmpeg_normalize_options=(
1414 " (- : *)" {-h,--help}" [show this help message and exit]"
15+ " --input-list[Path to a text file containing a line-separated list of input files]:input_list:"
1516 {-o,--output}" [Output file names. Will be applied per input file.
1617
1718If no output file name is specified for an input file, the output files
@@ -50,6 +51,10 @@ in LUFS. The range is -70.0 - -5.0.
5051Otherwise, the range is -99 to 0.
5152]:target_level:"
5253 {-p,--print-stats}" [Print loudness statistics for both passes formatted as JSON to stdout.]"
54+ " --replaygain[Write ReplayGain tags to the original file without normalizing.
55+ This mode will overwrite the input file and ignore other options.
56+ Only works with EBU normalization, and only with .mp3, .mp4\/.m4a, .ogg, .opus for now.
57+ ]"
5358 {-lrt,--loudness-range-target}" [EBU Loudness Range Target in LUFS (default\: 7.0).
5459Range is 1.0 - 50.0.
5560]:loudness_range_target:"
@@ -69,14 +74,17 @@ Range is -99.0 - \+99.0.
6974 " --lower-only[Whether the audio should not increase in loudness.
7075
7176If the measured loudness from the first pass is lower than the target
72- loudness then normalization pass will be skipped for the measured audio
73- source.
77+ loudness then normalization will be skipped for the audio source.
78+
79+ For EBU normalization, this compares input integrated loudness to the target level.
80+ For peak normalization, this compares the input peak level to the target level.
81+ For RMS normalization, this compares the input RMS level to the target level.
7482]"
7583 " --auto-lower-loudness-target[Automatically lower EBU Integrated Loudness Target to prevent falling
7684back to dynamic filtering.
7785
7886Makes sure target loudness is lower than measured loudness minus peak
79- loudness (input_i - input_tp) by a small amount.
87+ loudness (input_i - input_tp) by a small amount (0.1 LUFS) .
8088]"
8189 " --dual-mono[Treat mono input files as \" dual-mono\" .
8290
@@ -92,6 +100,20 @@ normalization. This is not usually recommended.
92100
93101Dynamic mode will automatically change the sample rate to 192 kHz. Use
94102-ar\/--sample-rate to specify a different output sample rate.
103+ ]"
104+ {-as,--audio-streams}" [Select specific audio streams to normalize by stream index (comma-separated).
105+ Example\: --audio-streams 0,2 will normalize only streams 0 and 2.
106+
107+ By default, all audio streams are normalized.
108+ ]:audio_streams:"
109+ " --audio-default-only[Only normalize audio streams with the \'default\' disposition flag.
110+ This is useful for files with multiple audio tracks where only the main track
111+ should be normalized (e.g., keeping commentary tracks unchanged).
112+ ]"
113+ " --keep-other-audio[Keep non-selected audio streams in the output file (copy without normalization).
114+ Only applies when --audio-streams or --audio-default-only is used.
115+
116+ By default, only selected streams are included in the output.
95117]"
96118 {-c:a,--audio-codec}" [Audio codec to use for output files.
97119See \` ffmpeg -encoders\` for a list.
@@ -169,7 +191,7 @@ extension will govern the format (see \'--extension\' option).
169191 {-ext,--extension}" [Output file extension to use for output files that were not explicitly
170192specified. (Default\: \` mkv\` )
171193]:extension:"
172- " (*):Input media file(s):"
194+ " (*):: Input media file(s):"
173195)
174196
175197
0 commit comments