.\" Text automatically generated by txt2man
.TH BS1770GAIN 1 "27 July 2023" "" ""
.SH NAME
\fBbs1770gain \fP- loudness scanner and normalizer based on ITU-R BS.1770
.SH SYNOPSIS
.nf
.fam C
\fBbs1770gain\fP [\fIoptions\fP] <file/dir> [<file/dir> \.\.\.]
.fam T
.fi
.fam T
.fi
.SH 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.
.TP
.B
See \fBbs1770gain\fP \fB--help\fP for experimental \fIoptions\fP.
Command line
arguments can appear in any order.
.SH OPTIONS
.TP
.B
\fB-h\fP,\fB--help\fP
print this message and exit
.TP
.B
\fB-i\fP,\fB--integrated\fP
calculate integrated loudness
.TP
.B
\fB-s\fP,\fB--shorterm\fP
calculate maximum shortterm loudness
.TP
.B
\fB-m\fP,\fB--momentary\fP
calculate maximum momentary loudness
.TP
.B
\fB-r\fP,\fB--range\fP
calculate loudness range
.TP
.B
\fB-p\fP,\fB--samplepeak\fP
calculate maximum sample peak
.TP
.B
\fB-t\fP,\fB--truepeak\fP
calculate maximum true peak
.TP
.B
\fB-b\fP <timestamp>,\fB--begin\fP <timestamp>
begin decoding at timestamp (in microseconds, format: hh:mm:ss.mus)
.TP
.B
\fB-d\fP <duration>,\fB--duration\fP <duration>
let decoding last duration (in microseconds, format: hh:mm:ss.mus)
.TP
.B
\fB-u\fP <method>,\fB--use\fP <method>
base replay gain calculation on method (with respect to the \fB-a\fP/\fB--apply\fP and \fB-o\fP/\fB--output\fP \fIoptions\fP), 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")
.TP
.B
\fB-a\fP
apply the EBU/ATSC/RG album gain to the output (in conjunction with the \fB-o\fP/\fB--output\fP option)
.TP
.B
\fB-o\fP <folder>,\fB--output\fP <folder>
write RG tags or apply the EBU/ATSC/RG gain,
respectively, and output to folder
\fB-f\fP <file>,\fB--file\fP <file>
write analysis to file
.TP
.B
\fB-x\fP,\fB--extensions\fP
enable following extensions/defaults:
.RS
.IP 1) 4
rename files according to TITLE tag
.IP 2) 4
read metadata from per-folder CSV file "folder.csv"
.IP 3) 4
copy file "folder.jpg" from source to destination
folder
.IP 4) 4
automatically add the TRACK and DISC tags
.IP 5) 4
calculate maximum true peak
.IP 6) 4
convert to stereo
.RE
.TP
.B
\fB-l\fP,\fB--list\fP
print FFmpeg format/stream information
.TP
.B
\fB--ebu\fP
calculate replay gain according to EBU R128 (\fB-23.0\fP LUFS, default)
.TP
.B
\fB--atsc\fP
calculate replay gain according to ATSC A/85 (\fB-24.0\fP LUFS)
.TP
.B
\fB--replaygain\fP
calculate replay gain according to ReplayGain 2.0 (\fB-18.0\fP LUFS)
.TP
.B
\fB--track-tags\fP
write track tags
.TP
.B
\fB--album-tags\fP
write album tags
.TP
.B
\fB--unit\fP <unit>
write tags with <unit>
.TP
.B
\fB--apply\fP <q>
apply the EBU/ATSC/RG gain to the output (in conjunction with the \fB-o\fP/\fB--output\fP option), q=0.0 (album gain) \.\.\. 1.0 (track gain), default  0.0 (album gain)
.TP
.B
\fB--audio\fP <index>
select audio index (corresponds to
[0:<index>] in FFmpeg listing, cf. \fB-l\fP/\fB--list\fP option)
.TP
.B
\fB--video\fP <index>
select video index (corresponds to
[0:<index>] in FFmpeg listing, cf. \fB-l\fP/\fB--list\fP option)
.TP
.B
\fB--stereo\fP
convert to stereo
.TP
.B
\fB--drc\fP <float>
set AC3 dynamic range compression (DRC)
.TP
.B
\fB--extension\fP <extension>
enable extension out of
.RS
.TP
.B
"rename":
rename files according to TITLE tag
.TP
.B
"csv":
read metadata from per-folder CSV file "folder.csv"
.TP
.B
"jpg":
copy file "folder.jpg" from source to destination folder
.TP
.B
"tags":
automatically add the TRACK and DISC tags
.RE
.TP
.B
\fB--format\fP <format>
convert to format
.TP
.B
\fB--loglevel\fP <level>
set loglevel,
.RS
.TP
.B
level:
"quiet", "panic", "fatal", "error", "warning",
"info", "verbose", "debug"
.RE
.TP
.B
\fB--xml\fP
print results in xml format
.TP
.B
\fB--time\fP
print out duration of program invocation
.TP
.B
\fB--norm\fP <float>
norm loudness to float.
.SH AUTHOR
.TP
.B
The \fBbs1770gain\fP system is written Peter Belkner and others.
The
authors can be contacted via http://bs1770gain.sourceforge.net/ .
.PP
This manual page for \fBbs1770gain\fP was written by Petter Reinholdtsen
and is licensed using the same terms as the \fBbs1770gain\fP source.