1vorbisgain(1) VorbisGain vorbisgain(1)
2
6 vorbisgain - calculate the replay gain for Ogg Vorbis files
7
10 vorbisgain [ -acCdfhqrsv ] [ -g album gain ] input_files ...
11
14 vorbisgain calculates the ReplayGain values for the named Ogg Vorbis
15 input files and writes back the result in the form of tags (comments)
16 in the file. These values can be used by a playback program to maintain
17 a uniform sound level during play. (See http://www.replaygain.org/ for
18 more information.) vorbisgain uses a default target level of 89 dB,
19 rather than the 83 dB recommended by the ReplayGain standard, when cal‐
20 culating the gain to apply. (Some players include a pre-amplification
21 setting with which the target level can be changed.)
22 vorbisgain input files must be Ogg Vorbis I files with 1 or 2 channels
25 and a sample rate of 48 kHz, 44.1 kHz, 32 kHz, 24 kHz, 22050 Hz, 16
26 kHz, 12 kHz, 11025 Hz or 8 kHz. If an input file contains multiple
27 streams (i.e., it is chained), the streams must all have the same for‐
28 mat, in terms of sampling frequency and number of channels.
29 All streams in a chained file are processed, but the ReplayGain tags
32 are only written to (or removed from) the first stream.
33
36 -h, --help
37 Show command help.
38 -a, --album
41 Activates album mode, in which the album gain (sometimes called
42 the audiophile gain) is calculated in addition to the track gain
43 (sometimes called the radio gain).
44 -g n, --album-gain=n
47 Sets the album gain value to use. Default is to calculate it, if
48 -a is specified. Implies -a in the sense that the album gain tag
49 is written. This is a relative value, in dB, specifying the
50 change in volume that should be applied.
51 -c, --clean
54 Remove any ReplayGain tags from the specified files. If a file
55 does not contain any ReplayGain tags, the file is not modified.
56 -C, --convert
59 Convert old format ReplayGain tags to a new format (see section
60 TAG FORMAT below for details). If a file does not contain all
61 ReplayGain tags that are needed for a conversion, the file is
62 not modified. The album peak tag is only created if -a is speci‐
63 fied, and the album gain value is then checked for consistency.
64 Otherwise any album gain is converted without any checks.
65 -d, --display-only
68 Display the result only; do not write anything to disk. This
69 applies to all options.
70 -f, --fast
73 Only calculate the gain for files that do not contain all replay
74 gain tags needed (the album gain and peak tags are only consid‐
75 ered if -a has been specified).
76 -n, --no-progress
79 Only display results, but don't show progress in percentages and
80 times. This can be useful if the output is piped into other pro‐
81 grams.
82 -q, --quiet
85 Do not display any output while processing. Only error and warn‐
86 ing messages will be printed.
87 -r, --recursive
90 Enter directories (recursively) and search for files, if direc‐
91 tories or file patterns are specified. Note: Only available if
92 vorbisgain was configured with --enable-recursive.
93 -s, --silent
96 Silently skip any non-Vorbis files found. Vorbis files that
97 can't be processed for some reason are skipped as well, though
98 not silently. Default is to stop when such files are encoun‐
99 tered.
100 -v, --version
103 Display the version of the program.
104
107 Simplest version. Calculate the track gain and peak only.
108 vorbisgain somefile.ogg
110 Note that the following examples are only possible if vorbisgain was
113 configured with --enable-recursive.
114 Calculate the album gain and peak, in addition to the track gain and
117 peak, for all .ogg files in the directory "music" (and all subdirecto‐
118 ries). All files in one directory are treated as belonging to the same
119 album. Files that already have ReplayGain tags are not re-calculated.
120 Note the quotes, as they cause the shell to not do any filename glob‐
121 bing:
122 vorbisgain -a -f -r "music/*.ogg"
125 Calculate the album gain. The files specified before the directory
128 "album" are treated as one album, the files in the directory "album" as
129 another album and the remaining files as a third album:
130 vorbisgain -a -r a.ogg b.ogg c.ogg album d.ogg e.ogg f.ogg
133 Remove all replaygain tags from a collection of oggs:
136 vorbisgain -c -r "music/*.ogg"
139
142 vorbisgain creates tags like these (when in -a mode):
143 REPLAYGAIN_TRACK_GAIN=-7.03 dB
146 REPLAYGAIN_TRACK_PEAK=1.21822226
147 REPLAYGAIN_ALBUM_GAIN=-6.37 dB
148 REPLAYGAIN_ALBUM_PEAK=1.21822226
149 Gain specifies how much the volume should be changed before playback,
152 in dB. Peak is the maximum sample value of the file before any gain
153 has been applied, where 1.0 means "full sample value" (32,767 when
154 decoding to signed 16 bit samples).
155 Earlier versions of vorbisgain (before 0.30) created the following
158 tags:
159 RG_RADIO
162 RG_PEAK
163 RG_AUDIOPHILE
164 When -c is used, RG_RADIO is converted to REPLAYGAIN_TRACK_GAIN,
167 RG_PEAK to REPLAYGAIN_TRACK_PEAK, RG_AUDIOPHILE to REPLAY‐
168 GAIN_ALBUM_GAIN and REPLAYGAIN_ALBUM_PEAK is calculated as the maximum
169 of all RG_PEAK tags in the album.
170
173 Program Code:
174 Gian-Carlo Pascutto <gcp@sjeng.org>
175 Magnus Holmgren <lear@algonet.se>
176 ReplayGain Analysis Code:
179 Glen Sawyer <glensawyer@hotmail.com>
180 Frank Klemm (http://www.uni-jena.de/~pfk/)
181 Man Page:
184 Magnus Holmgren <lear@algonet.se>
185
188 None known.
189
192 http://sjeng.org/vorbisgain.html
193 Home page for VorbisGain. The latest version, and a Windows exe‐
194 cutable, can be found here.
195 http://www.replaygain.org/
198 Contains detailed information about ReplayGain and how it is
199 calculated.
200 http://www.hydrogenaudio.org/
203 Discussion forum for audio compression and related issues,
204 including Ogg Vorbis and VorbisGain.
205 2004 Jan 3 vorbisgain(1)