slackbuilds_ponce/audio/mp3gain/mp3gain.1
B. Watson 08c93ef22e
audio/mp3gain: Update man page.
Signed-off-by: B. Watson <yalhcru@gmail.com>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
2021-12-04 10:08:57 +07:00

129 lines
3.8 KiB
Groff

.TH MP3GAIN "1" "Nov 2021" "mp3gain-1.6.2" "SlackBuilds.org"
.SH NAME
mp3gain \- analyzes and adjusts mp3 files so that they have the same volume
.SH SYNOPSIS
.B mp3gain
[\fIoptions\fR] \fI<infile> \fR[\fI<infile 2> \fR...]
.SH DESCRIPTION
Tired of reaching for your volume knob every time your mp3 player changes to a new song?
MP3Gain analyzes and adjusts mp3 files so that they have the same volume.
.PP
MP3Gain does not just do peak normalization, as many normalizers do. Instead, it does some statistical analysis to determine how loud the file actually sounds to the human ear.
.PP
Also, the changes MP3Gain makes are completely lossless. There is no quality lost in the change because the program adjusts the mp3 file directly, without decoding and re\-encoding.
.SH OPTIONS
.TP
\fB\-v\fR
show version number
.TP
\fB\-g\fR \fIgain\fR
apply \fIgain\fR to mp3 without doing any analysis.
.TP
\fB\-l\fR 0 \fIgain\fR
apply \fIgain\fR to channel 0 (left channel) of mp3
without doing any analysis (ONLY works for STEREO mp3s,
not Joint Stereo mp3s).
.TP
\fB\-l\fR 1 \fIgain\fR
apply \fIgain\fR to channel 1 (right channel) of mp3.
.TP
\fB\-e\fR
skip album analysis, even if multiple files listed.
.TP
\fB\-r\fR
apply track gain automatically (all files set to equal loudness).
.TP
\fB\-k\fR
automatically lower track/album gain to not clip audio.
.TP
\fB\-a\fR
apply album gain automatically (files are all from the same
album: a single gain change is applied to all files, so
their loudness relative to each other remains unchanged,
but the average album loudness is normalized).
.TP
\fB\-m\fR \fIgain\fR
modify suggested MP3 gain by integer \fIgain\fR.
.TP
\fB\-d\fR \fIdbgain\fR
modify suggested dB gain by floating\-point \fIdbgain\fR.
.TP
\fB\-c\fR
ignore clipping warning when applying gain.
.TP
\fB\-o\fR
output is a database\-friendly tab\-delimited list.
.TP
\fB\-t\fR
mp3gain writes modified mp3 to temp file, then deletes original
instead of modifying bytes in original file (default).
.TP
\fB\-T\fR
mp3gain directly modifies mp3 file (opposite of \-t).
.TP
\fB\-q\fR
quiet mode: no status messages.
.TP
\fB\-p\fR
preserve original file timestamp.
.TP
\fB\-x\fR
only find max. amplitude of mp3.
.TP
\fB\-f\fR
force mp3gain to assume input file is an MPEG 2 Layer III file
(i.e. don't check for mis\-named Layer I or Layer II files).
.TP
\-? or \fB\-h\fR
show built\-in help message.
.TP
\fB\-s c\fR
only check stored tag info (no other processing).
.TP
\fB\-s d\fR
delete stored tag info (no other processing).
.TP
\fB\-s s\fR
skip (ignore) stored tag info (do not read or write tags).
.TP
\fB\-s r\fR
force re\-calculation (do not read tag info).
.TP
\fB\-s i\fR
use ID3v2 tag for MP3 gain info.
.TP
\fB\-s a\fR
use APE tag for MP3 gain info (default).
.TP
\fB\-u\fR
undo changes made by mp3gain (based on stored tag info).
.TP
\fB\-w\fR
"wrap" gain change if gain+change > 255 or gain+change < 0
(use "\-h wrap" switch for a complete explanation).
.PP
If you specify \fB\-r\fR and \fB\-a\fR, only the second one will work.
If you do not specify \fB\-c\fR, the program will stop and ask before
applying gain change to a file that might clip.
.SH AUTHORS
Coding by Glen Sawyer
.br
Unix\-ification by Stefan Partheymüller
.br
DLL\-ification by John Zitterkopf
.br
Additional tweaks by Artur Polaczynski, Mark Armbrust, and others
.PP
Man page created by B. Watson for the SlackBuilds.org project, but may
be used by others.
.SH COPYRIGHT
Copyright(c) 2001\-2004 by Glen Sawyer.
.PP
mp3gain uses mpglib, which can be found at \fIhttp://www.mpg123.de\fR.
.PP
mp3gain is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
.SH SEE ALSO
\fBnormalize(1)\fR