Metadata-Version: 2.1
Name: r128gain
Version: 1.0.7
Summary: Fast audio loudness scanner & tagger
Home-page: https://github.com/desbma/r128gain
Author: desbma
License: UNKNOWN
Download-URL: https://github.com/desbma/r128gain/archive/1.0.7.tar.gz
Description: # r128gain
        
        ## Fast audio loudness scanner & tagger
        
        [![PyPI version](https://img.shields.io/pypi/v/r128gain.svg?style=flat)](https://pypi.python.org/pypi/r128gain/)
        [![AUR version](https://img.shields.io/aur/version/r128gain.svg?style=flat)](https://aur.archlinux.org/packages/r128gain/)
        [![Tests status](https://github.com/desbma/r128gain/actions/workflows/ci.yml/badge.svg)](https://github.com/desbma/r128gain/actions/)
        [![Coverage](https://img.shields.io/coveralls/desbma/r128gain/master.svg?style=flat)](https://coveralls.io/github/desbma/r128gain?branch=master)
        [![Supported Python versions](https://img.shields.io/pypi/pyversions/r128gain.svg?style=flat)](https://pypi.python.org/pypi/r128gain/)
        [![License](https://img.shields.io/github/license/desbma/r128gain.svg?style=flat)](https://github.com/desbma/r128gain/blob/master/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](https://tools.ietf.org/html/rfc7845#section-5.2))
        - Supports writing gain to the [Opus _output gain_ header](https://tools.ietf.org/html/rfc7845#page-15) (**experimental**)
        - Uses threading to optimally use processor cores resulting in very fast processing
        
        ## Installation
        
        r128gain requires [Python](https://www.python.org/downloads/) >= 3.6 and [FFmpeg](https://www.ffmpeg.org/download.html) >= 2.8.
        
        ### Standalone Windows executable
        
        Windows users can download a [standalone binary](https://github.com/desbma/r128gain/releases/latest) which does not require Python, and bundles FFmpeg.
        
        ### Arch Linux
        
        Arch Linux users can install the [r128gain](https://aur.archlinux.org/packages/r128gain/) AUR package.
        
        ### From PyPI (with PIP)
        
        Install r128gain using [pip](https://pip.pypa.io/en/stable/installing/): `pip3 install r128gain`
        
        ### From source
        
        1. If you don't already have it, [install setuptools](https://pypi.python.org/pypi/setuptools#installation-instructions) 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](https://www.gnu.org/licenses/old-licenses/lgpl-2.1-standalone.html)
        
Keywords: audio,loudness,replaygain,replay,gain,r128,tag,opus,normalize,normalization,level
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
