Skip to content

Latest commit

 

History

History
105 lines (71 loc) · 2.67 KB

README.md

File metadata and controls

105 lines (71 loc) · 2.67 KB

loudness-scanner

loudness-scanner is a tool that scans your music files according to the EBU R128 standard for loudness normalisation. It optionally adds ReplayGain compatible tags to the files.

All source code is licensed under the MIT license. See LICENSE file for details.

Features

  • Supports all libebur128 features:
    • Portable ANSI C code
    • Implements M, S and I modes
    • Implements loudness range measurement (EBU - TECH 3342)
    • True peak scanning
    • Supports all samplerates by recalculation of the filter coefficients
  • ReplayGain compatible tagging support for MP3, OGG, Musepack, FLAC and more

Requirements

  • Glib
  • taglib

input plugins (all optional):

  • libsndfile
  • ffmpeg

optional GUI frontends:

  • GTK2

or

  • Qt

Installation

In the root folder, type:

mkdir build
cd build
cmake ..
make

If you want the git version, run:

git clone https://github.com/jiixyj/loudness-scanner.git
cd loudness-scanner
git submodule init
git submodule update

Usage

Run "loudness scan" with the files you want to scan as arguments. The scanner will automatically choose the best input plugin for each file. You can force an input plugin with the command line option "--force-plugin=PLUGIN", where PLUGIN is one of sndfile or ffmpeg.

The scanner also support ReplayGain tagging. Run it like this:

loudness tag <files>     # scan files as album

or:

loudness tag -t <files>  # scan files as single tracks

Use the option "-r" to search recursively for music files and tag them as one album per subfolder.

Some more advanced tagging options are supported as well:

  • incremental tagging
  • forcing files to be treated as a single album (even though the files might be scattered over multiple folders)
  • REPLAYGAIN_* tags for Opus files (may be useful for older player software)
  • fine control over what values are written into the Opus header gain field

The reference volume for tagging is -18 LUFS (5 dB louder than the EBU R 128 reference level of -23 LUFS). See here for more details and sources.

Use the option "-p" to print information about peak values. Use "-p sample" for sample peaks, "-p true" for true peaks, "-p dbtp" for true peaks in dBTP and "-p all" to print all values.

The scanner supports loudness range measurement with the command line option "-l".

In "dump" mode, use the options "-s", "-m" or "-i" to print short-term (last 3s), momentary (last 0.4s) or integrated loudness information to stdout. For example:

loudness dump -m 0.1 foo.wav

to print the momentary loudness of foo.wav to stdout every 0.1s.