complexlogic / rsgain

rsgain Table of Contents • About • Installation • Windows • macOS • Linux • FreeBSD • Android • Docker • Supported File Formats • Usage • Easy Mode • Custom Mode • MusicBrainz Picard Plugin • Design Philosophy • License About **rsgain** (**r**eally **s**imple **gain**) is a ReplayGain 2.0 command line utility for Windows, macOS, Linux, BSD, and Android. rsgain applies loudness metadata tags to your files, while leaving the audio stream untouched. A ReplayGain-compatible player will dynamically adjust the volume of your tagged files during playback. rsgain is designed with a "batteries included" philosophy, allowing a user to scan their entire music library without requiring external scripts or other tools. It aims to strike the perfect balance between power and simplicity by providing multiple user interfaces. See Usage for more information. rsgain is the backend for the MusicBrainz Picard ReplayGain 2.0 plugin. Users that are not comfortable with command line interfaces may prefer this method since the plugin provides a GUI frontend to rsgain. See MusicBrainz Picard Plugin for more information. Installation Binary packages are available on the Release Page for Windows, macOS, and some Linux distributions. You can also build the program yourself, see BUILDING. Windows Download the ZIP file from the link below and extract its contents to a folder of your choice: • rsgain v3.7 portable ZIP (x64) rsgain should be run on Windows 10 or later for full compatibility, but it can run on Windows versions as early as Vista with some caveats. See Windows Notes for more information. It is recommended to add the directory to your system environment variable so you can invoke the program with the command instead of the path to its .exe file. • Use Windows key + R to bring up the run box, then type and press enter • In the resulting window in the "Advanced" tab, click the "Environment variables" button. • In the next window under "System variables", select "Path", then press "Edit". • Add the folder that you extracted to. Scoop rsgain is available in the Scoop extras bucket. Installing via Scoop enables you to receive automatic upgrades to future versions, unlike the manual installation method described above. First, make sure you have enabled the extras bucket. Then, install using the command below: macOS Separate builds are available for Apple Silicon and Intel based Macs. Both require macOS 12 (Monterey) or later. Download and extract the correct version according to your hardware: • rsgain v3.7 portable ZIP (Apple Silicon) • rsgain v3.7 portable ZIP (Intel) These builds are not codesigned, and the macOS Gatekeeper will most likely block execution. To work around this, you can remove the quarantine bit using the command below: Substitute with the actual path on your system. Package Managers rsgain can also be installed through Homebrew and MacPorts. Linux Debian/Ubuntu rsgain is available as an official Debian package starting in Debian 13 (Trixie) and Ubuntu 24.04 (noble). Install via : There is also a .deb package for Debian Bookworm available on the release page. Use the following commands to install: The above package won't work on recent Ubuntu releases due to an FFmpeg ABI break. Arch/Manjaro rsgain is available in the AUR via the packages rsgain and rgsain-git. You can install with an AUR helper such as : Fedora rsgain is packaged in Fedora's repositories. You can use to install: Nix/NixOS is in nixpkgs. Some options: • Run it without installing: • Install it in your Nix environment: • Add it to your NixOS configuration: Static Build An x86_64 static build is available that should run on recent releases of most GNU-based Linux distros (any distro shipping GCC 10 or later). Download the archive below and extract it to a directory of your choice: • rsgain v3.7 portable TAR (x86_64) FreeBSD Available via ports tree or using packages (2023Q1 and later) as listed below: Android rsgain can be installed on Android devices via the Termux terminal emulator package manager: Docker The repo contains a Dockerfile which can be used to run rsgain in a virtual environment. It will build a container based on the current Debian Stable release: rsgain requires a relatively up-to-date operating system, so this method can be used to run rsgain on an older system if necessary. A Docker container doesn't have access to the host filesystem by default. To use rsgain in a container, you need to mount your music library to a mount point in the container. Use the -v option followed by the path to your library and the mount point, separated by a colon. For example, if your music library is located at : The docker log to updates too slowly for the scan progress bar. If you don't use multithreaded mode consider passing to silence the output. Supported file formats rsgain supports all popular file formats. See the below table for compatibility. rsgain sorts files internally based on file extension, so it is required that your audio files match one of the extensions in the second column of the table in order to be recognized as valid. | Format | Supported File Extension(s) | | ------------------------------------ | --------------------------- | | Audio Interchange File Format (AIFF) | .aiff | | Free Lossless Audio Codec (FLAC) | .flac | | Monkey's Audio | .ape | | MPEG-1 Audio Layer II (MP2) | .mp2 | | MPEG-1 Audio Layer III (MP3) | .mp3 | | MPEG-4 Audio (AAC, ALAC)¹ | .m4a | | Musepack (MPC)² | .mpc | | Ogg (Vorbis, Speex, FLAC) | .ogg, .oga, .spx | | Opus | .opus | | Tom's lossless Audio Kompressor | .tak | | Waveform Audio File Format (WAV) | .wav | | Wavpack | .wv | | Windows Media Audio (WMA) | .wma | • *Support for HE-AAC and xHE-AAC are available via the Fraunhofer FDK AAC library. For the static builds, the included FFmpeg was compiled with support, so no further action is required. For the dynamic builds, you will need to check if your build of FFmpeg was compiled with t…