Reference

bs1770gain(1)

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

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.

See bs1770gain --help for experimental options.

Command line arguments can appear in any order.

OPTIONS

-h,--help

print this message and exit

-i,--integrated

calculate integrated loudness

-s,--shorterm

calculate maximum shortterm loudness

-m,--momentary

calculate maximum momentary loudness

-r,--range

calculate loudness range

-p,--samplepeak

calculate maximum sample peak

-t,--truepeak

calculate maximum true peak

-b <timestamp>,--begin <timestamp>

begin decoding at timestamp (in microseconds, format: hh:mm:ss.mus)

-d <duration>,--duration <duration>

let decoding last duration (in microseconds, format: hh:mm:ss.mus)

-u <method>,--use <method>

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")

-a

apply the EBU/ATSC/RG album gain to the output (in conjunction with the -o/--output option)

-o <folder>,--output <folder>

write RG tags or apply the EBU/ATSC/RG gain, respectively, and output to folder -f <file>,--file <file> write analysis to file

-x,--extensions

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

-l,--list

print FFmpeg format/stream information

--ebu

calculate replay gain according to EBU R128 (-23.0 LUFS, default)

--atsc

calculate replay gain according to ATSC A/85 (-24.0 LUFS)

--replaygain

calculate replay gain according to ReplayGain 2.0 (-18.0 LUFS)

--track-tags

write track tags

--album-tags

write album tags

--unit <unit>

write tags with <unit>

--apply <q>

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)

--audio <index>

select audio index (corresponds to [0:<index>] in FFmpeg listing, cf. -l/--list option)

--video <index>

select video index (corresponds to [0:<index>] in FFmpeg listing, cf. -l/--list option)

--stereo

convert to stereo

--drc <float>

set AC3 dynamic range compression (DRC)

--extension <extension>

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

--format <format>

convert to format

--loglevel <level>

set loglevel,

level:

"quiet", "panic", "fatal", "error", "warning", "info", "verbose", "debug"

--xml

print results in xml format

--time

print out duration of program invocation

--norm <float>

norm loudness to float.

AUTHOR

The bs1770gain system is written Peter Belkner and others.

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.

History