Hydrogenaudio Knowledgebase - User contributions [en]

Rsgain

2024-02-28T04:03:07Z

Complexlogic: Update for v3.5

{{Software Infobox
| name = rsgain
| screenshot = [[File:rsgain_help.png|300px]]
| caption = Default help screen in a Linux terminal
| developer = complexlogic
| released = 2022-05-10
| stable_release = 3.5
| stable_release_date = 2024-02-25
| operating_system = Windows, macOS, Linux, BSD, Android
| use = ReplayGain tagging
| license = BSD license
| website = [https://github.com/complexlogic/rsgain]
}}
'''rsgain''' ('''r'''eally '''s'''imple '''gain''') is a free and open source [[ReplayGain 2.0 specification|ReplayGain 2.0]] tagging utility for Windows, macOS, Linux, BSD, and Android. rsgain applies loudness metadata tags to your files, while leaving the audio stream untouched. A [[ReplayGain#Players_support|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|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|MusicBrainz Picard Plugin]] for more information.

==Installation==
rsgain is available in source form on all platforms, and executable form on some platforms.

===Windows===
rsgain is compatible with Windows 10 and later. Download the win64 .zip file from the [https://github.com/complexlogic/rsgain/releases/latest latest release on GitHub], and extract its contents to a directory of your choice.

It is recommended to add the directory to your {{code|Path}} system environment variable so you can invoke the program with the {{code|rsgain}} command instead of the path to its .exe file. In the Windows taskbar search, type "env", then select "Edit the system environment variables". In the resulting window, click the "Environment variables" button. In the next window under "System variables", select "Path", then press Edit. Add the folder that you extracted {{code|rsgain.exe}} to in the previous step.

===macOS===
There is a Homebrew formula available for macOS users. Make sure you have Homebrew and the latest available Xcode installed. Execute the following command to install:

{{code|brew install complexlogic/tap/rsgain}}

===Linux===
An amd64 .deb package is provided on the [https://github.com/complexlogic/rsgain/releases/latest GitHub release page]. It is installable on Debian Bullseye and later, Ubuntu 21.04 and later. There is also a .rpm package for Fedora users. An [https://aur.archlinux.org/packages/rsgain-git AUR package] is available for Arch/Manjaro users.

Users of other distros will need to build from source. See the [https://github.com/complexlogic/rsgain/blob/master/docs/BUILDING.md#building build instructions on GitHub].

===FreeBSD===
Available via ports tree or using packages (2023Q1 and later) as listed below:
{{code|cd /usr/ports/audio/rsgain && make install clean}}
{{code|pkg install rsgain}}

==Format Support==
rsgain has support for the following file formats:
* [[MP2]]/[[MP3]]
* [[FLAC]]
* [[Ogg]] ([[Vorbis]], [[Speex]])
* [[Opus]]
* [[M4A]] ([[AAC]], [[ALAC]])
* [[WMA]]
* [[Musepack]]
* [[WAV]]
* [[AIFF]]
* [[Wavpack]]
* [[Monkey's Audio]]
* [[TAK]]

==Usage==
rsgain contains two separate user interfaces: Easy Mode and Custom Mode. The distinction between the two modes is rooted in the history of ReplayGain utilities.

Legacy ReplayGain tagging utilities such as mp3gain did not support recursive directory-based scanning. The user was required to manually specify a list of files on the command line, preceded by options which were numerous and complex. This interface provided a lot of power and flexibility, but it wasn't particularly user friendly. Performing a full library scan typically required the user to supplement the program with a wrapper script that traversed the directory tree and detected the files.

rsgain's Easy Mode ''is'' that wrapper script; the functionality is built-in to the program. In Easy Mode, the user simply points the program to their library and it will be recursively scanned with all recommended settings enabled by default.

The legacy-style interface has been retained as "Custom Mode" for users that require a higher level of control. Custom Mode is mostly used for scripting.

===Easy Mode===
Easy Mode recursively scans your entire music library using the recommended settings for each file type. Easy Mode is invoked with the command {{code|rsgain easy}} followed by the root of the directory you want to scan:

{{code|rsgain easy /path/to/music/library}}

{{code|rsgain easy "C:\path\to\music library"}}

Easy Mode assumes that you have you have your music library organized by album, so that each album is contained in its own folder. The album gain calculations rely on this assumption. If you do not have your music library organized by album, you should disable the album tags because the calculated values will not be valid. rsgain ships with a scan preset which can disable the album tags for you; invoke it with {{code|-p no_album}}. See the [[#Scan_Presets|Scan Presets]] section for more information about how the scan preset feature works.

====Multithreaded Scanning====
Easy Mode includes optional multithreaded operation to speed up the duration of a scan. Use the {{code|-m}} option, followed by the number of threads to create. The number of threads must not exceed the number that your CPU supports. For example, if you have a CPU with 4 threads:

{{code|rsgain easy -m 4 /path/to/music/library}}

If you don't know how many threads your CPU has, you can also specify {{code|-m MAX}} and rsgain will use the number provided by your operating system. This is useful for writing scripts where the hardware properties of the target machine are unknown.

Parallel scan jobs are generated on a ''per-directory'' basis, not a per-file basis. If you request 4 threads but there is only 1 directory to scan, a single thread will be working and the other 3 will sit idle the entire time. Multithreaded mode is optimized for scanning a very large number of directories. It is recommended to use multithreaded mode for full library scans and the default single threaded mode when incrementally adding 1 or 2 albums to your library.

The speed gains offered by multithreaded scanning are significant. With {{code|-m 4}} or higher, you can typically expect to see a 50-80% reduction in total scan time, depending on your hardware, settings, and library composition.

====Skip Files with Existing Tags====
rsgain has an option which will skip files with existing ReplayGain information, invoked by passing {{code|-S}} or {{code|--skip-existing}}. When enabled, rsgain will check whether the given file has a {{code|REPLAYGAIN_TRACK_GAIN}} tag, and skip scanning any files that do. If album tags are enabled, the files in the list will be judged collectively, i.e. if a single file is missing ReplayGain info, then all of them will be scanned.

This feature merely checks for the existence of the tags, and does not verify that the tags are complete, and are compatible with your current settings, e.g. target loudness. You should use this feature only if you are confident in the integrity of the files in the directory to be scanned. It's generally not a good idea to run this on files that you've recently download from the internet, which may have pre-existing ReplayGain information that was tagged by a different scanner.

====Logging====
You can use the {{code|-O}} option to enable scan logs. The program will save a tab-delimited file titled {{code|replaygain.csv}} with the scan results for every directory it scans. The log files can be viewed in a spreadsheet application such as Microsoft Excel or LibreOffice Calc.

====Scan Presets====
Easy Mode scans files with the following settings by default:
* -18 LUFS target loudness
* Album tags enabled
* Sample peak calculations for peak tags
* Clipping protection enabled for positive gain values only (0 dB max peak)
* Standard uppercase tags for all formats
* ID3v2.3 tags for ID3 formats
* Standard ReplayGain tags for Opus files

These settings are recommended for maximum compatibility with modern players. However, if you need one or more of the settings changed, you can use a preset file.

A preset file is an INI-formatted configuration file that contains sections enclosed in square brackets, and each section contains key=value pairs that correspond to settings. The first section in a presets file is titled "Global" and contains settings that will be applied to every format. The remaining sections pertain to a particular audio format, and the settings within them will only be applied to that format. This allows the user to define settings on a per-format basis. If a setting in the "Global" section is in conflict with one in the format-specific section, the format-specific value will always take precedence.

A preset is specified with the {{code|-p}} option, followed by the path to a preset file ''or'' a preset name. A preset name is the filename of a preset without the directory or .ini file extension; rsgain will search the default preset location(s) for the file based on your platform:
* On Windows, rsgain will search first in {{code|%USERPROFILE%\.rsgain\presets}}, then the folder {{code|presets}} in the same folder that contains {{code|rsgain.exe}}
* On Unix platforms, rsgain will search first in the user home directory: {{code|~/Library/rsgain/presets}} on Mac and {{code|~/.config/rsgain/presets}} on Linux (you need to create these directories if they don't already exist). If the requested preset name is not found in the home directory, rsgain will search {{code|<install prefix>/share/rsgain/presets}}

For example, rsgain ships with a preset {{code|ebur128.ini}}, which will scan files based on the EBU R 128 recommendations. You can invoke this preset with {{code|-p ebur128}}. rsgain also ships with a preset {{code|default.ini}}, which is pre-populated with all of the default settings. This preset is not intended to be used directly, but rather to serve as a base for users to create their own presets. As such, it is not recommended to overwrite it. Instead, save a copy when using it as a base.

The settings in a preset file are applied in an "overrides" fashion. In other words, any settings or formats you're not interested in can simply be deleted from the preset and the defaults will be used instead.

===Custom Mode===
Custom Mode provides a more complex command line syntax that is similar in nature to mp3gain, loudgain, and other legacy ReplayGain scanners. Only the most basic settings are enabled by default. Unlike Easy Mode, Custom Mode works with files, not directories. If you want recursive directory-based scanning, you will need to write a wrapper script.

Custom Mode is invoked with {{code|rsgain custom}} followed by options and a list of files to scan. For example, scan and tag a short list of MP3 files with album tags enabled:

{{code|rsgain custom -a -s i file1.mp3 file2.mp3 file3.mp3}}

See the command line help for all available options:

<pre>
Usage: rsgain custom [OPTIONS] FILES...
Custom Mode allows the user to specify the options to scan the files with. The
list of files to scan must be listed explicitly after the options.

Options:
-h, --help Show this help.

-a, --album Calculate album gain and peak.
-S, --skip-existing Don't scan files with existing ReplayGain information.

-s s, --tagmode=s Scan files but don't write ReplayGain tags (default).
-s d, --tagmode=d Delete ReplayGain tags from files.
-s i, --tagmode=i Scan and write ReplayGain 2.0 tags to files.

-l n, --loudness=n Use n LUFS as target loudness (-30 ≤ n ≤ -5).

-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.

-L, --lowercase Write lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF).
This is non-standard but sometimes needed.
-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.
-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.
-q, --quiet Don't print scanning status messages.

Please report any issues to https://github.com/complexlogic/rsgain/issues

</pre>

===MusicBrainz Picard Plugin===
[https://picard.musicbrainz.org/ MusicBrainz Picard] is a free, cross-platform music tagging application. Picard features a robust plugin ecosystem that greatly extends its functionality. rsgain serves as the backend for the ReplayGain 2.0 plugin, which is available from the official plugins repository. Users that prefer a graphical interface over a command line interface can use this plugin to scan their music library.

To install the plugin, navigate to the Options menu in Picard. Select "Plugins" in the sidebar, then find "ReplayGain 2.0" and click the download button. The plugin itself does not include rsgain; you'll still need to download and install rsgain separately per the [[#installation|Installation]] section for your chosen platform.

You need to set the path to rsgain in the plugin settings. This field is pre-populated with the {{code|rsgain}} command. On Unix platforms, programs are typically installed into a directory that's already in your {{code|PATH}}, so no further action is necessary in that case. On Windows, you will need to either manually add the folder containing rsgain to your {{code|Path}} as per the installation instructions, or use the exact path to {{code|rsgain.exe}} in the plugin settings.

To use the plugin, add files to Picard and associate them with a release (so the files are in the right window). The plugin can scan albums or individual tracks. Select one or more albums or tracks, then right click and select "Plugins->Calculate ReplayGain" from the context menu. This calculates the ReplayGain information for the selected items, but does not tag the files. The new tags are available for viewing in the metadata window at the bottom. Click the save button to write the new tags to file.

==See also==
* [[ReplayGain]]
* [[ReplayGain 2.0 specification]]

==External links==
* [https://github.com/complexlogic/rsgain/ rsgain GitHub page]
* [https://en.wikipedia.org/wiki/EBU_R_128 EBU R128]

[[Category:Software]]

Easy Audio Sync

2024-02-09T14:11:07Z

Complexlogic: Update for v1.1.1

{{Software Infobox
| name = Easy Audio Sync
| screenshot = [[File:Easyaudiosync usage.png|300px]]
| caption = Easy Audio Sync running on Linux
| developer = complexlogic
| released = 2023-05-18
| stable_release = 1.1.1
| stable_release_date = 2024-02-08
| operating_system = Windows, macOS, Linux
| use = Full library transcoding
| license = Unlicense
| website = [https://github.com/complexlogic/EasyAudioSync]
}}
Easy Audio Sync is an audio library syncing and conversion utility. The intended use is syncing an audio library with many lossless files to a mobile device with limited storage.

==Installation==
Easy Audio Sync is compatible with Windows, macOS and Linux.

===Windows===
Easy Audio Sync is compatible with Windows 10 and later. Download the installer executable from the [https://github.com/complexlogic/EasyAudioSync/releases/latest latest release on GitHub], run it, and follow the guided installation process.

===macOS===
Builds are available for both Intel and Apple Silicon based Macs. Download the appropriate disk image for your hardware from the [https://github.com/complexlogic/EasyAudioSync/releases/latest latest release on GitHub] and install via drag and drop.

===Linux===
Builds are available for APT-based Linux distros and Fedora [https://github.com/complexlogic/EasyAudioSync/releases/latest on GitHub]. Otherwise, you can build from source according to the provided build instructions.

==Usage==
Easy Audio Sync operates based on a source folder and a destination folder, where the source folder contains the primary music library, and the destination folder is the desired output location. After selecting the source and destination folders, click the "Sync" button to start the sync. The program will recreate the source's entire subfolder structure in the destination, copying or transcoding files as specified in the settings. See the [https://github.com/complexlogic/EasyAudioSync/blob/master/docs/settings.md settings documentation on GitHub] for help on configuring the program's settings.

The stop button next to the progress bar can be used stop the sync at any time. The worker threads are allowed to finish their current file operation before quitting to avoid leaving corrupted files in the destination. Consequently, it may take several seconds after the stop button is clicked for the sync to stop.

===Supported Formats===
The following audio formats are supported, per-mode:
{| class="wikitable"
|-
! Codec !! Copy !! Transcode Input !! Transcode Output
|-
| [[FLAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[ALAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WavPack]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[Monkey's Audio]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WAV]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[MP3]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[AAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Ogg Vorbis]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Opus]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Musepack]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WMA]] || {{Yes|Yes}} || {{No|No}} || {{No|No}}
|}

===Supported Encoders===
The following encoders are supported for transcoding
{| class="wikitable"
|-
! Codec !! Encoder(s)
|-
| MP3 || [[LAME]]
|-
| AAC || [[Fraunhofer FDK AAC]], [[Libavcodec AAC]]
|-
| Ogg Vorbis || libvorbis
|-
| Opus || libopus
|}

==See also==
* [[Transcoding]]
* [[Variable Bitrate]]

==External links==
* [https://github.com/complexlogic/EasyAudioSync/ Easy Audio Sync GitHub page]

[[Category:Software]]

Easy Audio Sync

2024-01-27T17:18:29Z

Complexlogic: Update for v1.1

{{Software Infobox
| name = Easy Audio Sync
| screenshot = [[File:Easyaudiosync usage.png|300px]]
| caption = Easy Audio Sync running on Linux
| developer = complexlogic
| released = 2023-05-18
| stable_release = 1.1
| stable_release_date = 2024-01-25
| operating_system = Windows, macOS, Linux
| use = Full library transcoding
| license = Unlicense
| website = [https://github.com/complexlogic/EasyAudioSync]
}}
Easy Audio Sync is an audio library syncing and conversion utility. The intended use is syncing an audio library with many lossless files to a mobile device with limited storage.

==Installation==
Easy Audio Sync is compatible with Windows, macOS and Linux.

===Windows===
Easy Audio Sync is compatible with Windows 10 and later. Download the installer executable from the [https://github.com/complexlogic/EasyAudioSync/releases/latest latest release on GitHub], run it, and follow the guided installation process.

===macOS===
Builds are available for both Intel and Apple Silicon based Macs. Download the appropriate disk image for your hardware from the [https://github.com/complexlogic/EasyAudioSync/releases/latest latest release on GitHub] and install via drag and drop.

===Linux===
Builds are available for APT-based Linux distros and Fedora [https://github.com/complexlogic/EasyAudioSync/releases/latest on GitHub]. Otherwise, you can build from source according to the provided build instructions.

==Usage==
Easy Audio Sync operates based on a source folder and a destination folder, where the source folder contains the primary music library, and the destination folder is the desired output location. After selecting the source and destination folders, click the "Sync" button to start the sync. The program will recreate the source's entire subfolder structure in the destination, copying or transcoding files as specified in the settings. See the [https://github.com/complexlogic/EasyAudioSync/blob/master/docs/settings.md settings documentation on GitHub] for help on configuring the program's settings.

The stop button next to the progress bar can be used stop the sync at any time. The worker threads are allowed to finish their current file operation before quitting to avoid leaving corrupted files in the destination. Consequently, it may take several seconds after the stop button is clicked for the sync to stop.

===Supported Formats===
The following audio formats are supported, per-mode:
{| class="wikitable"
|-
! Codec !! Copy !! Transcode Input !! Transcode Output
|-
| [[FLAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[ALAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WavPack]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[Monkey's Audio]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WAV]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[MP3]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[AAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Ogg Vorbis]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Opus]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Musepack]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WMA]] || {{Yes|Yes}} || {{No|No}} || {{No|No}}
|}

===Supported Encoders===
The following encoders are supported for transcoding
{| class="wikitable"
|-
! Codec !! Encoder(s)
|-
| MP3 || [[LAME]]
|-
| AAC || [[Fraunhofer FDK AAC]], [[Libavcodec AAC]]
|-
| Ogg Vorbis || libvorbis
|-
| Opus || libopus
|}

==See also==
* [[Transcoding]]
* [[Variable Bitrate]]

==External links==
* [https://github.com/complexlogic/EasyAudioSync/ Easy Audio Sync GitHub page]

[[Category:Software]]

Download page

2023-05-25T04:47:39Z

Complexlogic: Add Easy Audio Sync to Transcoders

All programs mentioned anywhere in the wiki can be downloaded here.
See also the [[:Category:Software|Software Category]] article for more software not listed here.

==CD Rippers==
===Windows===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #00A1F1; margin-bottom: 20px;"
|- style="background-color: #00A1F1;"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:500px;" | Description
|-
! align="left" | CUERipper
| GPL
| [http://cue.tools/wiki/CUERipper here]
| align="left" | A secure ripper for Windows that includes Accurate Stream functionality. [https://hydrogenaud.io/index.php/board,74.0.html Forum]
|- style="background-color: #eeeeee;"
! align="left" | [[DBpowerAMP with AccurateRip|dBpoweramp]]
| commercial
| [http://www.dbpoweramp.com/ here]
| align="left" | A secure ripper for Windows that includes Accurate Stream functionality.
|-
! align="left" | [[EAC]]
| Free
| [http://www.exactaudiocopy.de/ here]
| align="left" | A secure ripper for Windows, C2 error pointers, Accurate Stream, etc.
|- style="background-color: #eeeeee;"
! align="left" | [[fre:ac ]]
| GPL
| [http://www.freac.org/ here]
| align="left" |
fre:ac is a free audio converter and CD ripper with support for various popular formats and encoders. Plus supports the CDDB/freedb online CD database which allows you query song information.
|}

===Mac OS X===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #79C753; margin-bottom: 20px;"
|- style="background:#79C753;"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:500px;" | Description
|-
! align="left" | [[Max]]
| GPL
| [http://sbooth.org/Max/ here]
| align="left" | A secure ripper for OS X that uses additional cdparanoia functionality
|- style="background-color: #eeeeee;"
! align="left" | [[XLD]]
| GPL
| [http://tmkk.pv.land.to/xld/index_e.html here]
| align="left" | X Lossless Decoder(XLD) is a tool for Mac OS X that is able to decode/convert/play various 'lossless' audio files. The supported audio files can be split into some tracks with cue sheet when decoding. Can convert between many lossless and lossy formats. Plugin oriented design, for easy exchange for new encoders.
|}

===Linux===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #D65076; margin-bottom: 20px;"
|- style="background:#D65076;"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:450px;" | Description
|-
! align="left" | abcde
| GPL
|[https://abcde.einval.com/wiki/ here]
| align="left" | A command-line based ripper with cdparanoia functionality
|- style="background-color: #eeeeee;"
! align="left" | [[cdparanoia]]
| BSD, GPL
| [https://xiph.org/paranoia/ here]
| align="left" | One of the first secure standalone rippers for the Linux platform
|-
! align="left" | Grip
| GPL
| [https://sourceforge.net/projects/grip/ here]
| align="left" | An open-source Gnome interface ripper that uses cdparanoia functionality
|- style="background-color: #eeeeee;"
! align="left" | [[Rubyripper]]
| GPL
| [https://github.com/bleskodev/rubyripper here]
| align="left" | A secure ripper for Linux that uses additional cdparanoia functionality
|-
! align="left" | [[Whipper]]
| GPL
| [https://github.com/whipper-team/whipper here]
| align="left" | A secure ripper for the Linux command-line built on cdparanoia
|}

==CD/DVD Writers==
===Windows===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #00A1F1; margin-bottom: 20px;"
|- style="background:#00A1F1"
! style="width:185px;" | Name
! style="width:80px;" | Unicode
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:270px;" | Description
|-
! align="left" | [[Burrrn]] (CDA only)
| N
| Free
| 
|
|- style="background-color: #eeeeee;"
! align="left" | CDBurnerXP
|
| Free
| [http://www.cdburnerxp.se/ here]
|
|-
! align="left" | DeepBurner
| N
| GPL
| [http://www.deepburner.com/ here]
|
|- style="background-color: #eeeeee;"
! align="left" | InfraRecorder
| N
| GPL
| [http://infrarecorder.org/ here]
|
|-
|}

===Mac OS X===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #79C753; margin-bottom: 20px;"
|- style="background:#79C753;"
! style="width:130px;" | Name
! style="width:80px;" | Unicode
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:310px;" | Description
|-
! align="left" | DVD-Audio Tools
| Y
| GPL
| [http://dvd-audio.sourceforge.net/ here]
| align="left" | Open-source DVD-Audio authoring application
|- style="background-color: #eeeeee;"
! align="left" | FireStarter FX
| N
| Free
| [http://wiki.hydrogenaudio.org/index.php?title=FireStarter_FX here]
| align="left" | Free OS X Cocoa CD writing application
|-
! align="left" | X-CD-Roast
| N
| Free
| [http://www.xcdroast.org/xcdr098/xcdrosX.html here]
| align="left" | New OS X port of this Linux CD writing application
|- style="background-color: #eeeeee;"
! align="left" | Burn
| N
| Free
| [http://burn-osx.sourceforge.net/Pages/English/home.html/ here]
| align="left" | Versatile CD/DVD authoring application
|}

===Linux===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #D65076; margin-bottom: 20px;"
|- style="background:#D65076;"
! style="width:130px;" | Name
! style="width:80px;" | Unicode
! style="width:90px;" | License
! style="width:100px;" | Website
! align="center" style="width:450px;" | Description
|-
! align="left" | CDRDAO
| N
| GPL
| [http://cdrdao.sourceforge.net/ here]
| align="left" | Cdrdao records audio or data CD-Rs in disk-at-once (DAO) mode
|- style="background-color:#eeeeee;"
! align="left" | DVD-Audio Tools
| Y
| GPL
| [http://dvd-audio.sourceforge.net/ here]
| align="left" | Open-source DVD-Audio authoring application
|-
! align="left" | GnomeBaker
| N
| GPL
| [http://sourceforge.net/projects/gnomebaker/ here]
| align="left" | Popular open-source Gnome interface CD/DVD writing application
|- style="background-color:#eeeeee;"
! align="left" | [[K3b]]
| N
| GPL
| [http://www.k3b.org/ here]
| align="left" | Popular open-source KDE CD writing application for Linux platform
|-
! align="left" | X-CD-Roast
| Y
| GPL
| [http://www.xcdroast.org here]
| align="left" | New open-source Gnome interface CD/DVD writing application
|- style="background-color:#eeeeee;"
! align="left" | Brasero
| N
| GPL
| [http://projects.gnome.org/brasero/ here]
| align="left" | Brasero is a application to burn CD/DVD for the Gnome Desktop.(Gnome Default)
|}

==Multimedia Players==
===Windows===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #00A1F1; margin-bottom: 20px;"
|- style="background:#00A1F1"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! align="center" style="width:500px;" | Description
|-
! align="left" | [[foobar2000]]
| Free, BSD
| [http://www.foobar2000.org/ here]
| align="left" | Advanced tagging, plugin capabilities, and kernel streaming support
|- style="background-color: #eeeeee;"
! align="left" | [[MediaMonkey]]
| Free, Shareware
| [http://www.mediamonkey.com/ here]
| align="left" | Supports many Winamp plugins
|-
! align="left" | VUplayer
| Free
| [http://www.vuplayer.com/ here]
| align="left" | Supports many popular digital audio codecs and MOD tracker formats
|- style="background-color: #eeeeee;"
! align="left" | [[Winamp]]
| Free, Shareware
| [http://www.winamp.com/ here]
| align="left" | Popular audio player for Windows
| align="left" |
|-
! align="left" | [[VLC]]
| LGPL
| [http://www.videolan.org/vlc// here]
| align="left" | VLC media player is a highly portable multimedia player and multimedia framework capable of reading most audio and video formats as well as DVDs, Audio CDs VCDs, and various streaming protocols.
|- style="background-color: #eeeeee;"
! align="left" | [[MusicBee]]
| Free,
| [https://getmusicbee.com/ here]
| align="left" | The Ultimate Music Manager and Player, MusicBee supports podcasts, web radio stations and SoundCloud integration.

|-
|}

===Players / Source code ===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #98DDDE; margin-bottom: 20px;"
|- style="background:#98DDDE"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! align="center" style="width:450px;" | Description
|-
! align="left" | MusikCube
| BSD
| [http://www.musikcube.com/ here]
| align="left" | Supports dynamic playlists and advanced SQL capabilities
|}

===Mac OS X===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #79C753; margin-bottom: 20px;"
|- style="background:#79C753;"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:450px;" | Description
|-
! align="left" | [[foobar2000]]
| Free
| [https://www.foobar2000.org/mac/ here]
| align="left" | Most of the features implemented are known to work reasonably well.
|- style="background-color: #eeeeee;"
! align="left" | [[VOX]]
| Free
| [https://vox.rocks/mac-music-player here]
| align="left" | Mac Music Player for Hi-Res music through the popular sources.
|-
! align="left" | Cog
| GPL
| [http://cogosx.sourceforge.net/ here]
| align="left" | An open-source digital audio player for OS X.
|- style="background-color: #eeeeee;"
! align="left" | Play
| GPL
| [http://sbooth.org/Play/ here]
| align="left" |Play is an application for playing and managing audio files.
|-
! align="left" | [[VLC]]
| LGPL
| [http://www.videolan.org/vlc// here]
| align="left" | VLC media player is a highly portable multimedia player and multimedia framework capable of reading most audio and video formats as well as DVDs, Audio CDs VCDs, and various streaming protocols.
|}

===Linux===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #D65076; margin-bottom: 20px;"
|- style="background:#D65076;"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:450px;" | Description
|-
! align="left" | [[Amarok]]
| GPL
| [http://amarok.kde.org/ here]
| align="left" | Popular open-source KDE audio player similiar to Foobar2000
|- style="background-color: #eeeeee;"
! align="left" | Audacious
| [https://github.com/audacious-media-player/audacious/blob/master/COPYING BSD]
| [http://audacious-media-player.org/ here]
| align="left" |Audacious is an open source audio player
|-
! align="left" | Clementine
| GPL
| [http://www.clementine-player.org/ here]
| align="left" | Cross platform media player, a port of [[Amarok]] 1.4 to the Qt 4 and GStreamer framework, can be controlled with a Wii remote
|- style="background-color: #eeeeee;"
! align="left" | DeaDBeeF
| GPL
| [http://deadbeef.sourceforge.net/ here]
| align="left" | Lightweight music player for Linux, GUI similar to [[Foobar2000]]
|-
! align="left" | Quod Libet
| GPL-2.0
| [https://quodlibet.readthedocs.io/en/latest/ here]
| align="left" | GTK+-based audio player written in Python, using the Mutagen tagging library. It’s designed around the idea that you know how to organize your music better than we do. It lets you make playlists based on regular expressions (don’t worry, regular searches work too). It lets you display and edit any tags you want in the file, for all the file formats it supports.
|- style="background-color: #eeeeee;"
! align="left" | [[Rhythmbox]]
| GPL
| [http://projects.gnome.org/rhythmbox/ here]
| align="left" | GNOME music player
|-
! align="left" | [[VLC]]
| LGPL
| [http://www.videolan.org/vlc// here]
| align="left" | VLC media player is a highly portable multimedia player and multimedia framework capable of reading most audio and video formats as well as DVDs, |Audio CDs VCDs, and various streaming protocols.
|- style="background-color: #eeeeee;"
! align="left" | [[XMMS]]
| GPL
| [http://www.xmms.org/ here]
| align="left" | Popular open-source audio player similiar to Winamp
|}

=== command-line(Shell) players ===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #98DDDE; margin-bottom: 20px;"
|- style="background:#98DDDE;"
! style="width:170px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:350px;" | Description
|-
! align="left" | mpg123
| LGPL
| [http://www.mpg123.org/ here]
| align="left" | mpg123 is a real time MPEG audio player/decoder
|- style="background-color: #eeeeee;"
! align="left" | mplayer for windows
| GPL v2
| [http://mplayerwin.sourceforge.net/ here]
| align="left" | MPlayer is a free and open source media player.
|-
! align="left" | mpv
| GPL v2
| [https://mpv.io/ here]
| align="left" | mpv is a free (as in freedom) media player for the command line. It supports a wide variety of media file formats, audio and video codecs, and subtitle types. also mpv comes with easy user interface. supported platforms Windows, Linux, Mac.
|}

==Tagging Utilities==
===Windows===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #00A1F1; margin-bottom: 20px;"
|- style="background:#00A1F1"
! style="width:150px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:500px;" | Description
|-
! align="left" | MP3 Book Helper
| Free
| [http://mp3bookhelper.sourceforge.net/ here]
| align="left" | Tags [[ID3v1]], ID3v2.3, and Vorbis comments. Features: FreeDB, unicode, guessing and matching, and supporting PAR, SFV, SV, and NFO generation.
|- style="background-color: #eeeeee;"
! align="left" | [[MP3tag]]
| Free
| [http://www.mp3tag.de/ here]
| align="left" | Tags all files supporting [[ID3]], [[APEv2]], and [[Vorbis_Comment|Vorbis Comments]], not only MP3s
|-
! align="left" | Tag & Rename
| Shareware
| [http://www.softpointer.com/tr.htm here]
|
|- style="background-color: #eeeeee;"
! align="left" | TagScanner
| Free
| [http://www.xdlab.ru/en/index.htm here]
| align="left" | Tag editor with built-in audio player.
|-
! align="left" | WMP Tag Plus 2.0
| Free
| [http://bmproductions.fixnum.org/wmptagplus/ here]
| align="left" | Software to integrate other tag format than [[ID3]] into Microsoft Windows Media Player 11.
|}

===Mac OS X===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #79C753; margin-bottom: 20px;"
|- style="background:#79C753;"
! style="width:150px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:320px;" | Description
|-
! align="left" | Tag
| GPL
| [http://sbooth.org/Tag/ here]
| align="left" | An open-source tagging application for OS X
|}

===Linux===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #D65076; margin-bottom: 20px;"
|- style="background:#D65076;"
! style="width:150px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:450px;" | Description
|-
! align="left" | [[Beets]]
| MIT
| [http://beets.io/ here]
| align="left" | Cross-platform open source tagging application written in Python, CLI only. Uses the Musicbrainz and Mutagen libraries, still in beta. Mostly automatic, minimal user input required. Many features and plugins. (Read the documentation)
|- style="background-color: #eeeeee;"
! align="left" | EasyTAG
| GPL
| [https://wiki.gnome.org/Apps/EasyTAG here]
| align="left" | Gnome tagging utility
|-
! align="left" | Ex Falso
| GPL-2.0
| [https://quodlibet.readthedocs.io/en/latest/guide/commands/exfalso.html here]
| align="left" | Ex Falso displays and edits audio metadata tags. Supported formats include MP3, Ogg Vorbis, FLAC, Musepack (MPC), WavPack, and MOD/XM/IT.
|- style="background-color: #eeeeee;"
! align="left" | Puddletag
| GPLv3
| [http://docs.puddletag.net/index.html here]
| align="left" | Puddletag is a Linux audio tag editor similar to Mp3tag
|}

==Lossy Audio Encoders/Decoders ==
Lossy audio main focus is to shrink large files to small, lossy is ideal for internet transport and on the go device (Mobile Phone / Players).

{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #F6D155; margin-bottom: 20px;"
|- style="background:#F6D155;"
! style="width:100px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:500px;" | Description
! style="width:100px;" | Forum
|-
! align="left" | [[MP3]]
| GPL
| [https://lame.sourceforge.net/ About] / [https://sourceforge.net/projects/lame/files/lame/ Source] / [https://www.rarewares.org/mp3-lame-bundle.php Windows]
| align="left" | LAME is a lossy audio compression.
| MP3 [https://hydrogenaud.io/index.php?board=55.0 Forum]
|- style="background-color: #eeeeee;"
|! align="left" | Ogg [[Vorbis]]
| GPL
| [https://xiph.org/vorbis/ About] / [https://gitlab.xiph.org/xiph/vorbis-tools Source] / [https://www.rarewares.org/ogg-oggenc.php Windows]
| align="left" | Ogg Vorbis is a lossy audio compression.
| Ogg Vorbis [https://hydrogenaud.io/index.php?board=57.0 Forum]
|-
|! align="left" | [[Musepack]]
| GPL
| [https://www.musepack.net/ here]
| align="left" | Musepack is a lossy audio compression.
| Musepack (MPC) [https://hydrogenaud.io/index.php?board=11.0 Forum]
|--
! align="left" | [[Opus]]
| GPL
| [http://www.opus-codec.org/ here]
| align="left" | Opus is a totally open, royalty-free codec. It is primarily designed for interactive speech and music transmission over the Internet.
| opus [http://www.hydrogenaudio.org/forums/index.php?showforum=71 Forum]
|- style="background-color: #eeeeee;"
! align="left" | qaac
| GPL
| [https://sites.google.com/site/qaacpage/home here]
| align="left" | qaac is a command line AAC/ALAC encoder frontend based on Apple encoder.
| qaac.AAC [http://www.hydrogenaudio.org/forums/index.php?showtopic=85135 Forum]
|-
|}

*Lame/Ogg Builds (Windows)
Looking for Windows Builds, Options available to you : *Developer Site, *Git, *[http://www.hydrogenaudio.org/ Hydrogenaudio Forum], *[http://www.rarewares.org/ Rarewares]

*Ogg [[Vorbis]],
In addition, the [[Lancer]] suite — a highly SSE-optimized suite of utilities and libraries — are available at [http://homepage3.nifty.com/blacksword/ this page] ''(in Japanese)''. See [[Lancer#Platform-specific Builds|this section]] for information about the different builds.

== Lossless Audio Encoders/decoders ==
Lossless Audio is aimed towards '''high quality audio''', also suitable for high quality backups.

{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #F6D155; margin-bottom: 20px;"
|- style="background:#F6D155;"
! style="width:100px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:500px;" | Description
! style="width:100px;" | Forum
|-
! align="left" | [[FLAC]]
| GPL
| [https://xiph.org/flac/ here]
| align="left" | FLAC is a lossless audio compression.
| flac [https://hydrogenaud.io/index.php/board,67.0.html Forum]
|- style="background-color: #eeeeee;"
! align="left" | [[Monkey's Audio]]
|
| [https://www.monkeysaudio.com/ here]
| align="left" | Monkey's Audio is a lossless audio compression. also Monkey's Audio has a nice GUI converter, ideal for converting (.WAV to .APE)
|
|-
! align="left" | [[WavPack]]
| GPL
| [http://www.wavpack.com/ here]
| align="left" | WavPack is a hybrid lossless wavefile compressor.
| WavPack [http://www.hydrogenaudio.org/forums/index.php?showforum=68 Forum]
|-
|}

*Flac Builds (Windows)
Looking for Windows Builds, Options available to you : *Developer Site, *Git, *[http://www.hydrogenaudio.org/ Hydrogenaudio Forum], *[http://www.rarewares.org/ Rarewares]

==Transcoders==
''Note: Although these tools may convert from one encoding to another, please remember that [[transcoding]] to any [[lossy]] encoding will result in a degraded quality.''
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #55B4B0; margin-bottom: 20px;"
|- style="background:#55B4B0;"
! style="width:150px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:270px;" | Description
| style="width:100px;" | Forum
|-
! align="left" | dBpowerAMP
| Shareware
| [http://www.dbpoweramp.com/dmc.htm here]
| align="left" | dBpoweramp Music Converter
|- style="background-color: #eeeeee;"
! align="left" | [[foobar2000]]
| Freeware
| [http://www.foobar2000.org/encoderpack here]
| align="left" | Free Encoder Pack for foobar2000.
|[https://hydrogenaud.io/index.php/topic,108593.msg934566/topicseen.html#new Forum]
|-
! align="left" | [[fre:ac ]]
| GPL
| [http://www.freac.org/ here]
|- style="background-color: #eeeeee;"
! align="left" | ferocious
| free
| [https://github.com/jniemann66/ferocious here]
|
| [https://hydrogenaud.io/index.php/topic,111777.msg921198.html Forum]
|-
! align="left" | BatchEncoder
| MIT license
| [https://github.com/wieslawsoltes/BatchEncoder here]
|
| [https://hydrogenaud.io/index.php/topic,50822/topicseen.html Forum]
|-style="background-color: #eeeeee;"
! align="left" | WinLAME
| GPL
| [http://winlame.sourceforge.net/ here]
|-
! align="left" | LossyFlacGUI
|
| [https://hydrogenaud.io/index.php/topic,113178.0.html here]
| align="left" | Optimize flac Audio file.
| [https://hydrogenaud.io/index.php/topic,113178.0.html Forum]
|-
! align="left" | [[Easy Audio Sync]]
| Unlicense
| [https://github.com/complexlogic/EasyAudioSync here]
| align="left" | Mass transcoding utility.
|
|}

==Processing utilities==
===Windows===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #00A1F1; margin-bottom: 20px;"
|- style="background:#00A1F1;"
! style="width:120px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:500px;" | Description
|-
! align="left" | [[lossyWAV]]
| GPL
| [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=56129&view=findpost&p=504087 here]
| align="left" | lossyWAV is a lossy pre-processor for [[Wikipedia:Pulse-code modulation|PCM]] (uncompressed) WAV files. It reduces [[Wikipedia:Audio bit depth|bit depth]] of the input signal, which, when used in conjunction with certain lossless codecs, reduces the bitrate of the encoded file significantly.
|}
===Linux===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #D65076; margin-bottom: 20px;"
|- style="background:#D65076;"
! style="width:150px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:450px;" | Description
|-
! align="left" | [[lossyWAV]] for POSIX
| GPL
| [https://github.com/MoSal/lossywav-for-posix here]
| align="left" | A POSIX build for lossyWAV.
|}

==File Archiver - Plugins==
===Windows===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #00A1F1; margin-bottom: 20px;"
|- style="background:#00A1F1;"
! style="width:120px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:500px;" | Description
|-
! align="left" | WavPack7z
|
| [http://www.tc4shell.com/en/7zip/wavpack7z/ here]
| align="left" | WavPack7z is a plugin for the popular 7-Zip archiver. It allows you to pack uncompressed PCM audio data using the highly efficient WavPack compression algorithm.
discussion in the [https://hydrogenaud.io/index.php/topic,117037.0.html forum]
|}

[[Category:Software]]

Easy Audio Sync

2023-05-25T04:39:07Z

Complexlogic: Created page with "{{Software Infobox | name = Easy Audio Sync | screenshot = 300px | caption = Easy Audio Sync running on..."

{{Software Infobox
| name = Easy Audio Sync
| screenshot = [[File:Easyaudiosync usage.png|300px]]
| caption = Easy Audio Sync running on Linux
| developer = complexlogic
| released = 2023-05-18
| stable_release = 1.0
| stable_release_date = 2023-05-18
| operating_system = Windows, macOS, Linux
| use = Full library transcoding
| license = Unlicense
| website = [https://github.com/complexlogic/EasyAudioSync]
}}
Easy Audio Sync is an audio library syncing and conversion utility. The intended use is syncing an audio library with many lossless files to a mobile device with limited storage.

==Installation==
Easy Audio Sync is compatible with Windows, macOS and Linux.

===Windows===
Easy Audio Sync is compatible with Windows 10 and later. Download the installer executable from the [https://github.com/complexlogic/EasyAudioSync/releases/latest latest release on GitHub], run it, and follow the guided installation process.

===macOS===
Builds are available for both Intel and Apple Silicon based Macs. Download the appropriate disk image for your hardware from the [https://github.com/complexlogic/EasyAudioSync/releases/latest latest release on GitHub] and install via drag and drop.

===Linux===
Builds are available for APT-based Linux distros and Fedora [https://github.com/complexlogic/EasyAudioSync/releases/latest on GitHub]. Otherwise, you can build from source according to the provided build instructions.

==Usage==
Easy Audio Sync operates based on a source folder and a destination folder, where the source folder contains the primary music library, and the destination folder is the desired output location. After selecting the source and destination folders, click the "Sync" button to start the sync. The program will recreate the source's entire subfolder structure in the destination, copying or transcoding files as specified in the settings. See the [https://github.com/complexlogic/EasyAudioSync/blob/master/docs/settings.md settings documentation on GitHub] for help on configuring the program's settings.

The stop button next to the progress bar can be used stop the sync at any time. The worker threads are allowed to finish their current file operation before quitting to avoid leaving corrupted files in the destination. Consequently, it may take several seconds after the stop button is clicked for the sync to stop.

===Supported Formats===
The following audio formats are supported, per-mode:
{| class="wikitable"
|-
! Codec !! Copy !! Transcode Input !! Transcode Output
|-
| [[FLAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[ALAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WavPack]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[Monkey's Audio]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WAV]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[MP3]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[AAC]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Ogg Vorbis]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Opus]] || {{Yes|Yes}} || {{Yes|Yes}} || {{Yes|Yes}}
|-
| [[Musepack]] || {{Yes|Yes}} || {{Yes|Yes}} || {{No|No}}
|-
| [[WMA]] || {{Yes|Yes}} || {{No|No}} || {{No|No}}
|}

===Supported Encoders===
The following encoders are supported for transcoding
{| class="wikitable"
|-
! Codec !! Encoder(s)
|-
| MP3 || [[LAME]]
|-
| AAC || [[Fraunhofer FDK AAC]], [[Libavcodec AAC]]
|-
| Ogg Vorbis || libvorbis
|-
| Opus || libopus
|}

==See also==
* [[Transcoding]]
* [[Variable Bitrate]]

==External links==
* [https://github.com/complexlogic/EasyAudioSync/ Easy Audio Sync GitHub page]

[[Category:Software]]

File:Easyaudiosync usage.png

2023-05-25T04:25:23Z

Complexlogic:

ReplayGain

2023-05-13T16:27:09Z

Complexlogic: /* rsgain */

'''ReplayGain''' is the name of a technique invented to achieve the same perceived playback loudness of audio files. It defines an algorithm to measure the '''perceived''' loudness of audio data.

ReplayGain allows the loudness of each song within a collection of songs to be consistent. This is called 'Track Gain' (or 'Radio Gain' in earlier parlance). It also allows the loudness of a specific sub-collection (an "album") to be consistent with the rest of the collection, while allowing the dynamics from song to song on the album to remain intact. This is called 'Album Gain' (or 'Audiophile Gain' in earlier parlance). This is especially important when listening to classical music albums, because quiet tracks need to remain a certain degree quieter than the louder ones.

ReplayGain is different from [[Normalization|peak normalization]]. Peak normalization merely ensures that the peak amplitude reaches a certain level. This does not ensure equal loudness. The ReplayGain technique measures the ''effective power'' of the waveform (i.e. the RMS power after applying an "equal loudness contour"), and then adjusts the amplitude of the waveform accordingly. The result is that Replay Gained waveforms are usually more uniformly amplified than peak-normalized waveforms.

==Target loudness==
The target loudness of almost all ReplayGain utilities is 89 dB SPL when replayed in an SMPTE RP 200 calibrated system (an early departure from the proposal, endorsed by its author<ref>[http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=83397&view=findpost&p=721854 Does Replay gain work differtly in Media monkey]</ref>) — the ReplayGain proposal and SMPTE recommendation are 6dB lower.<ref>[http://www.mars.org/mailman/public/mad-dev/2004-February/000993.html ReplayGain discussion at mad-dev]</ref>

==Clipping==
Audio is generally recorded such that the loudest sounds don't clip, but the use of ReplayGain can cause clipping if the average volume of a song is below the target level. That is, upon playback, the volume of a quiet song is increased, so the parts of the song with above-average loudness, especially in the bass frequencies, will exceed the limits of the format and will be distorted. Whether this distortion is audible depends on the sounds in question, and the listener's sensitivity.

Implementations deal with the risk of clipping in different ways. Some have a "pre-amp" feature which reduces (or boosts) the original audio's level by a certain amount before doing whatever is needed for ReplayGain. Some have a "prevent clipping" feature to reduce the amount of ReplayGain adjustment to whatever amount would keep clipping from occurring, based on peak info stored in the file's metadata (thus reducing the effectiveness of ReplayGain). Some recommend using a compressor/limiter DSP to prevent or reduce clipping, regardless of whether it was caused by ReplayGain.

== Implementations ==
There are different ReplayGain implementations, each with its own uses and strength. Most use [[metadata]] to indicate the level of the volume change that the player should make. Some modify the audio data itself, and optionally use metadata as well. There are advantages and disadvantages to both methods.

In the metadata method, information on both types of ReplayGain (Track Gain and Album Gain) can be stored. The volume-change information can be very precise. If audio data was also changed, the metadata can contain "undo" info. Not all audio players/decoders know how to read and use ReplayGain information stored in metadata. And there's no standard for where and how ReplayGain info is stored; each implementation uses different formats and puts the info in different locations.

In the audio data method, the file's actual audio data is modified so that its natural/default playback volume is at the target level. In this scenario, only one type of ReplayGain (Track Gain or Album Gain) can be applied. If no "undo" info is saved somewhere, it may not be possible to restore the original audio data. Limitations of the audio file format may prevent precise (finely tuned) gain adjustments with this method. For example, MP3 and AAC files can only be losslessly modified in 1.5 dB steps. Depending on the audio file format, the process may also be lossy in the sense that it could irreversibly push a signal above the format's maximum amplitude (resulting in clipping) or below the minimum (resulting in silence).

=== MP3Gain ===
[[MP3Gain]] is an implementation of ReplayGain. It can be used to just analyze files & recommend changes or to also modify the gain. If modifying the gain, it always modifies the global gain fields in the MP3 audio data. It can add somewhat precise metadata, including undo info. The gain can be modified to any target dB, or it can be changed by a specified amount. For balance correction, user-specified changes can even be made on just one channel in simple L/R stereo-mode files (not joint stereo).

* Format: [[MP3]]
* Method: Audio + Meta (in APE tag), or Audio only
* APE tag fields (ASCII bytes):
** <code>MP3GAIN_MINMAX ###,###</code> - minimum & maximum global gain values for this file. 3 digits, zero-padded if necessary.
** <code>MP3GAIN_ALBUM_MINMAX ###,###</code> - minimum & maximum global gain values across a set of files scanned as an album. Optional.
** <code>MP3GAIN_UNDO +###,+###,N</code> - the global gain adjustment to restore the original values in the left and right channels, respectively, followed by an indicator of whether to wrap at the extremes (<code>N</code> means no, <code>W</code> means yes). The adjustment values are 3 digits, zero-padded, preceded by a sign (<code>+</code> or <code>-</code>).
** <code>REPLAYGAIN_TRACK_GAIN +#.###### dB</code> - The value is always 9 characters including the sign and decimal point. Examples: <code>+0.424046</code> and <code>-10.38500</code>
** <code>REPLAYGAIN_TRACK_PEAK #.###### dB</code> - The value is always 8 characters including the decimal point. Example: <code>0.149923</code>
** <code>REPLAYGAIN_ALBUM_GAIN +#.###### dB</code> - The value is always 9 characters including the sign and decimal point. Optional.
** <code>REPLAYGAIN_ALBUM_PEAK #.###### dB</code> - The value is always 8 characters including the decimal point. Optional.
* Limitations: Although the metadata, if written, contains precise adjustment & peak values, the audio data modifications are limited to 1.5dB steps and may become irreversible (however, that's a very rare condition; see the [http://www.hydrogenaudio.org/forums/lofiversion/index.php/t34154.html "mp3gain is NOT lossless" forum thread])
* http://mp3gain.sourceforge.net/

=== AACGain ===
[[AACGain]] is a modified version of MP3Gain that works on both MP3 and AAC files.

* Format: [[MP3]], [[AAC]] (with or without MP4 container)
* Method: Audio + Meta, or Audio only
* Limitations: Limited to 1.5dB steps mode, may become irreversible (same caveat as for MP3Gain)
* http://aacgain.altosdesign.com/

=== [[LAME]] ===
* Method: Header ([http://gabriel.mp3-tech.org/mp3infotag.html mp3infotag])
* Notes:
** Tags added during encoding; not supported by any player yet; Track Gain only
** Replay Gaining MP3's is usually done using MP3Gain (see [[ReplayGain#MP3Gain|above]]) or [[ReplayGain#foobar2000 ReplayGain scanner|foobar2000]]
* http://lame.sourceforge.net/

=== [[Musepack]] ReplayGain ===
* Method: Header (similar to Meta data method)
* Notes: ReplayGain values are stored in the header and ReplayGain is part of the Musepack specifications; therefore any Musepack decoder that does not support ReplayGain can be considered broken.
* http://www.musepack.net/

=== VorbisGain ===
* Format: (Ogg) [[Vorbis]]
* Method: Meta (in [[Vorbis comment]])
* http://www.sjeng.org/vorbisgain.html
** new compiles of VorbisGain at [http://www.rarewares.org/ogg.html www.rarewares.org]
:'''''Note:''' Andavari has provided a very useful script to integrate VorbisGain, which is a CLI tool, into Windows Explorer. Please (Ogg) [[Vorbis#ReplayGain|check this section]].

=== FLAC / METAFLAC ===
* Format: [[Free Lossless Audio Codec|FLAC]]
* Method: Meta (in [[Vorbis comment]])
* http://flac.sf.net

=== WavPack / WVGAIN ===
* Format: [[WavPack]]
* Method: Meta (in [[APEv2]] tag)
* http://www.wavpack.com

=== Wavegain ===
* Format: waveform
* Method: Audio
* Limitations: Irreversible
* http://www.rarewares.org/others.php#wavegain

=== MusicPlayer ===
* Custom implementation, not derived from the original MP3Gain one (but inspired from). As far as I know, all other implementations are directly derived from the MP3Gain (gain_analysis.c, which is GPL) source.
* Format: any that FFmpeg supports
* Method: Audio
* Limitations: Doesn't modify the files at all. Stores the value in own database. Used only for playback.
* https://github.com/albertz/music-player

=== [[foobar2000]] ReplayGain scanner ===
* Format:
** [[MP3]]: Values written to [[ID3v2]] (default) or [[APEv2]] tags. A separate function can be invoked to apply the tagged Track or Album Gain to the MP3 global gain fields (as MP3Gain does), and rewrite any existing tags to account for the peak change and compensate for the difference from 89 dB. The 89 dB reference level for tags isn't configurable, but the reference level applied to the global gain fields is (it's under Preferences > Advanced > Tools > ReplayGain Scanner > Target MP3 alteration volume level).
** [[Musepack]]: Values written to header.
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** [[WavPack]]: Values written to [[APEv2]] tags.
** [[AAC]]: Values written to [[APEv2]] tags. As with MP3, it is also an option to apply gain via a separate function.
** [[MP4]]: Uses its own iTunes-compatible tagging system (though iTunes does not support ReplayGain).
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** [[APE]]: Values written to [[APEv2]] tags.
** Modules ([[MOD]] etc.): Optionally saved into [[APEv2]] tags.
* http://foobar2000.org

=== [[MediaMonkey]] ===
* Format:
** [[MP3]]: Values written to [[APEv2]] or [[ID3v2]] tags.
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** [[WMA]]: Values stored in MediaMonkey's MDB database.
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** [[APE]]: Values written to [[APEv2]] tags.
** [[WAV]]: Values stored in MediaMonkey's MDB database.
** [[MPC]]: Internal gain Structure.
* In addition to tags, all ReplayGain values are also stored in MediaMonkey's MDB database
* Album/Audiophile ReplayGain not supported until v3.0 (Dec 2007); support during burning & ripping added in 3.1 (Jun 2009)
* Also capable of (irreversibly) changing the volume of MP3 tracks, similar to [[MP3Gain]]
* http://www.mediamonkey.com/

=== [[Winamp]] ReplayGain scanner===
* Format:
** [[MP3]]: Values written to [[ID3v2]] tags.
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** [[WMA]]: Values stored in Windows Media Audio tags.
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** [[APE]]: Values written to [[APEv2]] tags.
** [[AAC]]: Values written to [[APEv2]] tags.
** [[MP4]]
** [[TAK]]: Values written to [[APEv2]] tags.
* Support Album/Track Gain

=== [[loudgain]] ===
* Format:
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** MP2, [[MP3]]: Values written to [[ID3v2]] tags (ID3v2.3/ID3v2.4 selectable).
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** (Ogg) [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** (Ogg) [[Speex]]: Values written to [[Vorbis comment]].
** [[Opus]]: Values written to [[Vorbis comment]], based on -23 LUFS Opus standard. Only <code>R128_TRACK_GAIN</code> and <code>R128_ALBUM_GAIN</code> are written, but the calculated ''true peak'' value can still be used to reduce the gain values ([[Clipping]] prevention).
** [[MP4]], [[M4A]]: Uses its own iTunes-compatible tagging system (though iTunes does not support ReplayGain). ReplayGain values are stored under <code>----:com.apple.iTunes:…</code>. This is for [[AAC]] and [[ALAC]] in [[MPEG-4]] containers.
** [[ASF]], [[Windows Media Audio|WMA]]: Values written to WMA tags, no prefix.
** [[WAV]]: Values written to the <code>ID3 </code> chunk, in [[ID3v2]] (ID3v2.3/ID3v2.4 selectable) format. Using the <code>bext</code> chunk (for BWF v2) isn’t (yet) supported, but won’t be destroyed on writing.
** [[Audio Interchange File Format|AIFF]]: Values written to the <code>ID3 </code> chunk, in [[ID3v2]] format.
** [[WavPack]]: Values written to [[APEv2]] tags.
** [[Monkey's Audio]] (APE): Values written to [[APEv2]] tags.
* Follows EBU R128, ITU BS.1770 and the [[ReplayGain 2.0 specification]].
* ''Never'' touches the actual audio data but ''only writes RG2 tags''.
* Uses ''true peak'' values calculated by oversampling to 192 kHz, using a custom polyphase FIR interpolator that will oversample 4x for sample rates < 96 kHz, 2x for sample rates < 192 kHz and leave the signal unchanged for 192 kHz.
* ''Clipping prevention'' can be used to lower the ReplayGain values to a safe margin (default -1 dBTP, can be changed).
* Many options for special cases: force RG tags upper-/lowercase, add extra tags (LRA, Reference loudness), strip unwanted tag types (APEv2 from MP2/MP3, ID3 from WavPack), tab-delimited table output for analysis with CSV file.
* ''Linux'' Free and Open Source software, can be installed on ''MacOS'' using ''HomeBrew'', on ''Windows 10'' using the Linux ''bash''.
* Also installs a <code>rgbpm</code> bash script for mass-tagging, which can be adapted to the user’s needs.
* '''Warning:''' Loudgain relies on standard libraries like ''TagLib''. Linux distros (except rolling releases) sometimes deliver outdated libraries, so be sure you use the latest version of ''TagLib''. Version 1.11.1 had a nasty bug for a while that [https://hydrogenaud.io/index.php/topic,118085.msg974957.html#msg974957 could corrupt Ogg Vorbis files]. This has been fixed in the meantime but the TagLib version not updated. Loudgain comes with a (slower) static version called <code>loudgain.static</code> in the repo’s <code>/bin</code> folder that doesn’t expose the bug and can also be used on older Linux versions (like Ubuntu 14.04, Linux Mint 17).
* https://github.com/Moonbase59/loudgain
* Bug tracker: https://github.com/Moonbase59/loudgain/issues

=== [[rsgain]] ===
rsgain is a ReplayGain 2.0-compatible command line utility designed with a "batteries included" philosophy.

Features:
* Cross-platform Windows/macOS/Linux
* Supports all popular audio formats
* Simplified "Easy Mode" command line syntax supports recursive, directory-based scanning
* Multithreaded scanning option that provides significant speed improvement with full library scans
* Option to skip files with existing ReplayGain metadata
* Scan presets allow the user to save advanced settings for consistent use

== Players support ==
ReplayGain being present in the specs of the FLAC, Musepack, and APE formats, any player that support those formats usually supports ReplayGain.

The situation with MP3 is rather different, as it was not part of the MP3 specs. The APEv2 tags metadata implementation is somewhat becoming the de-facto standard.

=== Windows ===
* [[foobar2000]] supports ReplayGain in all possible aspects.
* [[Winamp]] supports ReplayGain in album or track mode.
* [[MediaMonkey]] supports ReplayGain, with many configuration options.
* [[XMPlay]] recently implemented ReplayGain
* [https://picard.musicbrainz.org/ MusicBrainz Picard] is a tagger (and player) that tags using metadata from the MusicBrainz.org database. Picard supports ReplayGain tags for files tagged with APE, ASF, ID3, MP4 and Vorbis tags. There is a ReplayGain plugin that can be used to calculate the ReplayGain values for both Albums and Tracks.

''...and probably others.''

=== Linux ===
* [[XMMS]]. Reads ReplayGain from [[Free Lossless Audio Codec|FLAC]], [[Musepack]], (Ogg) [[Vorbis]] ..
:For [[MP3]], use the CVS version of the [http://xmms-mad.sourceforge.net/ xmms-mad] mp3 plugin (it's not yet released as binary, furthermore not available in distribs' versions for now. Meanwhile binaries are available here: [http://perso.crans.org/~krempp/xmms-mad/ custom binaries])
* [[amarok]]. By using the amarok-script [http://kde-apps.org/content/show.php?content=26073 ReplayGain]
:And possibly others, since [http://developer.kde.org/~wheeler/taglib.html TagLib] added support for [[APEv2]] tags in [[MP3]] files, players using this library (like [[amaroK]] and [[JuK]]) might support that kind of ReplayGain tags in the near future.
* [http://www.sacredchao.net/quodlibet Quod Libet] reads ReplayGain from (Ogg) [[Vorbis]], [[MP3]], [[Free Lossless Audio Codec|FLAC]], and [[Musepack]].
:Requires support to be enabled (via the appropriate python bindings and libraries) for the above formats. Does not support ReplayGain values stored in [[APEv2]] tags in [[MP3]]s. ReplayGain values are stored in RVA2 id3v2.4 frames. See the [http://www.sacredchao.net/quodlibet/wiki/Development/ID3Notes Quod Libet RVA2 / ReplayGain notes].
* [http://www.musicpd.org/ Music Player Daemon] (MPD) reads ReplayGain from (Ogg) [[Vorbis]], [[Free Lossless Audio Codec|FLAC]], and [[Musepack]].
:foobar2000-style TXXX frames in [[MP3]]s are also supported in the latest development releases.
* [http://www.mplayerhq.hu/ MPlayer]. Mplayer support for ReplayGain is codec dependent.
:Codecs that are known to support ReplayGain: vorbis
:Because of this, you need to prioritize the codecs that support it, or choose it individually on the command line. To add it to the command line, add an -ac [codec] option after each file that you want to choose the codec for, or at the beginning to make it apply to all files listed. To prioritize the codecs by default, list them in a line in mplayer.conf:
ac=[codec],[othercodec],vorbis,mad,
* [http://idjc.sourceforge.net/ IDJC] (Internet DJ Console) reads ReplayGain from [[Free Lossless Audio Codec|FLAC]], (Ogg) FLAC, (Ogg) [[Vorbis]], MP2 (audio), [[MP3]], [[Opus]], but only the ''lowercase'' tags. There is a [https://sourceforge.net/p/idjc/bugs/100/ ticket] open to handle tags case-insensitively.
* [https://picard.musicbrainz.org/ MusicBrainz Picard] is a tagger (and player) that tags using metadata from the MusicBrainz.org database. Picard supports ReplayGain tags for files tagged with APE, ASF, ID3, MP4 and Vorbis tags. There is a ReplayGain plugin that can be used to calculate the ReplayGain values for both Albums and Tracks.
* [https://www.videolan.org/vlc/ VLC] supports ReplayGain in many file formats, but usually only the ''uppercase'' variant of the tags.
* [https://kodi.tv/ KODI] reads ReplayGain from nearly all formats, but usually only the ''lowercase'' variant of the tags.

=== Portable devices ===
[http://www.rockbox.org/ Rockbox] supports ReplayGain (in album or track mode) for most formats, including WMA, MP1/2/3, AAC, ALAC, Musepack, Monkey's Audio, Wavpack, FLAC and Vorbis. Note that ReplayGain is only supported when using the respective codec's native tagging format. For example: ReplayGain stored in APEv2 tags is not supported for MP3, rather ID3v2.x tags are expected.

Sandisk Sansa Fuze with firmware 1.02.26 and 2.02.26

Sandisk Sansa Clip+

The iPod features ''Soundcheck'', which seems to produce roughly the same normalization gains as ReplayGain, but doesn't provide an Album Gain.

=== Hi-Fi ===
Slim Devices, a company owned by Logitech Inc, supports ReplayGain on both of their hi-end audiophile players, known as the [[Slim Devices Transporter|Transporter]] and the [[Slim Devices Squeezebox|Squeezebox]].

BluOS also supports ReplayGain with the selection of album- or track-gain and a so called Smart option that decides between the two by itself.
NAD devices that use BluOS consequently also support ReplayGain.

==Notes==
<references/>

== See also ==
* [[ReplayGain specification]]

== External links ==
* [http://en.wikipedia.org/wiki/Replay_Gain ReplayGain] at Wikipedia
* [http://www.bobulous.org.uk/misc/Replay-Gain.html ReplayGain using foobar2000] (how to use ReplayGain in Windows using foobar2000).
* [http://www.bobulous.org.uk/misc/Replay-Gain-in-Linux.html ReplayGain in Linux] (how to use ReplayGain in Linux using foobar2000 and Wine, or using metaflac or vorbisgain).

[[Category:Technical]]
[[Category:Metadata]]

Rsgain

2023-05-13T15:43:12Z

Complexlogic:

{{Software Infobox
| name = rsgain
| screenshot = [[File:rsgain_help.png|300px]]
| caption = Default help screen in a Linux terminal
| developer = complexlogic
| released = 2022-05-10
| stable_release = 3.3
| stable_release_date = 2023-04-23
| operating_system = Windows, macOS, Linux, BSD
| use = ReplayGain tagging
| license = BSD license
| website = [https://github.com/complexlogic/rsgain]
}}
'''rsgain''' ('''r'''eally '''s'''imple '''gain''') is a free and open source [[ReplayGain 2.0 specification|ReplayGain 2.0]] tagging utility for Windows, macOS, and Linux. rsgain applies loudness metadata tags to your files, while leaving the audio stream untouched. A [[ReplayGain#Players_support|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|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|MusicBrainz Picard Plugin]] for more information.

==Installation==
rsgain is available in source form on all platforms, and executable form on some platforms.

===Windows===
rsgain is compatible with Windows 10 and later. Download the win64 .zip file from the [https://github.com/complexlogic/rsgain/releases/latest latest release on GitHub], and extract its contents to a directory of your choice.

It is recommended to add the directory to your {{code|Path}} system environment variable so you can invoke the program with the {{code|rsgain}} command instead of the path to its .exe file. In the Windows taskbar search, type "env", then select "Edit the system environment variables". In the resulting window, click the "Environment variables" button. In the next window under "System variables", select "Path", then press Edit. Add the folder that you extracted {{code|rsgain.exe}} to in the previous step.

===macOS===
There is a Homebrew formula available for macOS users. Make sure you have Homebrew and the latest available Xcode installed. Execute the following command to install:

{{code|brew install complexlogic/tap/rsgain}}

===Linux===
An amd64 .deb package is provided on the [https://github.com/complexlogic/rsgain/releases/latest GitHub release page]. It is installable on Debian Bullseye and later, Ubuntu 21.04 and later. There is also a .rpm package for Fedora users. An [https://aur.archlinux.org/packages/rsgain-git AUR package] is available for Arch/Manjaro users.

Users of other distros will need to build from source. See the [https://github.com/complexlogic/rsgain/blob/master/docs/BUILDING.md#building build instructions on GitHub].

===FreeBSD===
Available via ports tree or using packages (2023Q1 and later) as listed below:
{{code|cd /usr/ports/audio/rsgain && make install clean}}
{{code|pkg install rsgain}}

==Format Support==
rsgain has support for the following file formats:
* [[MP2]]/[[MP3]]
* [[FLAC]]
* [[Ogg]] ([[Vorbis]], [[Speex]])
* [[Opus]]
* [[M4A]] ([[AAC]], [[ALAC]])
* [[WMA]]
* [[Musepack]]
* [[WAV]]
* [[AIFF]]
* [[Wavpack]]
* [[Monkey's Audio]]

==Usage==
rsgain contains two separate user interfaces: Easy Mode and Custom Mode. The distinction between the two modes is rooted in the history of ReplayGain utilities.

Legacy ReplayGain tagging utilities such as mp3gain did not support recursive directory-based scanning. The user was required to manually specify a list of files on the command line, preceded by options which were numerous and complex. This interface provided a lot of power and flexibility, but it wasn't particularly user friendly. Performing a full library scan typically required the user to supplement the program with a wrapper script that traversed the directory tree and detected the files.

rsgain's Easy Mode ''is'' that wrapper script; the functionality is built-in to the program. In Easy Mode, the user simply points the program to their library and it will be recursively scanned with all recommended settings enabled by default.

The legacy-style interface has been retained as "Custom Mode" for users that require a higher level of control. Custom Mode is mostly used for scripting.

===Easy Mode===
Easy Mode recursively scans your entire music library using the recommended settings for each file type. Easy Mode is invoked with the command {{code|rsgain easy}} followed by the root of the directory you want to scan:

{{code|rsgain easy /path/to/music/library}}

{{code|rsgain easy "C:\path\to\music library"}}

Easy Mode assumes that you have you have your music library organized by album, so that each album is contained in its own folder. The album gain calculations rely on this assumption. If you do not have your music library organized by album, you should disable the album tags because the calculated values will not be valid. rsgain ships with a scan preset which can disable the album tags for you; invoke it with {{code|-p no_album}}. See the [[#Scan_Presets|Scan Presets]] section for more information about how the scan preset feature works.

====Multithreaded Scanning====
Easy Mode includes optional multithreaded operation to speed up the duration of a scan. Use the {{code|-m}} option, followed by the number of threads to create. The number of threads must not exceed the number that your CPU supports. For example, if you have a CPU with 4 threads:

{{code|rsgain easy -m 4 /path/to/music/library}}

If you don't know how many threads your CPU has, you can also specify {{code|-m MAX}} and rsgain will use the number provided by your operating system. This is useful for writing scripts where the hardware properties of the target machine are unknown.

Parallel scan jobs are generated on a ''per-directory'' basis, not a per-file basis. If you request 4 threads but there is only 1 directory to scan, a single thread will be working and the other 3 will sit idle the entire time. Multithreaded mode is optimized for scanning a very large number of directories. It is recommended to use multithreaded mode for full library scans and the default single threaded mode when incrementally adding 1 or 2 albums to your library.

The speed gains offered by multithreaded scanning are significant. With {{code|-m 4}} or higher, you can typically expect to see a 50-80% reduction in total scan time, depending on your hardware, settings, and library composition.

====Skip Files with Existing Tags====
rsgain has an option which will skip files with existing ReplayGain information, invoked by passing {{code|-S}} or {{code|--skip-existing}}. When enabled, rsgain will check whether the given file has a {{code|REPLAYGAIN_TRACK_GAIN}} tag, and skip scanning any files that do. If album tags are enabled, the files in the list will be judged collectively, i.e. if a single file is missing ReplayGain info, then all of them will be scanned.

This feature merely checks for the existence of the tags, and does not verify that the tags are complete, and are compatible with your current settings, e.g. target loudness. You should use this feature only if you are confident in the integrity of the files in the directory to be scanned. It's generally not a good idea to run this on files that you've recently download from the internet, which may have pre-existing ReplayGain information that was tagged by a different scanner.

====Logging====
You can use the {{code|-O}} option to enable scan logs. The program will save a tab-delimited file titled {{code|replaygain.csv}} with the scan results for every directory it scans. The log files can be viewed in a spreadsheet application such as Microsoft Excel or LibreOffice Calc.

====Scan Presets====
Easy Mode scans files with the following settings by default:
* -18 LUFS target loudness
* Album tags enabled
* Sample peak calculations for peak tags
* Clipping protection enabled for positive gain values only (0 dB max peak)
* Standard uppercase tags for all formats
* ID3v2.3 tags for ID3 formats
* Standard ReplayGain tags for Opus files

These settings are recommended for maximum compatibility with modern players. However, if you need one or more of the settings changed, you can use a preset file.

A preset file is an INI-formatted configuration file that contains sections enclosed in square brackets, and each section contains key=value pairs that correspond to settings. The first section in a presets file is titled "Global" and contains settings that will be applied to every format. The remaining sections pertain to a particular audio format, and the settings within them will only be applied to that format. This allows the user to define settings on a per-format basis. If a setting in the "Global" section is in conflict with one in the format-specific section, the format-specific value will always take precedence.

A preset is specified with the {{code|-p}} option, followed by the path to a preset file ''or'' a preset name. A preset name is the filename of a preset without the directory or .ini file extension; rsgain will search the default preset location(s) for the file based on your platform:
* On Windows, rsgain will search first in {{code|%USERPROFILE%\.rsgain\presets}}, then the folder {{code|presets}} in the same folder that contains {{code|rsgain.exe}}
* On Unix platforms, rsgain will search first in the user home directory: {{code|~/Library/rsgain/presets}} on Mac and {{code|~/.config/rsgain/presets}} on Linux (you need to create these directories if they don't already exist). If the requested preset name is not found in the home directory, rsgain will search {{code|<install prefix>/share/rsgain/presets}}

For example, rsgain ships with a preset {{code|ebur128.ini}}, which will scan files based on the EBU R 128 recommendations. You can invoke this preset with {{code|-p ebur128}}. rsgain also ships with a preset {{code|default.ini}}, which is pre-populated with all of the default settings. This preset is not intended to be used directly, but rather to serve as a base for users to create their own presets. As such, it is not recommended to overwrite it. Instead, save a copy when using it as a base.

The settings in a preset file are applied in an "overrides" fashion. In other words, any settings or formats you're not interested in can simply be deleted from the preset and the defaults will be used instead.

===Custom Mode===
Custom Mode provides a more complex command line syntax that is similar in nature to mp3gain, loudgain, and other legacy ReplayGain scanners. Only the most basic settings are enabled by default. Unlike Easy Mode, Custom Mode works with files, not directories. If you want recursive directory-based scanning, you will need to write a wrapper script.

Custom Mode is invoked with {{code|rsgain custom}} followed by options and a list of files to scan. For example, scan and tag a short list of MP3 files with album tags enabled:

{{code|rsgain custom -a -s i file1.mp3 file2.mp3 file3.mp3}}

See the command line help for all available options:

<pre>
Usage: rsgain custom [OPTIONS] FILES...
Custom Mode allows the user to specify the options to scan the files with. The
list of files to scan must be listed explicitly after the options.

Options:
-h, --help Show this help.

-a, --album Calculate album gain and peak.
-S, --skip-existing Don't scan files with existing ReplayGain information.

-s s, --tagmode=s Scan files but don't write ReplayGain tags (default).
-s d, --tagmode=d Delete ReplayGain tags from files.
-s i, --tagmode=i Scan and write ReplayGain 2.0 tags to files.

-l n, --loudness=n Use n LUFS as target loudness (-30 ≤ n ≤ -5).

-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.

-L, --lowercase Write lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF).
This is non-standard but sometimes needed.
-I 3, --id3v2-version=3 Write ID3v2.3 tags to MP2/MP3/WAV/AIFF (default).
-I 4, --id3v2-version=4 Write ID3v2.4 tags to MP2/MP3/WAV/AIFF.
-I keep, --id3v2-version=keep Keep file's existing ID3v2 version, 3 if none exists.

-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 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.
-O s, --output=s Output with sep header (needed for Microsoft Excel compatibility).
.
-q, --quiet Don't print scanning status messages.

Please report any issues to https://github.com/complexlogic/rsgain/issues
</pre>

===MusicBrainz Picard Plugin===
[https://picard.musicbrainz.org/ MusicBrainz Picard] is a free, cross-platform music tagging application. Picard features a robust plugin ecosystem that greatly extends its functionality. rsgain serves as the backend for the ReplayGain 2.0 plugin, which is available from the official plugins repository. Users that prefer a graphical interface over a command line interface can use this plugin to scan their music library.

To install the plugin, navigate to the Options menu in Picard. Select "Plugins" in the sidebar, then find "ReplayGain 2.0" and click the download button. The plugin itself does not include rsgain; you'll still need to download and install rsgain separately per the [[#installation|Installation]] section for your chosen platform.

You need to set the path to rsgain in the plugin settings. This field is pre-populated with the {{code|rsgain}} command. On Unix platforms, programs are typically installed into a directory that's already in your {{code|PATH}}, so no further action is necessary in that case. On Windows, you will need to either manually add the folder containing rsgain to your {{code|Path}} as per the installation instructions, or use the exact path to {{code|rsgain.exe}} in the plugin settings.

To use the plugin, add files to Picard and associate them with a release (so the files are in the right window). The plugin can scan albums or individual tracks. Select one or more albums or tracks, then right click and select "Plugins->Calculate ReplayGain" from the context menu. This calculates the ReplayGain information for the selected items, but does not tag the files. The new tags are available for viewing in the metadata window at the bottom. Click the save button to write the new tags to file.

==See also==
* [[ReplayGain]]
* [[ReplayGain 2.0 specification]]

==External links==
* [https://github.com/complexlogic/rsgain/ rsgain GitHub page]
* [https://en.wikipedia.org/wiki/EBU_R_128 EBU R128]

[[Category:Software]]

Rsgain

2022-12-04T19:35:09Z

Complexlogic:

{{Software Infobox
| name = rsgain
| screenshot = [[File:rsgain_help.png|300px]]
| caption = Default help screen in a Linux terminal
| developer = complexlogic
| released = 2022-05-10
| stable_release = 3.1.1
| stable_release_date = 2022-11-15
| operating_system = Windows, macOS, Linux, BSD
| use = ReplayGain tagging
| license = BSD license
| website = [https://github.com/complexlogic/rsgain]
}}
'''rsgain''' ('''r'''eally '''s'''imple '''gain''') is a free and open source [[ReplayGain 2.0 specification|ReplayGain 2.0]] tagging utility for Windows, macOS, and Linux. rsgain applies loudness metadata tags to your files, while leaving the audio stream untouched. A [[ReplayGain#Players_support|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|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|MusicBrainz Picard Plugin]] for more information.

==Installation==
rsgain is available in source form on all platforms, and executable form on some platforms.

===Windows===
rsgain is compatible with Windows 10 and later. Download the win64 .zip file from the [https://github.com/complexlogic/rsgain/releases/latest latest release on GitHub], and extract its contents to a directory of your choice.

It is recommended to add the directory to your {{code|Path}} system environment variable so you can invoke the program with the {{code|rsgain}} command instead of the path to its .exe file. In the Windows taskbar search, type "env", then select "Edit the system environment variables". In the resulting window, click the "Environment variables" button. In the next window under "System variables", select "Path", then press Edit. Add the folder that you extracted {{code|rsgain.exe}} to in the previous step.

===macOS===
There is a Homebrew formula available for macOS users. Make sure you have Homebrew and the latest available Xcode installed. Execute the following command to install:

{{code|brew install complexlogic/tap/rsgain}}

===Linux===
An amd64 .deb package is provided on the [https://github.com/complexlogic/rsgain/releases/latest GitHub release page]. It is installable on Debian Bullseye and later, Ubuntu 21.04 and later. There is also a .rpm package for Fedora users. An [https://aur.archlinux.org/packages/rsgain-git AUR package] is available for Arch/Manjaro users.

Users of other distros will need to build from source. See the [https://github.com/complexlogic/rsgain/blob/master/docs/BUILDING.md#building build instructions on GitHub].

===FreeBSD===
Available via ports tree or using packages (2023Q1 and later) as listed below:
{{code|cd /usr/ports/audio/rsgain && make install clean}}
{{code|pkg install rsgain}}

==Format Support==
rsgain has support for the following file formats:
* [[MP2]]/[[MP3]]
* [[FLAC]]
* [[Ogg]] ([[Vorbis]], [[Speex]])
* [[Opus]]
* [[M4A]] ([[AAC]], [[ALAC]])
* [[WMA]]
* [[Musepack]]
* [[WAV]]
* [[AIFF]]
* [[Wavpack]]
* [[Monkey's Audio]]

==Usage==
rsgain contains two separate user interfaces: Easy Mode and Custom Mode. The distinction between the two modes is rooted in the history of ReplayGain utilities.

Legacy ReplayGain tagging utilities such as mp3gain did not support recursive directory-based scanning. The user was required to manually specify a list of files on the command line, preceded by options which were numerous and complex. This interface provided a lot of power and flexibility, but it wasn't particularly user friendly. Performing a full library scan typically required the user to supplement the program with a wrapper script that traversed the directory tree and detected the files.

rsgain's Easy Mode ''is'' that wrapper script; the functionality is built-in to the program. In Easy Mode, the user simply points the program to their library and it will be recursively scanned with all recommended settings enabled by default.

The legacy-style interface has been retained as "Custom Mode" for users that require a higher level of control.

===Easy Mode===
Easy Mode recursively scans your entire music library using the recommended settings for each file type. You can use Easy Mode if the following conditions apply:
* Your music library is organized by album, i.e. each album has its own folder
* In each album folder, all audio files are of the same type. It is acceptable to have non-audio files mixed in such as log files or artwork, but if multiple ''audio'' file types are detected, the folder will not be scanned.

Easy Mode is invoked with the command {{code|rsgain easy}} followed by the root of the directory you want to scan, e.g.:

{{code|rsgain easy /path/to/music/library}}

{{code|rsgain easy "C:\path\to\music library"}}

This is all that is required for most users. Advanced users should see the [[#scan_presets|Scan Presets]] section for more information about the default settings and how to override them, if desired.

====Multithreaded Scanning====
Easy Mode includes optional multithreaded operation to speed up the duration of a scan. Use the {{code|-m}} option, followed by the number of threads to create. The number of threads must not exceed the number that your CPU supports. For example, if you have a CPU with 4 threads:

{{code|rsgain easy -m 4 /path/to/music/library}}

If you don't know how many threads your CPU has, you can also specify {{code|-m MAX}} and rsgain will use the number provided by your operating system. This is useful for writing scripts where the hardware properties of the target machine are unknown.

Parallel scan jobs are generated on a ''per-directory'' basis, not a per-file basis. If you request 4 threads but there is only 1 directory to scan, a single thread will be working and the other 3 will sit idle the entire time. Multithreaded mode is optimized for scanning a very large number of directories. It is recommended to use multithreaded mode for full library scans and the default single threaded mode when incrementally adding 1 or 2 albums to your library.

The speed gains offered by multithreaded scanning are significant. With {{code|-m 4}} or higher, you can typically expect to see a 50-80% reduction in total scan time, depending on your hardware, settings, and library composition.

====Skip Files with Existing Tags====
rsgain has an option which will skip files with existing ReplayGain information, invoked by passing {{code|-S}} or {{code|--skip-existing}}. When enabled, rsgain will check whether the given file has a {{code|REPLAYGAIN_TRACK_GAIN}} tag, and skip scanning any files that do. If album tags are enabled, the files in the list will be judged collectively, i.e. if a single file is missing ReplayGain info, then all of them will be scanned.

This feature merely checks for the existence of the tags, and does not verify that the tags are complete, and are compatible with your current settings, e.g. target loudness. You should use this feature only if you are confident in the integrity of the files in the directory to be scanned. It's generally not a good idea to run this on files that you've recently download from the internet, which may have pre-existing ReplayGain information that was tagged by a different scanner.

====Logging====
You can use the {{code|-O}} option to enable scan logs. The program will save a tab-delimited file titled {{code|replaygain.csv}} with the scan results for every directory it scans. The log files can be viewed in a spreadsheet application such as Microsoft Excel or LibreOffice Calc.

====Scan Presets====
Easy Mode scans files with the following settings by default:
* -18 LUFS target loudness
* Album tags enabled
* Sample peak calculations for peak tags
* Clipping protection enabled for positive gain values only (0 dB max peak)
* Standard uppercase tags for all formats
* ID3v2.3 tags for ID3 formats
* Standard ReplayGain tags for Opus files

These settings are recommended for maximum compatibility with modern players. However, if you need one or more of the settings changed, you can use a preset file.

A preset file is an INI-formatted configuration file that contains sections enclosed in square brackets, and each section contains key=value pairs that correspond to settings. The first section in a presets file is titled "Global" and contains settings that will be applied to every format. The remaining sections pertain to a particular audio format, and the settings within them will only be applied to that format. This allows the user to define settings on a per-format basis. If a setting in the "Global" section is in conflict with one in the format-specific section, the format-specific value will always take precedence.

A preset is specified with the {{code|-p}} option, followed by the path to a preset file ''or'' a preset name. A preset name is the filename of a preset without the directory or .ini file extension; rsgain will search the default preset location(s) for the file based on your platform:
* On Windows, the folder {{code|presets}} in the same folder that contains {{code|rsgain.exe}}
* On Unix platforms, rsgain will search first in the user home directory: {{code|~/Library/rsgain/presets}} on Mac and {{code|~/.config/rsgain/presets}} on Linux (you need to create these directories if they don't already exist). If the requested preset name is not found in the home directory, rsgain will search {{code|<install prefix>/share/rsgain/presets}}

For example, rsgain ships with a preset {{code|ebur128.ini}}, which will scan files based on the EBU R 128 recommendations. You can invoke this preset with {{code|-p ebur128}}. rsgain also ships with a preset {{code|default.ini}}, which is pre-populated with all of the default settings. This preset is not intended to be used directly, but rather to serve as a base for users to create their own presets. As such, it is not recommended to overwrite it. Instead, save a copy when using it as a base.

The settings in a preset file are applied in an "overrides" fashion. In other words, any settings or formats you're not interested in can simply be deleted from the preset and the defaults will be used instead.

===Custom Mode===
Custom Mode provides a more complex command line syntax that is similar in nature to mp3gain, loudgain, and other legacy ReplayGain scanners. Only the most basic settings are enabled by default. Unlike Easy Mode, Custom Mode works with files, not directories. If you want recursive directory-based scanning, you will need to write a wrapper script.

Custom Mode is invoked with {{code|rsgain custom}} followed by options and a list of files to scan. For example, scan and tag a short list of MP3 files with album tags enabled:

{{code|rsgain custom -a -s i file1.mp3 file2.mp3 file3.mp3}}

See the command line help for all available options:

<pre>
Usage: rsgain custom [OPTIONS] FILES...
Custom Mode allows the user to specify the options to scan the files with. The
list of files to scan must be listed explicitly after the options.

Options:
-h, --help Show this help.

-a, --album Calculate album gain and peak.
-S, --skip-existing Don't scan files with existing ReplayGain information.

-s s, --tagmode=s Scan files but don't write ReplayGain tags (default).
-s d, --tagmode=d Delete ReplayGain tags from files.
-s i, --tagmode=i Scan and write ReplayGain 2.0 tags to files.

-l n, --loudness=n Use n LUFS as target loudness (-30 ≤ n ≤ -5).

-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.

-L, --lowercase Write lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF).
This is non-standard but sometimes needed.
-I 3, --id3v2-version=3 Write ID3v2.3 tags to MP2/MP3/WAV/AIFF (default).
-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 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.
-q, --quiet Don't print scanning status messages.

Please report any issues to https://github.com/complexlogic/rsgain/issues

</pre>

===MusicBrainz Picard Plugin===
[https://picard.musicbrainz.org/ MusicBrainz Picard] is a free, cross-platform music tagging application. Picard features a robust plugin ecosystem that greatly extends its functionality. rsgain serves as the backend for the ReplayGain 2.0 plugin, which is available from the official plugins repository. Users that prefer a graphical interface over a command line interface can use this plugin to scan their music library.

To install the plugin, navigate to the Options menu in Picard. Select "Plugins" in the sidebar, then find "ReplayGain 2.0" and click the download button. The plugin itself does not include rsgain; you'll still need to download and install rsgain separately per the [[#installation|Installation]] section for your chosen platform.

You need to set the path to rsgain in the plugin settings. This field is pre-populated with the {{code|rsgain}} command. On Unix platforms, programs are typically installed into a directory that's already in your {{code|PATH}}, so no further action is necessary in that case. On Windows, you will need to either manually add the folder containing rsgain to your {{code|Path}} as per the installation instructions, or use the exact path to {{code|rsgain.exe}} in the plugin settings.

To use the plugin, add files to Picard and associate them with a release (so the files are in the right window). The plugin can scan albums or individual tracks. Select one or more albums or tracks, then right click and select "Plugins->Calculate ReplayGain" from the context menu. This calculates the ReplayGain information for the selected items, but does not tag the files. The new tags are available for viewing in the metadata window at the bottom. Click the save button to write the new tags to file.

==See also==
* [[ReplayGain]]
* [[ReplayGain 2.0 specification]]

==External links==
* [https://github.com/complexlogic/rsgain/ rsgain GitHub page]
* [https://en.wikipedia.org/wiki/EBU_R_128 EBU R128]

[[Category:Software]]

Rsgain

2022-09-18T16:14:09Z

Complexlogic: Fix grammar mistake

{{Software Infobox
| name = rsgain
| screenshot = [[File:rsgain_help.png|300px]]
| caption = Default help screen in a Linux terminal
| developer = complexlogic
| released = 2022-05-10
| stable_release = 3.0
| stable_release_date = 2022-09-14
| operating_system = Windows, macOS, Linux
| use = ReplayGain tagging
| license = BSD license
| website = [https://github.com/complexlogic/rsgain]
}}
'''rsgain''' ('''r'''eally '''s'''imple '''gain''') is a free and open source [[ReplayGain 2.0 specification|ReplayGain 2.0]] tagging utility for Windows, macOS, and Linux. rsgain applies loudness metadata tags to your files, while leaving the audio stream untouched. A [[ReplayGain#Players_support|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|Usage]] for more information.

==Installation==
rsgain is available in source form on all platforms, and executable form on some platforms.

===Windows===
rsgain is compatible with Windows 10 and later. Download the win64 .zip file from the [https://github.com/complexlogic/rsgain/releases/latest latest release on GitHub], and extract its contents to a directory of your choice.

It is recommended to add the directory to your {{code|Path}} system environment variable so you can invoke the program with the {{code|rsgain}} command instead of the path to its .exe file. In the Windows taskbar search, type "env", then select "Edit the system environment variables". In the resulting window, click the "Environment variables" button. In the next window under "System variables", select "Path", then press Edit. Add the folder that you extracted {{code|rsgain.exe}} to in the previous step.

===macOS===
There is a Homebrew formula available for macOS users. Make sure you have Homebrew and the latest available Xcode installed. Execute the following command to install:

{{code|brew install complexlogic/tap/rsgain}}

===Linux===
An amd64 .deb package is provided on the [https://github.com/complexlogic/rsgain/releases/latest GitHub release page]. It is installable on Debian Bullseye and later, Ubuntu 21.04 and later. There is also an [https://aur.archlinux.org/packages/rsgain-git AUR package] available for Arch/Manjaro users.

Users of other distros will need to build from source. See the [https://github.com/complexlogic/rsgain/blob/master/docs/BUILDING.md#building build instructions on GitHub].

==Format Support==
rsgain has support for the following file formats:
* [[MP2]]/[[MP3]]
* [[FLAC]]
* [[Ogg]] ([[Vorbis]], [[Speex]])
* [[Opus]]
* [[M4A]] ([[AAC]], [[ALAC]])
* [[WMA]]
* [[WAV]]
* [[AIFF]]
* [[Wavpack]]
* [[Monkey's Audio]]

==Usage==
rsgain contains two separate user interfaces: Easy Mode and Custom Mode. The distinction between the two modes is rooted in the history of ReplayGain utilities.

Legacy ReplayGain tagging utilities such as mp3gain did not support recursive directory-based scanning. The user was required to manually specify a list of files on the command line, preceded by options which were numerous and complex. This interface provided a lot of power and flexibility, but it wasn't particularly user friendly. Performing a full library scan typically required the user to supplement the program with a wrapper script that traversed the directory tree and detected the files.

rsgain's Easy Mode ''is'' that wrapper script; the functionality is built-in to the program. In Easy Mode, the user simply points the program to their library and it will be recursively scanned with all recommended settings enabled by default.

The legacy-style interface has been retained as "Custom Mode" for users that require a higher level of control.

===Easy Mode===
Easy Mode recursively scans your entire music library using the recommended settings for each file type. You can use Easy Mode if the following conditions apply:
* Your music library is organized by album, i.e. each album has its own folder
* In each album folder, all audio files are of the same type. It is acceptable to have non-audio files mixed in such as log files or artwork, but if multiple ''audio'' file types are detected, the folder will not be scanned.

Easy Mode is invoked with the command {{code|rsgain easy}} followed by the root of the directory you want to scan, e.g.:

{{code|rsgain easy /path/to/music/library}}

{{code|rsgain easy "C:\path\to\music library"}}

This is all that is required for most users. Advanced users should see the [[#scan_presets|Scan Presets]] section for more information about the default settings and how to override them, if desired.

====Multithreaded Scanning====
Easy Mode includes optional multithreaded operation to speed up the duration of a scan. Use the {{code|-m}} option, followed by the number of threads to create. The number of threads must not exceed the number that your CPU supports. For example, if you have a CPU with 4 threads:

{{code|rsgain easy -m 4 /path/to/music/library}}

If you don't know how many threads your CPU has, you can also specify {{code|-m MAX}} and rsgain will use the number provided by your operating system. This is useful for writing scripts where the hardware properties of the target machine are unknown.

Parallel scan jobs are generated on a ''per-directory'' basis, not a per-file basis. If you request 4 threads but there is only 1 directory to scan, a single thread will be working and the other 3 will sit idle the entire time. Multithreaded mode is optimized for scanning a very large number of directories. It is recommended to use multithreaded mode for full library scans and the default single threaded mode when incrementally adding 1 or 2 albums to your library.

The speed gains offered by multithreaded scanning are significant. With {{code|-m 4}} or higher, you can typically expect to see a 50-80% reduction in total scan time, depending on your hardware, settings, and library composition.

====Logging====
You can use the {{code|-O}} option to enable scan logs. The program will save a tab-delimited file titled {{code|replaygain.csv}} with the scan results for every directory it scans. The log files can be viewed in a spreadsheet application such as Microsoft Excel or LibreOffice Calc.

====Scan Presets====
Easy Mode scans files with the following settings by default:
* -18 LUFS target loudness
* Album tags enabled
* Sample peak calculations for peak tags
* Clipping protection enabled for positive gain values only (0 dB max peak)
* Standard uppercase tags for all formats
* ID3v2.3 tags for ID3 formats
* Standard ReplayGain tags for Opus files

These settings are recommended for maximum compatibility with modern players. However, if you need one or more of the settings changed, you can use a preset file.

A preset file is an INI-formatted configuration file that contains sections enclosed in square brackets, and each section contains key=value pairs that correspond to settings. The first section in a presets file is titled "Global" and contains settings that will be applied to every format. The remaining sections pertain to a particular audio format, and the settings within them will only be applied to that format. This allows the user to define settings on a per-format basis. If a setting in the "Global" section is in conflict with one in the format-specific section, the format-specific value will always take precedence.

A preset is specified with the {{code|-p}} option, followed by the path to a preset file ''or'' a preset name. A preset name is the filename of a preset without the directory or .ini file extension; rsgain will search the default preset location(s) for the file based on your platform:
* On Windows, the folder {{code|presets}} in the same folder that contains {{code|rsgain.exe}}
* On Unix platforms, rsgain will search first in the user home directory: {{code|~/Library/rsgain/presets}} on Mac and {{code|~/.config/rsgain/presets}} on Linux (you need to create these directories if they don't already exist). If the requested preset name is not found in the home directory, rsgain will search {{code|<install prefix>/share/rsgain/presets}}

For example, rsgain ships with a preset {{code|ebur128.ini}}, which will scan files based on the EBU R 128 recommendations. You can invoke this preset with {{code|-p ebur128}}. rsgain also ships with a preset {{code|default.ini}}, which is pre-populated with all of the default settings. This preset is not intended to be used directly, but rather to serve as a base for users to create their own presets. As such, it is not recommended to overwrite it. Instead, save a copy when using it as a base.

The settings in a preset file are applied in an "overrides" fashion. In other words, any settings or formats you're not interested in can simply be deleted from the preset and the defaults will be used instead.

===Custom Mode===
Custom Mode provides a more complex command line syntax that is similar in nature to mp3gain, loudgain, and other legacy ReplayGain scanners. Only the most basic settings are enabled by default. Unlike Easy Mode, Custom Mode works with files, not directories. If you want recursive directory-based scanning, you will need to write a wrapper script.

Custom Mode is invoked with {{code|rsgain custom}} followed by options and a list of files to scan. For example, scan and tag a short list of MP3 files with album tags enabled:

{{code|rsgain custom -a -s i file1.mp3 file2.mp3 file3.mp3}}

See the command line help for all available options:

<pre>
Usage: rsgain custom [OPTIONS] FILES...
Custom Mode allows the user to specify the options to scan the files with. The
list of files to scan must be listed explicitly after the options.

Options:
-h, --help Show this help.

-a, --album Calculate album gain and peak.

-s s, --tagmode=s Scan files but don't write ReplayGain tags (default).
-s d, --tagmode=d Delete ReplayGain tags from files.
-s i, --tagmode=i Scan and write ReplayGain 2.0 tags to files.

-l n, --loudness=n Use n LUFS as target loudness (-30 ≤ n ≤ -5).

-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.

-L, --lowercase Write lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF).
This is non-standard but sometimes needed.
-I 3, --id3v2-version=3 Write ID3v2.3 tags to MP2/MP3/WAV/AIFF (default).
-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 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.
-q, --quiet Don't print scanning status messages.

Please report any issues to https://github.com/complexlogic/rsgain/issues
</pre>

==See also==
* [[ReplayGain]]
* [[ReplayGain 2.0 specification]]

==External links==
* [https://github.com/complexlogic/rsgain/ rsgain GitHub page]
* [https://en.wikipedia.org/wiki/EBU_R_128 EBU R128]

[[Category:Software]]

Rsgain

2022-09-18T16:03:01Z

Complexlogic: Update for v3.0

{{Software Infobox
| name = rsgain
| screenshot = [[File:rsgain_help.png|300px]]
| caption = Default help screen in a Linux terminal
| developer = complexlogic
| released = 2022-05-10
| stable_release = 3.0
| stable_release_date = 2022-09-14
| operating_system = Windows, macOS, Linux
| use = ReplayGain tagging
| license = BSD license
| website = [https://github.com/complexlogic/rsgain]
}}
'''rsgain''' ('''r'''eally '''s'''imple '''gain''') is a free and open source [[ReplayGain 2.0 specification|ReplayGain 2.0]] tagging utility for Windows, macOS, and Linux. rsgain applies loudness metadata tags to your files, while leaving the audio stream untouched. A [[ReplayGain#Players_support|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|Usage]] for more information.

==Installation==
rsgain is available in source form on all platforms, and executable form on some platforms.

===Windows===
rsgain is compatible with Windows 10 and later. Download the win64 .zip file from the [https://github.com/complexlogic/rsgain/releases/latest latest release on GitHub], and extract its contents to a directory of your choice.

It is recommended to add the directory to your {{code|Path}} system environment variable so you can invoke the program with the {{code|rsgain}} command instead of the path to its .exe file. In the Windows taskbar search, type "env", then select "Edit the system environment variables". In the resulting window, click the "Environment variables" button. In the next window under "System variables", select "Path", then press Edit. Add the folder that you extracted {{code|rsgain.exe}} to in the previous step.

===macOS===
There is a Homebrew formula available for macOS users. Make sure you have Homebrew and the latest available Xcode installed. Execute the following command to install:

{{code|brew install complexlogic/tap/rsgain}}

===Linux===
An amd64 .deb package is provided on the [https://github.com/complexlogic/rsgain/releases/latest GitHub release page]. It is installable on Debian Bullseye and later, Ubuntu 21.04 and later. There is also a [https://aur.archlinux.org/packages/rsgain-git AUR package] available for Arch/Manjaro users.

Users of other distros will need to build from source. See the [https://github.com/complexlogic/rsgain/blob/master/docs/BUILDING.md#building build instructions on GitHub].

==Format Support==
rsgain has support for the following file formats:
* [[MP2]]/[[MP3]]
* [[FLAC]]
* [[Ogg]] ([[Vorbis]], [[Speex]])
* [[Opus]]
* [[M4A]] ([[AAC]], [[ALAC]])
* [[WMA]]
* [[WAV]]
* [[AIFF]]
* [[Wavpack]]
* [[Monkey's Audio]]

==Usage==
rsgain contains two separate user interfaces: Easy Mode and Custom Mode. The distinction between the two modes is rooted in the history of ReplayGain utilities.

Legacy ReplayGain tagging utilities such as mp3gain did not support recursive directory-based scanning. The user was required to manually specify a list of files on the command line, preceded by options which were numerous and complex. This interface provided a lot of power and flexibility, but it wasn't particularly user friendly. Performing a full library scan typically required the user to supplement the program with a wrapper script that traversed the directory tree and detected the files.

rsgain's Easy Mode ''is'' that wrapper script; the functionality is built-in to the program. In Easy Mode, the user simply points the program to their library and it will be recursively scanned with all recommended settings enabled by default.

The legacy-style interface has been retained as "Custom Mode" for users that require a higher level of control.

===Easy Mode===
Easy Mode recursively scans your entire music library using the recommended settings for each file type. You can use Easy Mode if the following conditions apply:
* Your music library is organized by album, i.e. each album has its own folder
* In each album folder, all audio files are of the same type. It is acceptable to have non-audio files mixed in such as log files or artwork, but if multiple ''audio'' file types are detected, the folder will not be scanned.

Easy Mode is invoked with the command {{code|rsgain easy}} followed by the root of the directory you want to scan, e.g.:

{{code|rsgain easy /path/to/music/library}}

{{code|rsgain easy "C:\path\to\music library"}}

This is all that is required for most users. Advanced users should see the [[#scan_presets|Scan Presets]] section for more information about the default settings and how to override them, if desired.

====Multithreaded Scanning====
Easy Mode includes optional multithreaded operation to speed up the duration of a scan. Use the {{code|-m}} option, followed by the number of threads to create. The number of threads must not exceed the number that your CPU supports. For example, if you have a CPU with 4 threads:

{{code|rsgain easy -m 4 /path/to/music/library}}

If you don't know how many threads your CPU has, you can also specify {{code|-m MAX}} and rsgain will use the number provided by your operating system. This is useful for writing scripts where the hardware properties of the target machine are unknown.

Parallel scan jobs are generated on a ''per-directory'' basis, not a per-file basis. If you request 4 threads but there is only 1 directory to scan, a single thread will be working and the other 3 will sit idle the entire time. Multithreaded mode is optimized for scanning a very large number of directories. It is recommended to use multithreaded mode for full library scans and the default single threaded mode when incrementally adding 1 or 2 albums to your library.

The speed gains offered by multithreaded scanning are significant. With {{code|-m 4}} or higher, you can typically expect to see a 50-80% reduction in total scan time, depending on your hardware, settings, and library composition.

====Logging====
You can use the {{code|-O}} option to enable scan logs. The program will save a tab-delimited file titled {{code|replaygain.csv}} with the scan results for every directory it scans. The log files can be viewed in a spreadsheet application such as Microsoft Excel or LibreOffice Calc.

====Scan Presets====
Easy Mode scans files with the following settings by default:
* -18 LUFS target loudness
* Album tags enabled
* Sample peak calculations for peak tags
* Clipping protection enabled for positive gain values only (0 dB max peak)
* Standard uppercase tags for all formats
* ID3v2.3 tags for ID3 formats
* Standard ReplayGain tags for Opus files

These settings are recommended for maximum compatibility with modern players. However, if you need one or more of the settings changed, you can use a preset file.

A preset file is an INI-formatted configuration file that contains sections enclosed in square brackets, and each section contains key=value pairs that correspond to settings. The first section in a presets file is titled "Global" and contains settings that will be applied to every format. The remaining sections pertain to a particular audio format, and the settings within them will only be applied to that format. This allows the user to define settings on a per-format basis. If a setting in the "Global" section is in conflict with one in the format-specific section, the format-specific value will always take precedence.

A preset is specified with the {{code|-p}} option, followed by the path to a preset file ''or'' a preset name. A preset name is the filename of a preset without the directory or .ini file extension; rsgain will search the default preset location(s) for the file based on your platform:
* On Windows, the folder {{code|presets}} in the same folder that contains {{code|rsgain.exe}}
* On Unix platforms, rsgain will search first in the user home directory: {{code|~/Library/rsgain/presets}} on Mac and {{code|~/.config/rsgain/presets}} on Linux (you need to create these directories if they don't already exist). If the requested preset name is not found in the home directory, rsgain will search {{code|<install prefix>/share/rsgain/presets}}

For example, rsgain ships with a preset {{code|ebur128.ini}}, which will scan files based on the EBU R 128 recommendations. You can invoke this preset with {{code|-p ebur128}}. rsgain also ships with a preset {{code|default.ini}}, which is pre-populated with all of the default settings. This preset is not intended to be used directly, but rather to serve as a base for users to create their own presets. As such, it is not recommended to overwrite it. Instead, save a copy when using it as a base.

The settings in a preset file are applied in an "overrides" fashion. In other words, any settings or formats you're not interested in can simply be deleted from the preset and the defaults will be used instead.

===Custom Mode===
Custom Mode provides a more complex command line syntax that is similar in nature to mp3gain, loudgain, and other legacy ReplayGain scanners. Only the most basic settings are enabled by default. Unlike Easy Mode, Custom Mode works with files, not directories. If you want recursive directory-based scanning, you will need to write a wrapper script.

Custom Mode is invoked with {{code|rsgain custom}} followed by options and a list of files to scan. For example, scan and tag a short list of MP3 files with album tags enabled:

{{code|rsgain custom -a -s i file1.mp3 file2.mp3 file3.mp3}}

See the command line help for all available options:

<pre>
Usage: rsgain custom [OPTIONS] FILES...
Custom Mode allows the user to specify the options to scan the files with. The
list of files to scan must be listed explicitly after the options.

Options:
-h, --help Show this help.

-a, --album Calculate album gain and peak.

-s s, --tagmode=s Scan files but don't write ReplayGain tags (default).
-s d, --tagmode=d Delete ReplayGain tags from files.
-s i, --tagmode=i Scan and write ReplayGain 2.0 tags to files.

-l n, --loudness=n Use n LUFS as target loudness (-30 ≤ n ≤ -5).

-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.

-L, --lowercase Write lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF).
This is non-standard but sometimes needed.
-I 3, --id3v2-version=3 Write ID3v2.3 tags to MP2/MP3/WAV/AIFF (default).
-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 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.
-q, --quiet Don't print scanning status messages.

Please report any issues to https://github.com/complexlogic/rsgain/issues
</pre>

==See also==
* [[ReplayGain]]
* [[ReplayGain 2.0 specification]]

==External links==
* [https://github.com/complexlogic/rsgain/ rsgain GitHub page]
* [https://en.wikipedia.org/wiki/EBU_R_128 EBU R128]

[[Category:Software]]

Rsgain

2022-05-18T19:36:19Z

Complexlogic:

Rsgain

2022-05-18T13:59:42Z

Complexlogic: Update for v2.0.1

Loudgain

2022-05-17T13:56:35Z

Complexlogic: Undo revision 35506 by Complexlogic (talk)

{{Software Infobox
| name = loudgain
| screenshot = [[File:Loudgain-terminal.png|256px]]
| caption = Loudgain running in a Linux terminal window.
| developer = Matthias C. Hormann, Alessandro Ghedini
| released = 2014-06-22
| stable_release = 0.6.8
| stable_release_date = 2019-09-06
| operating_system = Linux, MacOS, Windows 10
| use = Tagging
| license = BSD license
| website = [https://github.com/Moonbase59/loudgain/]
}}
'''loudgain''' is an open-source [[ReplayGain 2.0 specification|ReplayGain 2]] tagging tool for Linux, MacOS (via Homebrew) and Windows 10 (via the ''Linux bash''). It analyzes many types of audio files, based on the EBU R128/ITU BS.1170 standard (at -18 LUFS), and uses the well-known [[MP3Gain]] commandline syntax. Loudgain never modifies the audio data, but instead only writes the appropriate ReplayGain tags.

For ''mass-tagging'' (assuming one album per folder), loudgain comes with a bash script called <code>rgbpm</code> that can be modified to the user’s needs.

==Technical details==
Loudgain computes the [[ReplayGain]] (volume adjustment), ''true peak'' value and loudness range, using the ''EBU R128'' algorithm for each track and (optionally) a whole album. The optional ''clipping prevention'' feature can further reduce the computed gain to a level where no clipping should occur (default -1 dBTP). Computed values are then written to the audio files as ''tags'' in a suitable tag format.

For extra versatility, loudgain also supports writing the ''loudness range'' and ''loudness reference'' values, forcing upper- or lowercase ReplayGain tags, and stripping "foreign" tags from some file types.

In case of writing [[ID3v2]] tags, these can be specified to be either ''ID3v2.4'' (default) or ''ID3v2.3''. Any neccessary conversions will be done internally (i.e., converting UTF-8 frames to UTF-16 when going from ID3v2.4 to ID3v2.3).

==Supported file formats==
* Supported audio file formats as of version 0.6.8:
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** MP2, [[MP3]]: Values written to [[ID3v2]] tags (ID3v2.3/ID3v2.4 selectable).
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** (Ogg) [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** (Ogg) [[Speex]]: Values written to [[Vorbis comment]].
** [[Opus]]: Values written to [[Vorbis comment]], based on -23 LUFS Opus standard. Only <code>R128_TRACK_GAIN</code> and <code>R128_ALBUM_GAIN</code> are written, but the calculated ''true peak'' value can still be used to reduce the gain values ([[Clipping]] prevention).
** [[MP4]], [[M4A]]: Uses its own iTunes-compatible tagging system (though iTunes does not support ReplayGain). ReplayGain values are stored under <code>----:com.apple.iTunes:…</code>. This is for [[Advanced Audio Coding|AAC]] and [[ALAC]] in [[MPEG-4]] containers.
** [[Advanced Streaming Format|ASF]], [[Windows Media Audio|WMA]]: Values written to WMA tags, no prefix.
** [[WAV]]: Values written to the <code>ID3 </code> chunk, in [[ID3v2]] (ID3v2.3/ID3v2.4 selectable) format. Using the <code>bext</code> chunk (for BWF v2) isn’t (yet) supported, but won’t be destroyed on writing.
** [[Audio Interchange File Format|AIFF]]: Values written to the <code>ID3 </code> chunk, in [[ID3v2]] format.
** [[WavPack]]: Values written to [[APEv2]] tags.
** [[Monkey's Audio]] (APE): Values written to [[APEv2]] tags.

==Command line help==
<pre>
Usage: loudgain [OPTIONS] FILES...

loudgain 0.6.8 supports writing tags to the following file types:
FLAC (.flac), Ogg (.ogg, .oga, .spx, .opus), MP2 (.mp2), MP3 (.mp3),
MP4 (.mp4, .m4a), ASF/WMA (.asf, .wma), WavPack (.wv), APE (.ape).
Experimental: WAV (.wav), AIFF (.aiff, .aif).

Options:
-h, --help Show this help.
-v, --version Show version number.

-r, --track Calculate track gain only (default).
-a, --album Calculate album gain (and track gain).

-c, --clip Ignore clipping warning.
-k, --noclip Lower track/album gain to avoid clipping (<= -1 dBTP).
-K n, --maxtpl=n Avoid clipping; max. true peak level = n dBTP.
-d n, --pregain=n Apply n dB/LU pre-gain value (-5 for -23 LUFS target).

-s d, --tagmode=d Delete ReplayGain tags from files.
-s i, --tagmode=i Write ReplayGain 2.0 tags to files.
-s e, --tagmode=e like '-s i', plus extra tags (reference, ranges).
-s l, --tagmode=l like '-s e', but LU units instead of dB.
-s s, --tagmode=s Don't write ReplayGain tags (default).

-L, --lowercase Force lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF).
This is non-standard but sometimes needed.
-S, --striptags Strip tag types other than ID3v2 from MP2/MP3.
Strip tag types other than APEv2 from WavPack/APE.
-I 3, --id3v2version=3 Write ID3v2.3 tags to MP2/MP3/WAV/AIFF.
-I 4, --id3v2version=4 Write ID3v2.4 tags to MP2/MP3/WAV/AIFF (default).

-o, --output Database-friendly tab-delimited list output.
-O, --output-new New format tab-delimited list output.
-q, --quiet Don't print scanning status messages.

Please report any issues to https://github.com/Moonbase59/loudgain/issues.
</pre>

==Closer analysis of files==
[[Image:Loudgain-csv.png|thumb|Album data in spreadsheet]]
Using the <code>-O</code> (uppercase letter O) switch, loudgain can produce a detailed tab-separated list, ideal for redirection into a <code>.csv</code> spreadsheet file and later analysis.

Simply use a command like the following and then import the <code>album.csv</code> file into your spreadsheet application, specifying "tab-delimited CSV":
<pre>
loudgain -O [OPTIONS] FILES... > album.csv
</pre>

==loudgain on Windows 10==
[[Image:Loudgain-windows10-bash.png|thumb|loudgain in Windows 10’s ''Linux bash'']]
There is currently no Windows-native version of loudgain, but it can easily be used with Windows 10’s ''Linux bash''.

Detailed installation instructions can be found on [https://github.com/Moonbase59/loudgain#installation-on-windows-10-linux-bash loudgain’s GitHub page].

==Known problems==
* Loudgain relies on standard libraries like ''TagLib''. Linux distros (except rolling releases) sometimes deliver outdated libraries, so '''be sure you use the latest version of ''TagLib''.''' Version 1.11.1 had a nasty bug for a while that [https://hydrogenaud.io/index.php/topic,118085.msg974957.html#msg974957 could corrupt Ogg Vorbis files]. This has been fixed in the meantime but the TagLib version not updated. Loudgain comes with a (slower) static version called <code>loudgain.static</code> in the repo’s <code>/bin</code> folder that doesn’t expose the bug and can also be used on older Linux versions (like Ubuntu 14.04, Linux Mint 17).
* ''TagLib'' versions prior to Version 1.12 couldn’t write ''ID3v2.3'' tags to AIFF files. This now works if loudgain is compiled against ''TagLib 1.12 or newer''.

==Development==
loudgain v0.1 was originally developed by Alessandro Ghedini in 2014.

[[User:Moonbase|Matthias C. Hormann]] forked this version in 2019 and took over the development of loudgain after version 0.1, starting with version 0.2.1.
The latest version is '''0.6.8'''.

==See also==
* [[ReplayGain]]
* [[ReplayGain 2.0 specification]]

==External links==
* [https://github.com/Moonbase59/loudgain/ loudgain on GitHub]
* [https://github.com/Moonbase59/loudgain#technical-details-advanced-users-stuff loudgain technical details on GitHub]
* [https://github.com/Moonbase59/loudgain/issues loudgain bug tracker]
* [https://aur.archlinux.org/packages/loudgain/ loudgain in the ArchLinux User Repository (AUR)]

[[Category:Software]]

ReplayGain

2022-05-11T05:57:12Z

Complexlogic:

'''ReplayGain''' is the name of a technique invented to achieve the same perceived playback loudness of audio files. It defines an algorithm to measure the '''perceived''' loudness of audio data.

ReplayGain allows the loudness of each song within a collection of songs to be consistent. This is called 'Track Gain' (or 'Radio Gain' in earlier parlance). It also allows the loudness of a specific sub-collection (an "album") to be consistent with the rest of the collection, while allowing the dynamics from song to song on the album to remain intact. This is called 'Album Gain' (or 'Audiophile Gain' in earlier parlance). This is especially important when listening to classical music albums, because quiet tracks need to remain a certain degree quieter than the louder ones.

ReplayGain is different from [[Normalization|peak normalization]]. Peak normalization merely ensures that the peak amplitude reaches a certain level. This does not ensure equal loudness. The ReplayGain technique measures the ''effective power'' of the waveform (i.e. the RMS power after applying an "equal loudness contour"), and then adjusts the amplitude of the waveform accordingly. The result is that Replay Gained waveforms are usually more uniformly amplified than peak-normalized waveforms.

==Target loudness==
The target loudness of almost all ReplayGain utilities is 89 dB SPL when replayed in an SMPTE RP 200 calibrated system (an early departure from the proposal, endorsed by its author<ref>[http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=83397&view=findpost&p=721854 Does Replay gain work differtly in Media monkey]</ref>) — the ReplayGain proposal and SMPTE recommendation are 6dB lower.<ref>[http://www.mars.org/mailman/public/mad-dev/2004-February/000993.html ReplayGain discussion at mad-dev]</ref>

==Clipping==
Audio is generally recorded such that the loudest sounds don't clip, but the use of ReplayGain can cause clipping if the average volume of a song is below the target level. That is, upon playback, the volume of a quiet song is increased, so the parts of the song with above-average loudness, especially in the bass frequencies, will exceed the limits of the format and will be distorted. Whether this distortion is audible depends on the sounds in question, and the listener's sensitivity.

Implementations deal with the risk of clipping in different ways. Some have a "pre-amp" feature which reduces (or boosts) the original audio's level by a certain amount before doing whatever is needed for ReplayGain. Some have a "prevent clipping" feature to reduce the amount of ReplayGain adjustment to whatever amount would keep clipping from occurring, based on peak info stored in the file's metadata (thus reducing the effectiveness of ReplayGain). Some recommend using a compressor/limiter DSP to prevent or reduce clipping, regardless of whether it was caused by ReplayGain.

== Implementations ==
There are different ReplayGain implementations, each with its own uses and strength. Most use [[metadata]] to indicate the level of the volume change that the player should make. Some modify the audio data itself, and optionally use metadata as well. There are advantages and disadvantages to both methods.

In the metadata method, information on both types of ReplayGain (Track Gain and Album Gain) can be stored. The volume-change information can be very precise. If audio data was also changed, the metadata can contain "undo" info. Not all audio players/decoders know how to read and use ReplayGain information stored in metadata. And there's no standard for where and how ReplayGain info is stored; each implementation uses different formats and puts the info in different locations.

In the audio data method, the file's actual audio data is modified so that its natural/default playback volume is at the target level. In this scenario, only one type of ReplayGain (Track Gain or Album Gain) can be applied. If no "undo" info is saved somewhere, it may not be possible to restore the original audio data. Limitations of the audio file format may prevent precise (finely tuned) gain adjustments with this method. For example, MP3 and AAC files can only be losslessly modified in 1.5 dB steps. Depending on the audio file format, the process may also be lossy in the sense that it could irreversibly push a signal above the format's maximum amplitude (resulting in clipping) or below the minimum (resulting in silence).

=== MP3Gain ===
[[MP3Gain]] is an implementation of ReplayGain. It can be used to just analyze files & recommend changes or to also modify the gain. If modifying the gain, it always modifies the global gain fields in the MP3 audio data. It can add somewhat precise metadata, including undo info. The gain can be modified to any target dB, or it can be changed by a specified amount. For balance correction, user-specified changes can even be made on just one channel in simple L/R stereo-mode files (not joint stereo).

* Format: [[MP3]]
* Method: Audio + Meta (in APE tag), or Audio only
* APE tag fields (ASCII bytes):
** <code>MP3GAIN_MINMAX ###,###</code> - minimum & maximum global gain values for this file. 3 digits, zero-padded if necessary.
** <code>MP3GAIN_ALBUM_MINMAX ###,###</code> - minimum & maximum global gain values across a set of files scanned as an album. Optional.
** <code>MP3GAIN_UNDO +###,+###,N</code> - the global gain adjustment to restore the original values in the left and right channels, respectively, followed by an indicator of whether to wrap at the extremes (<code>N</code> means no, <code>W</code> means yes). The adjustment values are 3 digits, zero-padded, preceded by a sign (<code>+</code> or <code>-</code>).
** <code>REPLAYGAIN_TRACK_GAIN +#.###### dB</code> - The value is always 9 characters including the sign and decimal point. Examples: <code>+0.424046</code> and <code>-10.38500</code>
** <code>REPLAYGAIN_TRACK_PEAK #.###### dB</code> - The value is always 8 characters including the decimal point. Example: <code>0.149923</code>
** <code>REPLAYGAIN_ALBUM_GAIN +#.###### dB</code> - The value is always 9 characters including the sign and decimal point. Optional.
** <code>REPLAYGAIN_ALBUM_PEAK #.###### dB</code> - The value is always 8 characters including the decimal point. Optional.
* Limitations: Although the metadata, if written, contains precise adjustment & peak values, the audio data modifications are limited to 1.5dB steps and may become irreversible (however, that's a very rare condition; see the [http://www.hydrogenaudio.org/forums/lofiversion/index.php/t34154.html "mp3gain is NOT lossless" forum thread])
* http://mp3gain.sourceforge.net/

=== AACGain ===
[[AACGain]] is a modified version of MP3Gain that works on both MP3 and AAC files.

* Format: [[MP3]], [[AAC]] (with or without MP4 container)
* Method: Audio + Meta, or Audio only
* Limitations: Limited to 1.5dB steps mode, may become irreversible (same caveat as for MP3Gain)
* http://aacgain.altosdesign.com/

=== [[LAME]] ===
* Method: Header ([http://gabriel.mp3-tech.org/mp3infotag.html mp3infotag])
* Notes:
** Tags added during encoding; not supported by any player yet; Track Gain only
** Replay Gaining MP3's is usually done using MP3Gain (see [[ReplayGain#MP3Gain|above]]) or [[ReplayGain#foobar2000 ReplayGain scanner|foobar2000]]
* http://lame.sourceforge.net/

=== [[Musepack]] ReplayGain ===
* Method: Header (similar to Meta data method)
* Notes: ReplayGain values are stored in the header and ReplayGain is part of the Musepack specifications; therefore any Musepack decoder that does not support ReplayGain can be considered broken.
* http://www.musepack.net/

=== VorbisGain ===
* Format: (Ogg) [[Vorbis]]
* Method: Meta (in [[Vorbis comment]])
* http://www.sjeng.org/vorbisgain.html
** new compiles of VorbisGain at [http://www.rarewares.org/ogg.html www.rarewares.org]
:'''''Note:''' Andavari has provided a very useful script to integrate VorbisGain, which is a CLI tool, into Windows Explorer. Please (Ogg) [[Vorbis#ReplayGain|check this section]].

=== FLAC / METAFLAC ===
* Format: [[Free Lossless Audio Codec|FLAC]]
* Method: Meta (in [[Vorbis comment]])
* http://flac.sf.net

=== WavPack / WVGAIN ===
* Format: [[WavPack]]
* Method: Meta (in [[APEv2]] tag)
* http://www.wavpack.com

=== Wavegain ===
* Format: waveform
* Method: Audio
* Limitations: Irreversible
* http://www.rarewares.org/others.php#wavegain

=== MusicPlayer ===
* Custom implementation, not derived from the original MP3Gain one (but inspired from). As far as I know, all other implementations are directly derived from the MP3Gain (gain_analysis.c, which is GPL) source.
* Format: any that FFmpeg supports
* Method: Audio
* Limitations: Doesn't modify the files at all. Stores the value in own database. Used only for playback.
* https://github.com/albertz/music-player

=== [[foobar2000]] ReplayGain scanner ===
* Format:
** [[MP3]]: Values written to [[ID3v2]] (default) or [[APEv2]] tags. A separate function can be invoked to apply the tagged Track or Album Gain to the MP3 global gain fields (as MP3Gain does), and rewrite any existing tags to account for the peak change and compensate for the difference from 89 dB. The 89 dB reference level for tags isn't configurable, but the reference level applied to the global gain fields is (it's under Preferences > Advanced > Tools > ReplayGain Scanner > Target MP3 alteration volume level).
** [[Musepack]]: Values written to header.
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** [[WavPack]]: Values written to [[APEv2]] tags.
** [[AAC]]: Values written to [[APEv2]] tags. As with MP3, it is also an option to apply gain via a separate function.
** [[MP4]]: Uses its own iTunes-compatible tagging system (though iTunes does not support ReplayGain).
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** [[APE]]: Values written to [[APEv2]] tags.
** Modules ([[MOD]] etc.): Optionally saved into [[APEv2]] tags.
* http://foobar2000.org

=== [[MediaMonkey]] ===
* Format:
** [[MP3]]: Values written to [[APEv2]] or [[ID3v2]] tags.
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** [[WMA]]: Values stored in MediaMonkey's MDB database.
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** [[APE]]: Values written to [[APEv2]] tags.
** [[WAV]]: Values stored in MediaMonkey's MDB database.
** [[MPC]]: Internal gain Structure.
* In addition to tags, all ReplayGain values are also stored in MediaMonkey's MDB database
* Album/Audiophile ReplayGain not supported until v3.0 (Dec 2007); support during burning & ripping added in 3.1 (Jun 2009)
* Also capable of (irreversibly) changing the volume of MP3 tracks, similar to [[MP3Gain]]
* http://www.mediamonkey.com/

=== [[Winamp]] ReplayGain scanner===
* Format:
** [[MP3]]: Values written to [[ID3v2]] tags.
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** [[WMA]]: Values stored in Windows Media Audio tags.
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** [[APE]]: Values written to [[APEv2]] tags.
** [[AAC]]: Values written to [[APEv2]] tags.
** [[MP4]]
** [[TAK]]: Values written to [[APEv2]] tags.
* Support Album/Track Gain

=== [[loudgain]] ===
* Format:
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** MP2, [[MP3]]: Values written to [[ID3v2]] tags (ID3v2.3/ID3v2.4 selectable).
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** (Ogg) [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** (Ogg) [[Speex]]: Values written to [[Vorbis comment]].
** [[Opus]]: Values written to [[Vorbis comment]], based on -23 LUFS Opus standard. Only <code>R128_TRACK_GAIN</code> and <code>R128_ALBUM_GAIN</code> are written, but the calculated ''true peak'' value can still be used to reduce the gain values ([[Clipping]] prevention).
** [[MP4]], [[M4A]]: Uses its own iTunes-compatible tagging system (though iTunes does not support ReplayGain). ReplayGain values are stored under <code>----:com.apple.iTunes:…</code>. This is for [[AAC]] and [[ALAC]] in [[MPEG-4]] containers.
** [[ASF]], [[Windows Media Audio|WMA]]: Values written to WMA tags, no prefix.
** [[WAV]]: Values written to the <code>ID3 </code> chunk, in [[ID3v2]] (ID3v2.3/ID3v2.4 selectable) format. Using the <code>bext</code> chunk (for BWF v2) isn’t (yet) supported, but won’t be destroyed on writing.
** [[Audio Interchange File Format|AIFF]]: Values written to the <code>ID3 </code> chunk, in [[ID3v2]] format.
** [[WavPack]]: Values written to [[APEv2]] tags.
** [[Monkey's Audio]] (APE): Values written to [[APEv2]] tags.
* Follows EBU R128, ITU BS.1770 and the [[ReplayGain 2.0 specification]].
* ''Never'' touches the actual audio data but ''only writes RG2 tags''.
* Uses ''true peak'' values calculated by oversampling to 192 kHz, using a custom polyphase FIR interpolator that will oversample 4x for sample rates < 96 kHz, 2x for sample rates < 192 kHz and leave the signal unchanged for 192 kHz.
* ''Clipping prevention'' can be used to lower the ReplayGain values to a safe margin (default -1 dBTP, can be changed).
* Many options for special cases: force RG tags upper-/lowercase, add extra tags (LRA, Reference loudness), strip unwanted tag types (APEv2 from MP2/MP3, ID3 from WavPack), tab-delimited table output for analysis with CSV file.
* ''Linux'' Free and Open Source software, can be installed on ''MacOS'' using ''HomeBrew'', on ''Windows 10'' using the Linux ''bash''.
* Also installs a <code>rgbpm</code> bash script for mass-tagging, which can be adapted to the user’s needs.
* '''Warning:''' Loudgain relies on standard libraries like ''TagLib''. Linux distros (except rolling releases) sometimes deliver outdated libraries, so be sure you use the latest version of ''TagLib''. Version 1.11.1 had a nasty bug for a while that [https://hydrogenaud.io/index.php/topic,118085.msg974957.html#msg974957 could corrupt Ogg Vorbis files]. This has been fixed in the meantime but the TagLib version not updated. Loudgain comes with a (slower) static version called <code>loudgain.static</code> in the repo’s <code>/bin</code> folder that doesn’t expose the bug and can also be used on older Linux versions (like Ubuntu 14.04, Linux Mint 17).
* https://github.com/Moonbase59/loudgain
* Bug tracker: https://github.com/Moonbase59/loudgain/issues

=== [[rsgain]] ===
rsgain is a modified version of [[#loudgain|loudgain]] that supports all of the formats and features of loudgain, plus:
* Native Windows compatibility
* Simplified "Easy Mode" command line syntax that includes built-in recursive directory-based scanning without needing a wrapper script
* Multithreaded scanning option that provides significant speed improvement with full library scans

== Players support ==
ReplayGain being present in the specs of the FLAC, Musepack, and APE formats, any player that support those formats usually supports ReplayGain.

The situation with MP3 is rather different, as it was not part of the MP3 specs. The APEv2 tags metadata implementation is somewhat becoming the de-facto standard.

=== Windows ===
* [[foobar2000]] supports ReplayGain in all possible aspects.
* [[Winamp]] supports ReplayGain in album or track mode.
* [[MediaMonkey]] supports ReplayGain, with many configuration options.
* [[XMPlay]] recently implemented ReplayGain
* [https://picard.musicbrainz.org/ MusicBrainz Picard] is a tagger (and player) that tags using metadata from the MusicBrainz.org database. Picard supports ReplayGain tags for files tagged with APE, ASF, ID3, MP4 and Vorbis tags. There is a ReplayGain plugin that can be used to calculate the ReplayGain values for both Albums and Tracks.

''...and probably others.''

=== Linux ===
* [[XMMS]]. Reads ReplayGain from [[Free Lossless Audio Codec|FLAC]], [[Musepack]], (Ogg) [[Vorbis]] ..
:For [[MP3]], use the CVS version of the [http://xmms-mad.sourceforge.net/ xmms-mad] mp3 plugin (it's not yet released as binary, furthermore not available in distribs' versions for now. Meanwhile binaries are available here: [http://perso.crans.org/~krempp/xmms-mad/ custom binaries])
* [[amarok]]. By using the amarok-script [http://kde-apps.org/content/show.php?content=26073 ReplayGain]
:And possibly others, since [http://developer.kde.org/~wheeler/taglib.html TagLib] added support for [[APEv2]] tags in [[MP3]] files, players using this library (like [[amaroK]] and [[JuK]]) might support that kind of ReplayGain tags in the near future.
* [http://www.sacredchao.net/quodlibet Quod Libet] reads ReplayGain from (Ogg) [[Vorbis]], [[MP3]], [[Free Lossless Audio Codec|FLAC]], and [[Musepack]].
:Requires support to be enabled (via the appropriate python bindings and libraries) for the above formats. Does not support ReplayGain values stored in [[APEv2]] tags in [[MP3]]s. ReplayGain values are stored in RVA2 id3v2.4 frames. See the [http://www.sacredchao.net/quodlibet/wiki/Development/ID3Notes Quod Libet RVA2 / ReplayGain notes].
* [http://www.musicpd.org/ Music Player Daemon] (MPD) reads ReplayGain from (Ogg) [[Vorbis]], [[Free Lossless Audio Codec|FLAC]], and [[Musepack]].
:foobar2000-style TXXX frames in [[MP3]]s are also supported in the latest development releases.
* [http://www.mplayerhq.hu/ MPlayer]. Mplayer support for ReplayGain is codec dependent.
:Codecs that are known to support ReplayGain: vorbis
:Because of this, you need to prioritize the codecs that support it, or choose it individually on the command line. To add it to the command line, add an -ac [codec] option after each file that you want to choose the codec for, or at the beginning to make it apply to all files listed. To prioritize the codecs by default, list them in a line in mplayer.conf:
ac=[codec],[othercodec],vorbis,mad,
* [http://idjc.sourceforge.net/ IDJC] (Internet DJ Console) reads ReplayGain from [[Free Lossless Audio Codec|FLAC]], (Ogg) FLAC, (Ogg) [[Vorbis]], MP2 (audio), [[MP3]], [[Opus]], but only the ''lowercase'' tags. There is a [https://sourceforge.net/p/idjc/bugs/100/ ticket] open to handle tags case-insensitively.
* [https://picard.musicbrainz.org/ MusicBrainz Picard] is a tagger (and player) that tags using metadata from the MusicBrainz.org database. Picard supports ReplayGain tags for files tagged with APE, ASF, ID3, MP4 and Vorbis tags. There is a ReplayGain plugin that can be used to calculate the ReplayGain values for both Albums and Tracks.
* [https://www.videolan.org/vlc/ VLC] supports ReplayGain in many file formats, but usually only the ''uppercase'' variant of the tags.
* [https://kodi.tv/ KODI] reads ReplayGain from nearly all formats, but usually only the ''lowercase'' variant of the tags.

=== Portable devices ===
[http://www.rockbox.org/ Rockbox] supports ReplayGain (in album or track mode) for most formats, including WMA, MP1/2/3, AAC, ALAC, Musepack, Monkey's Audio, Wavpack, FLAC and Vorbis. Note that ReplayGain is only supported when using the respective codec's native tagging format. For example: ReplayGain stored in APEv2 tags is not supported for MP3, rather ID3v2.x tags are expected.

Sandisk Sansa Fuze with firmware 1.02.26 and 2.02.26

Sandisk Sansa Clip+

The iPod features ''Soundcheck'', which seems to produce roughly the same normalization gains as ReplayGain, but doesn't provide an Album Gain.

=== Hi-Fi ===
Slim Devices, a company owned by Logitech Inc, supports ReplayGain on both of their hi-end audiophile players, known as the [[Slim Devices Transporter|Transporter]] and the [[Slim Devices Squeezebox|Squeezebox]].

BluOS also supports ReplayGain with the selection of album- or track-gain and a so called Smart option that decides between the two by itself.
NAD devices that use BluOS consequently also support ReplayGain.

==Notes==
<references/>

== See also ==
* [[ReplayGain specification]]

== External links ==
* [http://en.wikipedia.org/wiki/Replay_Gain ReplayGain] at Wikipedia
* [http://www.bobulous.org.uk/misc/Replay-Gain.html ReplayGain using foobar2000] (how to use ReplayGain in Windows using foobar2000).
* [http://www.bobulous.org.uk/misc/Replay-Gain-in-Linux.html ReplayGain in Linux] (how to use ReplayGain in Linux using foobar2000 and Wine, or using metaflac or vorbisgain).

[[Category:Technical]]
[[Category:Metadata]]

Rsgain

2022-05-11T05:37:14Z

Complexlogic:

Rsgain

2022-05-11T05:34:48Z

Complexlogic: Page creation

{{Software Infobox
| name = rsgain
| screenshot = [[File:rsgain_help.png|256px]]
| caption = Default help screen in a Linux terminal
| developer = complexlogic
| released = 2022-05-10
| stable_release = 2.0
| stable_release_date = 2022-05-10
| operating_system = Windows, macOS, Linux
| use = ReplayGain tagging
| license = BSD license
| website = [https://github.com/complexlogic/rsgain]
}}
'''rsgain''' ('''r'''eally '''s'''imple '''gain''') is a free and open source [[ReplayGain 2.0 specification|ReplayGain 2]] tagging utility for Windows, macOS, and Linux. rsgain applies loudness metadata tags to your files, while leaving the audio stream untouched. A [[ReplayGain#Players_support|ReplayGain-compatible player]] will dynamically adjust the volume of your tagged files during playback.

rsgain is a heavily modified fork of [[loudgain]]. The goal of rsgain is to take the excellent platform created by loudgain and simplify it for the average user, while also preserving the advanced features for users that need them. The following improvements have been made from loudgain:
* Native Windows support
* Built-in recursive directory scanning without the need for a wrapper script. See [[#Easy_Mode|Easy Mode]] for more details.
* Multithreaded scanning

==Installation==
rsgain is available in source form on all platforms, and executable form on some platforms.

===Windows===
rsgain is compatible with Windows 10 and later. Download the win64 .zip file from the [https://github.com/complexlogic/rsgain/releases/latest latest release on GitHub], and extract its contents to a directory of your choosing.

It is recommended to add the directory to your {{code|Path}} system environment variable so you can invoke the program with the {{code|rsgain}} command instead of using the full path to its .exe file. In the Windows taskbar search, type "env", then select "Edit the system environment variables". In the resulting window, click the "Environment variables" button. In the next window under "System variables", select "Path", then press Edit. Add the folder that you extracted {{code|rsgain.exe}} to in the previous step.

===macOS===
There is currently no binary package available for macOS, so Mac users will need to build from source. See the [https://github.com/complexlogic/rsgain/blob/master/docs/BUILDING.md#building build instructions on GitHub].

===Linux===
An amd64 .deb package is provided on the [https://github.com/complexlogic/rsgain/releases/latest GitHub release page]. It is installable on most APT-based distro releases from 2020 and later. There is also a [https://github.com/complexlogic/rsgain/blob/master/config/PKGBUILD PKGBUILD script] available for Arch/Manjaro users.

Users of other distros will need to build from source. See the [https://github.com/complexlogic/rsgain/blob/master/docs/BUILDING.md#building build instructions on GitHub].

==Usage==
rsgain has two modes of operation: Easy Mode and Custom Mode. Easy Mode is recommended over Custom Mode for almost all use cases. Custom Mode exists to provides backwards compatibility with the legacy loudgain/mp3gain command line.

===Easy Mode===
Easy Mode recursively scans your entire music library using the recommended settings for each file type. You can use Easy Mode if the following conditions apply:
* Your music library is organized by album, i.e. each album has its own folder
* In each album folder, all audio files are of the same type. It is acceptable to have non-audio files mixed in such as log files or artwork, but if multiple ''audio'' file types are detected, the folder will not be scanned.

Easy Mode is invoked with the command {{code|rsgain easy}} followed by the root of the directory you want to scan, e.g.:

{{code|rsgain easy /path/to/music/library}}

{{code|rsgain easy "C:\path\to\music library"}}

This is all that is required for most users. Advanced users should see [[#Setting_Overrides|Setting Overrides]] for more information about the default settings and how to override them, if desired.

====Multithreaded Scanning====
Easy Mode includes optional multithreaded operation to speed up the duration of a scan. Use the {{code|-m}} option, followed by the number of threads to create. The number of threads must be one per physical CPU core or fewer. For example, if you have a quad core CPU:

{{code|rsgain easy -m 4 /path/to/music/library}}

The scan progress bar is automatically disabled in multithreaded operation because multiple files are being scanned in parallel.

The speed gains offered by multithreaded scanning are significant. With {{code|-m 4}} or higher, you can typically expect to see speed gains of 60-70%. However, you will also have close to 100% CPU utilization when scanning multithreaded. Consider using multithreaded on a full library scan, and the default single threaded mode when incrementally adding one or two albums to your library.

====Setting Overrides====
Easy Mode scans files with the following settings by default:
* Clipping protection enabled
* Lowercase tags for MP2/MP3, M4A, WMA, WAV, and AIFF (uppercase for all others)
* Decibal units
* All optional tags enabled:
** Range calculations
** Peak calcuations
** Reference loudness
** Album tags
* ID3 version 2.3 tags
* Strip obsolete ID3 version 1 tags
* -1 dBTP max true peak
* No pregain

These settings are recommended for maximum comptatibility with available players. However, if you need one of the settings changed, you can override them on a per-format basis using the {{code|-o}} option, and an overrides file.

The overrides file is an INI-formatted file that contains sections enclosed in square brackets which correspond to the available formats, and each section contains key=value pairs that correspond to settings. The overrides feature is intended for users that can't use the default settings of Easy Mode, but still prefer the functionality of Easy Mode over Custom Mode.

For example, rsgain writes lowercase tags on MP3 files by default, but suppose you want uppercase tags instead. Format your {{code|overrides.ini}} file as follows:

<pre>
[MP3]
Lowercase=false
</pre>

Then, pass the path to the overrides file with the {{code|-o}} option:

{{code|rsgain easy -o /path/to/overrides.ini /path/to/music/library}}

A default {{code|overrides.ini}} file ships with rsgain in the root package directory for Windows, and in {{code|<install prefix>/share/rsgain}} for Unix. The file is pre-populated will all settings that are available to change. Note that this is an ''overrides'' file, not a configuration file, i.e any formats or settings you're not interested in can simply be deleted and the defaults will be used instead.

===Custom Mode===
Custom Mode preserves loudgain's command line syntax for users that still need it. Unlike Easy Mode, Custom Mode works with files, not directories. If you want recursive directory-based scanning, you will need to use a wrapper script.

Custom Mode is invoked with {{code|rsgain custom}} followed by options and a list of files to scan. For example, scan all FLAC files in the current directory with album gain and clipping protection enabled:

{{code|rsgain custom -a -k -s e *.flac}}

See the command line help for all available options:

<pre>
Usage: rsgain custom [OPTIONS] FILES...
Custom Mode allows the user to specify the options to scan the files with. The
list of files to scan must be listed explicitly after the options.

Options:
-h, --help Show this help.

-r, --track Calculate track gain only (default).
-a, --album Calculate album gain (and track gain).

-c, --clip Ignore clipping warning.
-k, --noclip Lower track/album gain to avoid clipping (<= -1 dBTP).
-K n, --maxtpl=n Avoid clipping; max. true peak level = n dBTP.
-d n, --pregain=n Apply n dB/LU pre-gain value (-5 for -23 LUFS target).

-s d, --tagmode=d Delete ReplayGain tags from files.
-s i, --tagmode=i Write ReplayGain 2.0 tags to files.
-s e, --tagmode=e like '-s i', plus extra tags (reference, ranges).
-s l, --tagmode=l like '-s e', but LU units instead of dB.
-s s, --tagmode=s Don't write ReplayGain tags (default).

-L, --lowercase Force lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF).
This is non-standard but sometimes needed.
-S, --striptags Strip tag types other than ID3v2 from MP2/MP3.
Strip tag types other than APEv2 from WavPack/APE.
-I 3, --id3v2version=3 Write ID3v2.3 tags to MP2/MP3/WAV/AIFF.
-I 4, --id3v2version=4 Write ID3v2.4 tags to MP2/MP3/WAV/AIFF (default).

-O, --output Database-friendly tab-delimited list output.
-q, --quiet Don't print scanning status messages.

Please report any issues to https://github.com/complexlogic/rsgain/issues
</pre>

==Format Support==
rsgain has support for the following file formats:
* [[MP2]]/[[MP3]]
* [[FLAC]]
* [[Ogg]] ([[Vorbis]], [[Speex]])
* [[Opus]]
* [[M4A]] ([[AAC]], [[ALAC]])
* [[WMA]]
* [[WAV]]
* [[Wavpack]]
* [[Monkey's Audio]]

==See also==
* [[ReplayGain]]
* [[ReplayGain 2.0 specification]]

==External links==
* [https://github.com/complexlogic/rsgain/ rsgain GitHub page]
* [https://en.wikipedia.org/wiki/EBU_R_128 EBU R128]

[[Category:Software]]

File:Rsgain help.png

2022-05-11T05:29:46Z

Complexlogic: rsgain help screen.

rsgain help screen.

Loudgain

2022-02-22T04:05:16Z

Complexlogic:

{{Software Infobox
| name = loudgain
| screenshot = [[File:Loudgain-terminal.png|256px]]
| caption = Loudgain running in a Linux terminal window.
| developer = Matthias C. Hormann, Alessandro Ghedini
| released = 2014-06-22
| stable_release = 0.6.8
| stable_release_date = 2019-09-06
| operating_system = Linux, MacOS, Windows
| use = Tagging
| license = BSD license
| website = [https://github.com/Moonbase59/loudgain/]
}}
'''loudgain''' is an open-source [[ReplayGain 2.0 specification|ReplayGain 2]] tagging tool for Linux, MacOS (via Homebrew) and Windows. It analyzes many types of audio files, based on the EBU R128/ITU BS.1170 standard (at -18 LUFS), and uses the well-known [[MP3Gain]] commandline syntax. Loudgain never modifies the audio data, but instead only writes the appropriate ReplayGain tags.

For ''mass-tagging'' (assuming one album per folder), loudgain comes with a bash script called <code>rgbpm</code> that can be modified to the user’s needs.

==Technical details==
Loudgain computes the [[ReplayGain]] (volume adjustment), ''true peak'' value and loudness range, using the ''EBU R128'' algorithm for each track and (optionally) a whole album. The optional ''clipping prevention'' feature can further reduce the computed gain to a level where no clipping should occur (default -1 dBTP). Computed values are then written to the audio files as ''tags'' in a suitable tag format.

For extra versatility, loudgain also supports writing the ''loudness range'' and ''loudness reference'' values, forcing upper- or lowercase ReplayGain tags, and stripping "foreign" tags from some file types.

In case of writing [[ID3v2]] tags, these can be specified to be either ''ID3v2.4'' (default) or ''ID3v2.3''. Any neccessary conversions will be done internally (i.e., converting UTF-8 frames to UTF-16 when going from ID3v2.4 to ID3v2.3).

==Supported file formats==
* Supported audio file formats as of version 0.6.8:
** [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** MP2, [[MP3]]: Values written to [[ID3v2]] tags (ID3v2.3/ID3v2.4 selectable).
** (Ogg) [[Vorbis]]: Values written to [[Vorbis comment]].
** (Ogg) [[Free Lossless Audio Codec|FLAC]]: Values written to [[Vorbis comment]].
** (Ogg) [[Speex]]: Values written to [[Vorbis comment]].
** [[Opus]]: Values written to [[Vorbis comment]], based on -23 LUFS Opus standard. Only <code>R128_TRACK_GAIN</code> and <code>R128_ALBUM_GAIN</code> are written, but the calculated ''true peak'' value can still be used to reduce the gain values ([[Clipping]] prevention).
** [[MP4]], [[M4A]]: Uses its own iTunes-compatible tagging system (though iTunes does not support ReplayGain). ReplayGain values are stored under <code>----:com.apple.iTunes:…</code>. This is for [[Advanced Audio Coding|AAC]] and [[ALAC]] in [[MPEG-4]] containers.
** [[Advanced Streaming Format|ASF]], [[Windows Media Audio|WMA]]: Values written to WMA tags, no prefix.
** [[WAV]]: Values written to the <code>ID3 </code> chunk, in [[ID3v2]] (ID3v2.3/ID3v2.4 selectable) format. Using the <code>bext</code> chunk (for BWF v2) isn’t (yet) supported, but won’t be destroyed on writing.
** [[Audio Interchange File Format|AIFF]]: Values written to the <code>ID3 </code> chunk, in [[ID3v2]] format.
** [[WavPack]]: Values written to [[APEv2]] tags.
** [[Monkey's Audio]] (APE): Values written to [[APEv2]] tags.

==Command line help==
<pre>
Usage: loudgain [OPTIONS] FILES...

loudgain 0.6.8 supports writing tags to the following file types:
FLAC (.flac), Ogg (.ogg, .oga, .spx, .opus), MP2 (.mp2), MP3 (.mp3),
MP4 (.mp4, .m4a), ASF/WMA (.asf, .wma), WavPack (.wv), APE (.ape).
Experimental: WAV (.wav), AIFF (.aiff, .aif).

Options:
-h, --help Show this help.
-v, --version Show version number.

-r, --track Calculate track gain only (default).
-a, --album Calculate album gain (and track gain).

-c, --clip Ignore clipping warning.
-k, --noclip Lower track/album gain to avoid clipping (<= -1 dBTP).
-K n, --maxtpl=n Avoid clipping; max. true peak level = n dBTP.
-d n, --pregain=n Apply n dB/LU pre-gain value (-5 for -23 LUFS target).

-s d, --tagmode=d Delete ReplayGain tags from files.
-s i, --tagmode=i Write ReplayGain 2.0 tags to files.
-s e, --tagmode=e like '-s i', plus extra tags (reference, ranges).
-s l, --tagmode=l like '-s e', but LU units instead of dB.
-s s, --tagmode=s Don't write ReplayGain tags (default).

-L, --lowercase Force lowercase tags (MP2/MP3/MP4/WMA/WAV/AIFF).
This is non-standard but sometimes needed.
-S, --striptags Strip tag types other than ID3v2 from MP2/MP3.
Strip tag types other than APEv2 from WavPack/APE.
-I 3, --id3v2version=3 Write ID3v2.3 tags to MP2/MP3/WAV/AIFF.
-I 4, --id3v2version=4 Write ID3v2.4 tags to MP2/MP3/WAV/AIFF (default).

-o, --output Database-friendly tab-delimited list output.
-O, --output-new New format tab-delimited list output.
-q, --quiet Don't print scanning status messages.

Please report any issues to https://github.com/Moonbase59/loudgain/issues.
</pre>

==Closer analysis of files==
[[Image:Loudgain-csv.png|thumb|Album data in spreadsheet]]
Using the <code>-O</code> (uppercase letter O) switch, loudgain can produce a detailed tab-separated list, ideal for redirection into a <code>.csv</code> spreadsheet file and later analysis.

Simply use a command like the following and then import the <code>album.csv</code> file into your spreadsheet application, specifying "tab-delimited CSV":
<pre>
loudgain -O [OPTIONS] FILES... > album.csv
</pre>

==loudgain on Windows==
[[Image:Loudgain-windows10-bash.png|thumb|loudgain in Windows 10’s ''Linux bash'']]
Loudgain was forked and ported to run natively in Windows by complexlogic in 2022. It is available in source and executable form [https://github.com/complexlogic/loudgain on GitHub].

Alternatively, the main version of loudgain can easily be used with Windows 10’s ''Linux bash''. Detailed installation instructions can be found on [https://github.com/Moonbase59/loudgain#installation-on-windows-10-linux-bash loudgain’s GitHub page].

==Known problems==
* Loudgain relies on standard libraries like ''TagLib''. Linux distros (except rolling releases) sometimes deliver outdated libraries, so '''be sure you use the latest version of ''TagLib''.''' Version 1.11.1 had a nasty bug for a while that [https://hydrogenaud.io/index.php/topic,118085.msg974957.html#msg974957 could corrupt Ogg Vorbis files]. This has been fixed in the meantime but the TagLib version not updated. Loudgain comes with a (slower) static version called <code>loudgain.static</code> in the repo’s <code>/bin</code> folder that doesn’t expose the bug and can also be used on older Linux versions (like Ubuntu 14.04, Linux Mint 17).
* ''TagLib'' versions prior to Version 1.12 couldn’t write ''ID3v2.3'' tags to AIFF files. This now works if loudgain is compiled against ''TagLib 1.12 or newer''.

==Development==
loudgain v0.1 was originally developed by Alessandro Ghedini in 2014.

[[User:Moonbase|Matthias C. Hormann]] forked this version in 2019 and took over the development of loudgain after version 0.1, starting with version 0.2.1.
The latest version is '''0.6.8'''.

==See also==
* [[ReplayGain]]
* [[ReplayGain 2.0 specification]]

==External links==
* [https://github.com/Moonbase59/loudgain/ loudgain on GitHub]
* [https://github.com/complexlogic/loudgain Windows port of loudgain on Github]
* [https://github.com/Moonbase59/loudgain#technical-details-advanced-users-stuff loudgain technical details on GitHub]
* [https://github.com/Moonbase59/loudgain/issues loudgain bug tracker]
* [https://aur.archlinux.org/packages/loudgain/ loudgain in the ArchLinux User Repository (AUR)]

[[Category:Software]]