Skip to main content

r128gain

Fast audio loudness scanner & tagger

PyPI version AUR version Tests status Coverage Supported Python versions License

r128gain is a multi platform command line tool to scan your audio files and tag them with loudness metadata (ReplayGain v2 or Opus R128 gain format), to allow playback of several tracks or albums at a similar loudness level. r128gain can also be used as a Python module from other Python projects to scan and/or tag audio files.

This is beta software, please test and report bugs.

Features

  • Supports all common audio file formats (MP3, AAC, Vorbis, Opus, FLAC, WavPack...) and tag formats (ID3, Vorbis comments, MP4, APEv2...)
  • Writes tags compatible with music players reading track/album gain metadata
  • Supports new R128_XXX_GAIN tag format for Opus files (very few scanners write this tag, although it is defined in the Opus standard)
  • Supports writing gain to the Opus output gain header (experimental)
  • Uses threading to optimally use processor cores resulting in very fast processing

Installation

r128gain requires Python >= 3.6 and FFmpeg >= 2.8.

Standalone Windows executable

Windows users can download a standalone binary which does not require Python, and bundles FFmpeg.

Arch Linux

Arch Linux users can install the r128gain AUR package.

From PyPI (with PIP)

Install r128gain using pip: pip3 install r128gain

From source

  1. If you don't already have it, install setuptools for Python 3
  2. Clone this repository: git clone https://github.com/desbma/r128gain
  3. Install r128gain: python3 setup.py install

Command line usage

Run r128gain -h to get full command line reference.

Examples

  • Scan a single file and display its loudness information: r128gain -d an_audio_file.mp3
  • Scan & tag a single file: r128gain an_audio_file.mp3
  • Scan & tag all audio files in music_directory and all its subdirectories: r128gain -r music_directory
  • Scan & tag all audio files in music_directory and all its subdirectories, and add album gain tags (files contained in each directory are considered as part of the same album): r128gain -r -a music_directory

License

LGPLv2

Metadata

Release files for r128gain 1.0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for r128gain 1.0.7
File Size Uploaded Provenance Actions
r128gain-1.0.7.tar.gz 26.0 kB Without provenance Details for r128gain-1.0.7.tar.gz

Release files / r128gain-1.0.7.tar.gz

Download URL r128gain-1.0.7.tar.gz
Size 26.0 kB
Tags Source
SHA-256 checksum
How to use checksums
ece984b8609258989a9158c7f676e1b69402381f535597bf43397e2bb53651e4
BLAKE2b-256 checksum
How to use checksums
f7fbafd16c3ce447da630720ca16b4826d419b020d266ac6a758d4e33bfb97b1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.10

Security for r128gain 1.0.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page