rsgain(1)

💖 rsgain — ReplayGain 2.0 loudness normalizer 💖

okay bestie, welcome to the rsgain(1) manual page, and let me tell you, this one is a moment. ✨

---

🌸 NAME 🌸

rsgain — the ReplayGain 2.0 loudness normalizer. literally what it says on the tin, no cap.

---

🦋 SYNOPSIS 🦋

rsgain [OPTIONS] <command> ...

that's it. that's the whole vibe check. 💅

---

💜 DESCRIPTION 💜

rsgain — which stands for really simple gain, and yes the name is doing main character energy — is a ReplayGain 2.0 command-line utility. 🔥

What does it do? It slaps loudness metadata tags onto your audio and video files while leaving the actual audio stream untouched. like, completely untouched. the audio stays exactly how it is, we're just writing little notes on the outside. 🎀

Then a ReplayGain-compatible player will dynamically adjust the volume of your tagged files during playback. so your playlist stops being a chaos demon where one song whispers and the next one takes your eardrums out. iconic behaviour, honestly. 👑

rsgain supports writing tags to these file types, and yes I'm listing all of them because we don't skip:

• AIFF (.aiff, .aif, .snd)
• APE (.ape)
• FLAC (.flac)
• MP2 (.mp2)
• MP3 (.mp3)
• MP4 (.m4a)
• Musepack (.mpc)
• Ogg (.ogg, .oga, .spx)
• Opus (.opus)
• TAK (.tak)
• WAV (.wav)
• WavPack (.wv)
• WMA (.wma)

---

✨ OPTIONS AND COMMANDS ✨

• -h, --help — Show help. your little "what is going on" button 🫶
• -v, --version — Show version number. for when you need to know exactly which queen we're running

easy — Easy Mode: recursively scan a directory with recommended settings. set it and forget it, bestie. 🌈

custom — Custom Mode: scan individual files with custom settings. for the control freaks (affectionate) 💅

Run rsgain easy --help or rsgain custom --help for more information. 🎀

---

🌼 EASY MODE 🌼

Usage: rsgain easy [OPTIONS] DIRECTORY

Easy Mode recursively scans a directory using the recommended settings for each file type. it just knows what to do. 💖

Easy Mode assumes that you have your music library organized with each album in its own folder. so like, one album per folder, bestie. that's the whole prerequisite. if your library is a feral pile of loose files this mode is gonna be giving confusion. 😭

---

⭐ OPTIONS ⭐

• -h, --help — Show help.
• -q, --quiet — Don't print scanning status messages. silence. peaceful. 🧚
• -S, --skip-existing — Don't scan files with existing ReplayGain information. if it's already been tagged, we leave it alone. no double dipping. 🙈
• -m n, --multithread=n — Scan files with n parallel threads. more threads = more going on at once. go faster, go girl. 🔥
• -p s, --preset=s — Load scan preset s.
• -O, --output — Output tab-delimited scan data to CSV file per directory. yes, per directory. not one big file. per directory. 📁
• -O s, --output=s — Output with sep header (needed for Microsoft Excel compatibility). Excel said "I only speak semicolon" and honestly? valid. 💀
• -O a, --output=a — Output with files sorted in alphanumeric order. tidy. organized. a clean girl. ✨

---

🎀 CUSTOM MODE 🎀

Usage: rsgain custom [OPTIONS] FILES...

Custom Mode allows the user to specify the options to scan files with. full creative control, no notes. 👑

The list of files to scan must be listed explicitly after the options. like, you gotta name them. all of them. rsgain is not a mind reader bestie. 🫶

---

💅 OPTIONS 💅

• -h, --help — Show help.
• -a, --album — Calculate album gain and peak. the whole-album vibe, not just one track. 💿
• -S, --skip-existing — Don't scan files with existing ReplayGain information.
• -s s, --tagmode=s — Scan files but don't write ReplayGain tags (default). just looking, not touching. 👀
• -s d, --tagmode=d — Delete ReplayGain tags from files. it's over. we're removing the evidence. 💀
• -s i, --tagmode=i — Scan and write ReplayGain 2.0 tags to files. the full send. 🔥
• -l n, --loudness=n — Use n LUFS as target loudness (-30 ≤ n ≤ -5). stay in that range, bestie, that's the rule. 📏
• -c n, --clip-mode=n — No clipping protection (default).
• -c p, --clip-mode=p — Clipping protection enabled for positive-gain values only.
• -c a, --clip-mode=a — Clipping protection always enabled.
• -m n, --max-peak=n — Use max peak level n dB for clipping protection.
• -t, --true-peak — Use true peak for peak calculations. the real peak. the honest one. ⭐
• -L, --lowercase — Write lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF). This is non-standard but sometimes needed. yeah it's a little rogue but sometimes the situation demands it. 🦋
• -I keep, --id3v2-version=keep — Keep file's existing ID3v2 version, 3 if none exists (default).
• -I 3, --id3v2-version=3 — Write ID3v2.3 tags to MP2/MP3/WAV/AIFF.
• -I 4, --id3v2-version=4 — Write ID3v2.4 tags to MP2/MP3/WAV/AIFF.
• -o d, --opus-mode=d — Write standard ReplayGain tags, clear header output gain (default).
• -o r, --opus-mode=r — Write R128_*_GAIN tags, clear header output gain.
• -o s, --opus-mode=s — Same as 'r', plus override target loudness to -23 LUFS.
• -o t, --opus-mode=t — Write track gain to header output gain.
• -o a, --opus-mode=a — Write album gain to header output gain.
• -O, --output — Output tab-delimited scan data to stdout. straight to your terminal, no file, no filter. 💖
• -O s, --output=s — Output with sep header (needed for Microsoft Excel compatibility).
• -O a, --output=a — Output with files sorted in alphanumeric order.
• -p, --preserve-mtimes — Preserve file mtimes. we do NOT touch the timestamps. they stay exactly as they were. periodt. ⏰
• -q, --quiet — Don't print scanning status messages.

---

💀 BUGS 💀

rsgain is maintained on GitHub. Please report all bugs to the issue tracker at https://github.com/complexlogic/rsgain/issues. if something's broken, tell the devs, don't just suffer in silence bestie, they literally want to know. 😭

---

👑 COPYRIGHT 👑

Copyright (C) 2023 Hugh McMaster

rsgain is released under the BSD-2-Clause licence.

---

and that's the whole page, bestie!! 💖✨🌸 you now know rsgain better than it knows itself, fr fr. this was rsgain(1), source/version rsgain(1), dated October 2023 — go forth and normalize those loudnesses, you absolute icon. 🎀🦋💅👑