mp3gain.1 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130
  1. .TH MP3GAIN "1" "Nov 2021" "mp3gain-1.6.2" "SlackBuilds.org"
  2. .SH NAME
  3. mp3gain \- analyzes and adjusts mp3 files so that they have the same volume
  4. .SH SYNOPSIS
  5. .B mp3gain
  6. [\fIoptions\fR] \fI<infile> \fR[\fI<infile 2> \fR...]
  7. .SH DESCRIPTION
  8. Tired of reaching for your volume knob every time your mp3 player changes to a new song?
  9. MP3Gain analyzes and adjusts mp3 files so that they have the same volume.
  10. .PP
  11. 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.
  12. .PP
  13. 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.
  14. .SH OPTIONS
  15. .TP
  16. \fB\-v\fR
  17. show version number
  18. .TP
  19. \fB\-g\fR \fIgain\fR
  20. apply \fIgain\fR to mp3 without doing any analysis.
  21. .TP
  22. \fB\-l\fR 0 \fIgain\fR
  23. apply \fIgain\fR to channel 0 (left channel) of mp3
  24. without doing any analysis (ONLY works for STEREO mp3s,
  25. not Joint Stereo mp3s).
  26. .TP
  27. \fB\-l\fR 1 \fIgain\fR
  28. apply \fIgain\fR to channel 1 (right channel) of mp3.
  29. .TP
  30. \fB\-e\fR
  31. skip album analysis, even if multiple files listed.
  32. .TP
  33. \fB\-r\fR
  34. apply track gain automatically (all files set to equal loudness).
  35. .TP
  36. \fB\-k\fR
  37. automatically lower track/album gain to not clip audio.
  38. .TP
  39. \fB\-a\fR
  40. apply album gain automatically (files are all from the same
  41. album: a single gain change is applied to all files, so
  42. their loudness relative to each other remains unchanged,
  43. but the average album loudness is normalized).
  44. .TP
  45. \fB\-m\fR \fIgain\fR
  46. modify suggested MP3 gain by integer \fIgain\fR.
  47. .TP
  48. \fB\-d\fR \fIdbgain\fR
  49. modify suggested dB gain by floating\-point \fIdbgain\fR.
  50. .TP
  51. \fB\-c\fR
  52. ignore clipping warning when applying gain.
  53. .TP
  54. \fB\-o\fR
  55. output is a database\-friendly tab\-delimited list.
  56. .TP
  57. \fB\-t\fR
  58. mp3gain writes modified mp3 to temp file, then deletes original
  59. instead of modifying bytes in original file (default).
  60. .TP
  61. \fB\-T\fR
  62. mp3gain directly modifies mp3 file (opposite of \-t).
  63. .TP
  64. \fB\-q\fR
  65. quiet mode: no status messages.
  66. .TP
  67. \fB\-p\fR
  68. preserve original file timestamp.
  69. .TP
  70. \fB\-x\fR
  71. only find max. amplitude of mp3.
  72. .TP
  73. \fB\-f\fR
  74. force mp3gain to assume input file is an MPEG 2 Layer III file
  75. (i.e. don't check for mis\-named Layer I or Layer II files).
  76. .TP
  77. \-? or \fB\-h\fR
  78. show built\-in help message.
  79. .TP
  80. \fB\-s c\fR
  81. only check stored tag info (no other processing).
  82. .TP
  83. \fB\-s d\fR
  84. delete stored tag info (no other processing).
  85. .TP
  86. \fB\-s s\fR
  87. skip (ignore) stored tag info (do not read or write tags).
  88. .TP
  89. \fB\-s r\fR
  90. force re\-calculation (do not read tag info).
  91. .TP
  92. \fB\-s i\fR
  93. use ID3v2 tag for MP3 gain info.
  94. .TP
  95. \fB\-s a\fR
  96. use APE tag for MP3 gain info (default).
  97. .TP
  98. \fB\-u\fR
  99. undo changes made by mp3gain (based on stored tag info).
  100. .TP
  101. \fB\-w\fR
  102. "wrap" gain change if gain+change > 255 or gain+change < 0
  103. (use "\-h wrap" switch for a complete explanation).
  104. .PP
  105. If you specify \fB\-r\fR and \fB\-a\fR, only the second one will work.
  106. If you do not specify \fB\-c\fR, the program will stop and ask before
  107. applying gain change to a file that might clip.
  108. .SH AUTHORS
  109. Coding by Glen Sawyer
  110. .br
  111. Unix\-ification by Stefan Partheymüller
  112. .br
  113. DLL\-ification by John Zitterkopf
  114. .br
  115. Additional tweaks by Artur Polaczynski, Mark Armbrust, and others
  116. .PP
  117. Man page created by B. Watson for the SlackBuilds.org project, but may
  118. be used by others.
  119. .SH COPYRIGHT
  120. Copyright(c) 2001\-2004 by Glen Sawyer.
  121. .PP
  122. mp3gain uses mpglib, which can be found at \fIhttp://www.mpg123.de\fR.
  123. .PP
  124. mp3gain is free software; you can redistribute it and/or
  125. modify it under the terms of the GNU Lesser General Public
  126. License as published by the Free Software Foundation; either
  127. version 2.1 of the License, or (at your option) any later version.
  128. .SH SEE ALSO
  129. \fBnormalize(1)\fR