r128gain - Man Page

Synopsis

r128gain [-h] [-a] [-r] [-s] [-o] [-p [MTIME_SECOND_OFFSET]] [-c THREAD_COUNT] [-f FFMPEG_PATH] [-d] [-v {warning,normal,debug}] path [path ...]

Description

r128gain v1.0.7. Scan audio files and tag them with ReplayGain/R128 loudness metadata.

path

Audio file paths, or directory paths for recursive mode

Options

-a,  --album-gain

Enable album gain

-r,  --recursive

Enable recursive mode: process audio files in directories and subdirectories. If album gain is enabled, all files in a directory are considered as part of the same album.

-s,  --skip-tagged

Do not scan & tag files already having loudness tags. Warning: only enable if you are sure of the validity of the existing tags, as it can cause volume differences if existing tags are incorrect or coming from a old RGv1 tagger.

-o,  --opus-output-gain

For Opus files, write album or track gain in the 'output gain' Opus header (see https://tools.ietf.org/html/rfc7845#page-15). This gain is mandatory to apply for all Opus decoders so this should improve compatibility with players not supporting the R128 tags. Warning: This is EXPERIMENTAL, only use if you fully understand the implications.

-p [MTIME_SECOND_OFFSET], --preserve-times [MTIME_SECOND_OFFSET]

Preserve modification times of tagged files, optionally adding MTIME_SECOND_OFFSET seconds.

-c THREAD_COUNT, --thread-count THREAD_COUNT

Maximum number of tracks to scan in parallel. If not specified, autodetect CPU count

-f FFMPEG_PATH, --ffmpeg-path FFMPEG_PATH

Full file path of ffmpeg executable (only needed if not in PATH). If not specified, autodetect

-d,  --dry-run

Do not write any tags, only show scan results

-v {warning,normal,debug}, --verbosity {warning,normal,debug}

Level of logging output

Author

desbma

Distribution

The latest version of python-r128gain may be downloaded from https://github.com/desbma/r128gain

Info

2023-07-21 python-r128gain Generated Python Manual