Scroll to navigation

BS1770GAIN(1) BS1770GAIN(1)

NAME

bs1770gain - loudness scanner and normalizer based on ITU-R BS.1770

SYNOPSIS

bs1770gain [options] <file/dir> [<file/dir> ...]

DESCRIPTION

BS1770GAIN is a loudness scanner compliant with ITU-R BS.1770 and its flavors EBU R128, ATSC A/85, and ReplayGain 2.0. It helps normalizing the loudness of audio and video files to the same level.

Command line arguments can appear in any order.

OPTIONS

print this message and exit
calculate integrated loudness
calculate maximum shortterm loudness
calculate maximum momentary loudness
calculate loudness range
calculate maximum sample peak
calculate maximum true peak
begin decoding at timestamp (in microseconds, format: hh:mm:ss.mus)
let decoding last duration (in microseconds, format: hh:mm:ss.mus)
base replay gain calculation on method (with respect to the -a/--apply and -o/--output options), methods: "integrated" (default), "shortterm", or "momentary" experimental methods: "momentary-mean" (same as "integrated"), "momentary-maximum" (same as "momentary"), "shortterm-mean", or "shortterm-maximum" (same as "shortterm")
apply the EBU/ATSC/RG album gain to the output (in conjunction with the -o/--output option)
write RG tags or apply the EBU/ATSC/RG gain, respectively, and output to folder -f <file>,--file <file> write analysis to file
enable following extensions/defaults:
1)
rename files according to TITLE tag
2)
read metadata from per-folder CSV file "folder.csv"
3)
copy file "folder.jpg" from source to destination folder
4)
automatically add the TRACK and DISC tags
5)
calculate maximum true peak
6)
convert to stereo
print FFmpeg format/stream information
calculate replay gain according to EBU R128 (-23.0 LUFS, default)
calculate replay gain according to ATSC A/85 (-24.0 LUFS)
calculate replay gain according to ReplayGain 2.0 (-18.0 LUFS)
write track tags
write album tags
write tags with <unit>
apply the EBU/ATSC/RG gain to the output (in conjunction with the -o/--output option), q=0.0 (album gain) ... 1.0 (track gain), default 0.0 (album gain)
select audio index (corresponds to [0:<index>] in FFmpeg listing, cf. -l/--list option)
select video index (corresponds to [0:<index>] in FFmpeg listing, cf. -l/--list option)
convert to stereo
set AC3 dynamic range compression (DRC)
enable extension out of
"rename":
rename files according to TITLE tag
"csv":
read metadata from per-folder CSV file "folder.csv"
"jpg":
copy file "folder.jpg" from source to destination folder
"tags":
automatically add the TRACK and DISC tags
convert to format
set loglevel,
"quiet", "panic", "fatal", "error", "warning", "info", "verbose", "debug"
print results in xml format
print out duration of program invocation
norm loudness to float.

AUTHOR

The authors can be contacted via http://bs1770gain.sourceforge.net/ .

This manual page for bs1770gain was written by Petter Reinholdtsen and is licensed using the same terms as the bs1770gain source.

21 December 2021