BS1770GAIN(1)

✨ NAME ✨

bs1770gain — a loudness scanner and normalizer built on ITU-R BS.1770, and yes she ate 💅

---

🎀 SYNOPSIS 🎀

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

---

🌸 DESCRIPTION 🌸

okay so picture this, bestie: BS1770GAIN is a loudness scanner that is fully compliant with ITU-R BS.1770 plus all of its little flavor variants — EBU R128, ATSC A/85, and ReplayGain 2.0. Her whole purpose in life is normalizing the loudness of your audio and video files so they all land at the same level. It's giving "one volume setting, forever, no more chaos" 😭🫶 iconic behavior honestly.

🫶 run bs1770gain --help to see the experimental options, bestie, that's where the fun stuff lives. Also: command line arguments can appear in any order. The order is not the vibe police. ✨

---

👑 OPTIONS 👑

• -h, --help — prints this message and then exits. she's done, she's leaving, bye 💅
• -i, --integrated — calculates integrated loudness
• -s, --shorterm — calculates maximum shortterm loudness
• -m, --momentary — calculates maximum momentary loudness
• -r, --range — calculates loudness range
• -p, --samplepeak — calculates maximum sample peak
• -t, --truepeak — calculates maximum true peak
• -b <timestamp>, --begin <timestamp> — begins decoding at timestamp (in microseconds, format: hh:mm:ss.mus)
• -d <duration>, --duration <duration> — lets the decoding last duration long (in microseconds, format: hh:mm:ss.mus)
• -u <method>, --use <method> — bases the replay gain calculation on method (this is with respect to the -a/--apply and -o/--output options). The methods are: "integrated" (the default), "shortterm", or "momentary". And the experimental methods are: "momentary-mean" (same as "integrated"), "momentary-maximum" (same as "momentary"), "shortterm-mean", or "shortterm-maximum" (same as "shortterm")
• -a — applies the EBU/ATSC/RG album gain to the output (in conjunction with the -o/--output option)
• -o <folder>, --output <folder> — writes RG tags, or applies the EBU/ATSC/RG gain, respectively, and outputs to folder
• -f <file>, --file <file> — writes the analysis to file
• -x, --extensions — enables 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 — prints FFmpeg format/stream information
• --ebu — calculates replay gain according to EBU R128 (-23.0 LUFS, and that's the default, periodt)
• --atsc — calculates replay gain according to ATSC A/85 (-24.0 LUFS)
• --replaygain — calculates replay gain according to ReplayGain 2.0 (-18.0 LUFS)
• --track-tags — writes track tags
• --album-tags — writes album tags
• --unit <unit> — writes tags with unit
• --apply <q> — applies the EBU/ATSC/RG gain to the output (in conjunction with the -o/--output option), where q runs from 0.0 (album gain) all the way to 1.0 (track gain), and the default is 0.0 (album gain)
• --audio <index> — selects audio index (this corresponds to [0:<index>] in the FFmpeg listing, cf. the -l/--list option)
• --video <index> — selects video index (this corresponds to [0:<index>] in the FFmpeg listing, cf. the -l/--list option)
• --stereo — converts to stereo
• --drc <float> — sets AC3 dynamic range compression (DRC)
• --extension <extension> — enables one extension out of these:
  • "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> — converts to format
• --loglevel <level> — sets the loglevel, where level is one of: "quiet", "panic", "fatal", "error", "warning", "info", "verbose", "debug"
• --xml — prints results in xml format
• --time — prints out duration of program invocation
• --norm <float> — norms loudness to float.

---

💜 AUTHOR 💜

The bs1770gain system is written by Peter Belkman and others, and you can contact the authors via http://bs1770gain.sourceforge.net/ 🌐

This manual page for bs1770gain was written by Petter Reinholdtsen, and it's licensed using the same terms as the bs1770gain source. slay, legal girlies 🎀

---

ok that's the whole page bestie!! this was BS1770GAIN(1) from the manual, dated 25 December 2025 — go normalize something loud, ily, mwah 💋🦋