debian/0000755000000000000000000000000012211155370007163 5ustar debian/README.source0000644000000000000000000000057011702650736011356 0ustar normalize-audio for Debian -------------------------- This package uses quilt to manage all modifications to the upstream source. Changes are stored in the source package as diffs in debian/patches and applied during the build. See /usr/share/doc/quilt/README.source for a detailed explanation. -- Joachim Reichel Mon, 09 Jan 2012 21:03:18 +0100 debian/rules0000755000000000000000000000202112021205205010226 0ustar #!/usr/bin/make -f # export DH_VERBOSE=1 CFLAGS := $(CFLAGS) -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 %: dh $@ --with autoreconf override_dh_autoreconf: touch AUTHORS ChangeLog dh_autoreconf override_dh_auto_configure: dh_auto_configure -- --host=$(DEB_HOST_GNU_TYPE) --build=$(DEB_BUILD_GNU_TYPE) \ --prefix=/usr --mandir=\$${prefix}/share/man \ --with-mad --with-audiofile --disable-xmms --enable-longer-name override_dh_clean: rm -f xmms-rva/Makefile dh_clean override_dh_autoreconf_clean: rm -rf AUTHORS ChangeLog dh_autoreconf_clean override_dh_install: dh_install (cd $(CURDIR)/debian/normalize-audio/usr/share; \ mv locale/en_GB/LC_MESSAGES/normalize.mo locale/en_GB/LC_MESSAGES/normalize-audio.mo; \ mv locale/fr/LC_MESSAGES/normalize.mo locale/fr/LC_MESSAGES/normalize-audio.mo; \ mv man/man1/normalize.1 man/man1/normalize-audio.1) override_dh_installchangelogs: dh_installchangelogs NEWS override_dh_link: dh_link usr/share/man/man1/normalize-mp3.1.gz usr/share/man/man1/normalize-ogg.1.gz debian/README.Debian0000644000000000000000000000107111702650736011235 0ustar normalize-audio for Debian -------------------------- The package name and binary have been changed due to namespace conflicts. The binary normalize was renamed to normalize-audio so that it keeps orthogonal with its frontend names (normalize-ogg and normalize-mp3) while not using a generic name anymore. For more information see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=250390 The frontend xmms-normalize is not build because it is buggy, unsupported and unmaintained upstream. -- Joachim Reichel Mon, 09 Jan 2012 21:03:18 +0100 debian/copyright0000644000000000000000000000241511765114047011131 0ustar Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: normalize Source: http://normalize.nongnu.org/ Files: * Copyright: 1999-2005 Chris Vaill License: GPL-2+ Files: src/getopt.h src/getopt.c src/getopt1 Copyright: 1989,90,91,92,93,94,96,97 Free Software Foundation, Inc. License: GPL-2+ Files: debian/* Copyright: 2006 Florian Ernst 2007, 2009, 2010, 2012 Joachim Reichel License: GPL-2+ License: GPL-2+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see . On Debian systems, the complete text of the GNU General Public License version 2 can be found in "/usr/share/common-licenses/GPL-2". debian/source/0000755000000000000000000000000011702650736010475 5ustar debian/source/format0000644000000000000000000000001411702650736011703 0ustar 3.0 (quilt) debian/control0000644000000000000000000000155712210706520010574 0ustar Source: normalize-audio Section: sound Priority: extra Maintainer: Joachim Reichel Build-Depends: debhelper (>= 9), autotools-dev, dh-autoreconf, pkg-config, libaudiofile-dev, libmad0-dev, mpg321, vorbis-tools, flac, perl-modules Standards-Version: 3.9.4 Homepage: http://normalize.nongnu.org/ Package: normalize-audio Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends}, ${perl:Depends} Replaces: normalize Conflicts: normalize Suggests: mpg321 Recommends: vorbis-tools, flac Description: adjusts the volume of WAV, MP3 and OGG files to a standard volume level normalize-audio is a tool for adjusting the volume of WAV, MP3 and OGG files to a standard volume level. This is useful for things like creating mix CDs and MP3 databases, where different recording levels on different albums can cause the volume to vary greatly from song to song. debian/watch0000644000000000000000000000012011702650736010217 0ustar version=3 http://savannah.nongnu.org/download/normalize/normalize-(.*)\.tar\.gz debian/changelog0000644000000000000000000001722612211155247011050 0ustar normalize-audio (0.7.7-12) unstable; urgency=low * Add missing Depends: on ${perl:Depends} (Closes: #721452). * Update Standards-Version to 3.9.4 (no changes needed). -- Joachim Reichel Mon, 02 Sep 2013 20:36:11 +0200 normalize-audio (0.7.7-11) unstable; urgency=low * Enable LFS support (Closes: #686590). -- Joachim Reichel Mon, 03 Sep 2012 21:54:19 +0200 normalize-audio (0.7.7-10) unstable; urgency=low * Fix Format: line in debian/copyright. * Install NEWS file as upstream changelog. -- Joachim Reichel Sun, 10 Jun 2012 14:56:08 +0200 normalize-audio (0.7.7-9) unstable; urgency=low * Change packaging format to "3.0 (quilt)" (Closes: #668782). * Use new minimal debian/rules file and debhelper compat level 9. * Use DEP5 format for debian/copyright. * Update Standards-Version to 3.9.3 (no changes needed). -- Joachim Reichel Sun, 15 Apr 2012 16:23:36 +0200 normalize-audio (0.7.7-8) unstable; urgency=low * Add patch fix-configure-ac.dpatch to fix audiofile detection for audiofile >= 0.3.2-1 and other problems related to configure.ac (Closes: #655181), thanks to Ilya Barygin for the patch. * Update Standards-Version to 3.9.2 (no changes needed). -- Joachim Reichel Mon, 09 Jan 2012 19:35:55 +0100 normalize-audio (0.7.7-7) unstable; urgency=low * Add patch fix-encoder-decoder-detection.dpatch to detect encoder and decoder dynamically at runtime. This results in better defaults depending on the user's environment and avoids data loss if no suitable encoder/decoder is found (see also LP #109581 and #493562). * Update patch fix-manpage.dpatch to use \- instead of - to represent minus signs. * Update Standards-Version to 3.8.4 (no changes needed). -- Joachim Reichel Wed, 16 Jun 2010 19:46:39 +0200 normalize-audio (0.7.7-6) unstable; urgency=low * Add patch compressed-wav-files.dpatch to fix buffer overflows in case of compressed WAV files (Closes: 558399), thanks to Stefan Fritsch for the patch. -- Joachim Reichel Sat, 28 Nov 2009 17:27:42 +0100 normalize-audio (0.7.7-5) unstable; urgency=low * Fix error in handling of "noopt" in $(DEB_BUILD_OPTIONS) (see also #552961). * Add handling of "nostrip" in $(DEB_BUILD_OPTIONS). * Fix lintian errors copyright-with-old-dh-make-debian-copyright and patch-system-but-no-source-readme. * Update Standards-Version to 3.8.3 (no changes needed). -- Joachim Reichel Sun, 22 Nov 2009 22:11:04 +0100 normalize-audio (0.7.7-4) unstable; urgency=low * Upload 0.7.7-3 to unstable (no further changes). -- Joachim Reichel Sun, 15 Feb 2009 15:52:31 +0100 normalize-audio (0.7.7-3) experimental; urgency=low * Provide sane default for $MP3ENCODE (Closes: #497652) * Update Standards-Version to 3.8.0 (no changes needed). -- Joachim Reichel Thu, 29 Jan 2009 21:15:50 +0100 normalize-audio (0.7.7-2) unstable; urgency=low * New maintainer (Closes: #406511) * Use File::Copy instead of rename to avoid EXDEV (Closes: #336808, #337396) * Use dpatch to handle patches -- Joachim Reichel Sun, 02 Sep 2007 22:21:29 +0200 normalize-audio (0.7.7-1) unstable; urgency=medium * urgency=medium in order to get this into etch in time * New maintainer (Closes: #391130) + many thanks to Eduardo Marcel Macan for all his work! + acknowledge previous upload which dak considered a NMU * New upstream release (Closes: #387252) + incorporates en_GB and fr localization from previous version + incorporates debian/normalize-mp3.1 * Allow working with FLAC files, thanks to Akira Yamanita for bugreport and patch (Closes: #343977) * debian/changelog: remove cruft * debian/control: add Homepage * debian/copyright: updated * debian/rules: redone from scratch, auto-updating config.{sub,guess} (Closes: #317351) * debian/watch: added * Correct references in manual pages (Closes: #323072) * Remove duplicate pot file (Closes: #352206) * Standards-Version 3.7.2 -- Florian Ernst Thu, 12 Oct 2006 11:06:40 +0200 normalize-audio (0.7.6-7) unstable; urgency=low * Normalize frontends fixed to use the "normalize-audio" binary (Closes: 305367) * GNU config automated update: config.sub (20041130 to 20050210), config.guess (20041112 to 20050324) -- macan Tue, 26 Apr 2005 16:02:28 -0300 normalize-audio (0.7.6-6) unstable; urgency=low * Fixed potfile generation and instalation (Closes: #290274) * Fixed normalize name in scripts (Closes: #292692) -- Eduardo Marcel Macan Sun, 13 Mar 2005 15:38:15 -0300 normalize-audio (0.7.6-5) unstable; urgency=low * GNU config automated update: config.sub (20040312 to 20041130), config.guess (20040312 to 20041112) -- Eduardo Marcel Macan Sun, 13 Mar 2005 15:14:40 -0300 normalize-audio (0.7.6-4) unstable; urgency=low * xmms-normalize was buggy, unsupported and depended on old gtk. It's not being generated anymore. Use xmms-volnorm instead. * README.Debian now contains information (closes:#254767) * Package renamed to normalize-audio (closes: #250390) * GNU config automated update: config.sub (20010907 to 20040312), config.guess (20010904 to 20040312) -- Eduardo Marcel Macan Mon, 28 Jun 2004 23:01:43 -0300 normalize (0.7.6-3) unstable; urgency=low * uses new libtool version to fix mipsel and mips builds (Closes: #176712) -- Eduardo Marcel Macan Mon, 14 Jul 2003 15:33:34 -0300 normalize (0.7.6-2) unstable; urgency=low * xmms-normalize package added -- Eduardo Marcel Macan Sun, 12 Jan 2003 13:02:19 -0200 normalize (0.7.6-1) unstable; urgency=low * New upstream release ( Closes: #137323, #155988, #137396, #155983 ) Whew! -- Eduardo Marcel Macan Mon, 9 Sep 2002 14:58:47 +0000 normalize (0.7.5-2) unstable; urgency=low * Fixed a typo in the Suggests: field * Fixed info about --mp3encode in --help (Closes: #155986) * Added vorbis-tools to the build depends and to Recommends: fields -- Eduardo Marcel Macan Sat, 7 Sep 2002 22:30:13 +0000 normalize (0.7.5-1) unstable; urgency=low * Compiled with audiofile support * Compiled with MAD support (Closes: #144852) * New upstream release -- Eduardo Marcel Macan Mon, 29 Apr 2002 01:58:31 +0000 normalize (0.7.2-1) unstable; urgency=low * NMU (Macan asked me to do it) * New upstream version (Closes: #130808) * debian/README.Debian, *ex, ex*: - removed (Closes: #130811) * debian/rules: - dh_installchangelogs NEWS (Closes: #130809) * I prepared upstream tarball before uupdate'ing to remove the upstream debian/ directory and copied the files from the 0.6.1-1.1 version -- Gustavo Noronha Silva Thu, 21 Feb 2002 18:44:56 -0300 normalize (0.6.1-1.1) unstable; urgency=low * NMU * Remove bogus build-depend on debmake, and add needed build-depend on debhelper. (closes: Bug#112108) -- Doug Porter Wed, 17 Oct 2001 09:37:50 -0600 normalize (0.6.1-1) unstable; urgency=low * New upstream release (closes: Bug#105850) -- Eduardo Marcel Macan Wed, 12 Sep 2001 14:08:05 +0000 normalize (0.3.4-2) unstable; urgency=low * Fixed Build Dependencies (closes: Bug#89606) -- Eduardo Marcel Macan Tue, 27 Mar 2001 15:19:49 +0000 normalize (0.3.4-1) unstable; urgency=low * Initial release. -- Eduardo Marcel Macan Wed, 3 Jan 2001 13:12:38 -0200 debian/compat0000644000000000000000000000000211742554063010373 0ustar 9 debian/patches/0000755000000000000000000000000011704554650010624 5ustar debian/patches/rename-binary.patch0000644000000000000000000000561111704554650014401 0ustar Author: Joachim Reichel Description: replace all user-visible occurrences of "normalize" by "normalize-audio" --- a/doc/normalize-mp3.1 +++ b/doc/normalize-mp3.1 @@ -1,7 +1,7 @@ .TH NORMALIZE-MP3 "1" "September 2001" .SH NAME normalize-mp3 - adjust levels of mp3 or ogg files by running -normalize(1), then re-encoding +normalize-audio(1), then re-encoding .SH SYNOPSIS \fB normalize-mp3 [\fIOPTION\fR]... [\fIFILE\fR]... @@ -54,8 +54,8 @@ \fB\-V\fR Display version information and exit. .TP -\fBThese arguments are passed as arguments to normalize. -Run "normalize \fB\-\-help\fR" for more info. +\fBThese arguments are passed as arguments to normalize-audio. +Run "normalize-audio \fB\-\-help\fR" for more info. .TP \fB\-a\fR AMP .TP @@ -77,7 +77,7 @@ Report bugs to . .SH "SEE ALSO" The -.B normalize(1) +.B normalize-audio(1) Man page .SH "NOTES" This page was provided by Eduardo Maçan --- a/doc/normalize.1 +++ b/doc/normalize.1 @@ -3,22 +3,22 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "NORMALIZE" "1" "14 September 2005" "" "" +.TH "NORMALIZE-AUDIO" "1" "14 September 2005" "" "" .SH NAME -normalize \- adjusts volume levels of audio files. +normalize-audio \- adjusts volume levels of audio files. .SH SYNOPSIS -\fBnormalize\fR [ \fB\fIoptions\fB\fR ] [ \fB--\fR ] \fB\fIfile\fB\fR\fI ...\fR +\fBnormalize-audio\fR [ \fB\fIoptions\fB\fR ] [ \fB--\fR ] \fB\fIfile\fB\fR\fI ...\fR .SH "DESCRIPTION" .PP -\fBnormalize\fR is used to adjust the volume of wav audio +\fBnormalize-audio\fR is used to adjust the volume of wav audio files to a standard volume level. This is useful for things like creating mp3 mixes, where different recording levels on different albums can cause the volume to vary greatly from song to song. .PP -\fBnormalize\fR operates in two phases. In the first phase, it +\fBnormalize-audio\fR operates in two phases. In the first phase, it analyzes the specified files as wav audio files, and computes the volume of each file. In the second phase, it applies a volume adjustment to each file to set each file's volume to a standard level. @@ -186,7 +186,7 @@ ID3v2 tags, you don't need it. .SH "CAVEATS" .PP -Note that your version of \fBnormalize\fR must be +Note that your version of \fBnormalize-audio\fR must be compiled with MAD library support to analyze MP3 file volume levels. .SH "AUTHOR" .PP --- a/src/normalize-mp3.in +++ b/src/normalize-mp3.in @@ -61,7 +61,7 @@ -g ADJ | -n | -T THR |_ These arguments are passed as arguments to normalize. - -b | Run "normalize --help" for more info. + -b | Run "normalize-audio --help" for more info. -m | -v | -q / debian/patches/fix-configure-ac.patch0000644000000000000000000000266411704554650015003 0ustar Author: Ilya Barygin Description: - Add AM_PROG_CC_C_O required by newer automake versions. - Avoid autoconf errors related to AM_PATH_GLIB, AM_PATH_GTK, and AM_PATH_XMMS by using pkg-config instead. - audiofile >= 0.3.2-1 does no longer provide audiofile-config and the AM_PATH_AUDIOFILE macro based on it. Use pkg-config instead (see #655181). --- a/configure.ac +++ b/configure.ac @@ -12,6 +12,7 @@ AC_CANONICAL_HOST AC_PROG_CC +AM_PROG_CC_C_O AC_ISC_POSIX AC_PROG_INSTALL AC_PROG_LN_S @@ -221,9 +222,9 @@ dnl *** Stuff for xmms plugin *** have_xmms=true -AM_PATH_GLIB(1.2.2, , [ have_xmms=false ]) -AM_PATH_GTK(1.2.2, , [ have_xmms=false ], gthread) -AM_PATH_XMMS(1.0.0, , [ have_xmms=false ]) +PKG_CHECK_MODULES([GLIB], [glib-2.0], , [ have_xmms=false ]) +PKG_CHECK_MODULES([GTK], [gtk-2.0], , [ have_xmms=false ]) +PKG_CHECK_MODULES([XMMS], [xmms2-client], , [ have_xmms=false ]) AM_DISABLE_STATIC AM_PROG_LIBTOOL AC_ARG_ENABLE(xmms, @@ -249,7 +250,8 @@ dnl *** Stuff for audiofile library *** dnl v0.2.1 and before have bugs with 24-bit LE files -AM_PATH_AUDIOFILE([ 0.2.2 ], [ have_audiofile=true ]) +PKG_CHECK_MODULES([AUDIOFILE], [audiofile >= 0.2.2], [have_audiofile=true], []) +dnl AM_PATH_AUDIOFILE([ 0.2.2 ], [ have_audiofile=true ]) dnl AC_CHECK_LIB(audiofile, afSetVirtualSampleFormat, have_audiofile=true) AH_TEMPLATE([USE_AUDIOFILE], [Define if you want to use the audiofile library.]) debian/patches/compressed-wav-files.patch0000644000000000000000000000137711704554650015714 0ustar Author: Stefan Fritsch Description: afGetVirtualFrameSize() needs to be used instead of afGetFrameSize(), otherwise the allocated buffer size is too small for compressed WAV files (see #558399). --- a/src/adjust.c +++ b/src/adjust.c @@ -277,8 +277,8 @@ /* set up buffer to hold 1/100 of a second worth of frames */ frames_in_buf = samp_rate / 100; - src_framesz = afGetFrameSize(fhin, AF_DEFAULT_TRACK, 1); - dst_framesz = afGetFrameSize(fhout, AF_DEFAULT_TRACK, 1); + src_framesz = afGetVirtualFrameSize(fhin, AF_DEFAULT_TRACK, 1); + dst_framesz = afGetVirtualFrameSize(fhout, AF_DEFAULT_TRACK, 1); src_buf = (unsigned char *)xmalloc(frames_in_buf * src_framesz); dst_buf = (unsigned char *)xmalloc(frames_in_buf * dst_framesz); debian/patches/fix-encoder-decoder-detection.patch0000644000000000000000000000226311704554650017432 0ustar Author: Joachim Reichel Description: Detect encoder and decoder dynamically at runtime. This results in better defaults depending on the user's environment and avoids data loss if no suitable encoder/decoder is found. --- a/src/normalize-mp3.in +++ b/src/normalize-mp3.in @@ -26,12 +26,12 @@ # %b becomes bitrate of re-encoded file, as specified by the -b option # Example: $OGGENCODE="oggenc -Q -b %b -o %m %w" -$MP3DECODE = "@MP3DECODE@"; -$MP3ENCODE = "@MP3ENCODE@"; -$OGGDECODE = "@OGGDECODE@"; -$OGGENCODE = "@OGGENCODE@"; -$FLACDECODE = "@FLACDECODE@"; -$FLACENCODE = "@FLACENCODE@"; +# $MP3DECODE = "@MP3DECODE@"; +# $MP3ENCODE = "@MP3ENCODE@"; +# $OGGDECODE = "@OGGDECODE@"; +# $OGGENCODE = "@OGGENCODE@"; +# $FLACDECODE = "@FLACDECODE@"; +# $FLACENCODE = "@FLACENCODE@"; # The %w etc. substitutions should *not* be used in the following, as # this script knows about their options already. @@ -614,7 +614,7 @@ } unless ($encoder) { - print STDERR "$progname: $output_file: no decoder available\n"; + print STDERR "$progname: $output_file: no encoder available\n"; print STDERR "$progname: leaving output in $tmp_file\n"; next; } debian/patches/fix-flac.patch0000644000000000000000000000067211704554650013343 0ustar Author: Joachim Reichel Description: fix typo w.r.t. flac support --- a/src/normalize-mp3.in +++ b/src/normalize-mp3.in @@ -295,7 +295,7 @@ $path = find_prog("flac"); if ($path) { $path .= " -s -d -o %w %m"; - $FLAC = $path; + $FLACDECODE = $path; } } @@ -304,7 +304,7 @@ $path = find_prog("flac"); if ($path) { $path .= " -s -o %m %w"; - $FLAC = $path; + $FLACENCODE = $path; } } debian/patches/fix-exdev-error.patch0000644000000000000000000000104211704554650014670 0ustar Author: Joachim Reichel Description: use move instead of rename to avoid EXDEV, see #336808 and #337396 --- a/src/normalize-mp3.in +++ b/src/normalize-mp3.in @@ -47,6 +47,7 @@ ####################################################################### use Fcntl; +use File::Copy; sub usage { print < Description: Replace invalid groff input character by corresponding escape sequence. Use \- instead of - to represent minus signs. --- a/doc/normalize-mp3.1 +++ b/doc/normalize-mp3.1 @@ -33,7 +33,7 @@ The following four options may be used to set the encoder and decoder commands for mp3 and ogg vorbis. %m is expanded to the name of the mp3 or vorbis file, %w expands to the name of the temporary WAV file, -and %b expands to the bitrate, as specified by the --bitrate option. +and %b expands to the bitrate, as specified by the \-\-bitrate option. Run \fBnormalize-mp3\fR with no arguments to see the default values. .TP \fB--mp3encode=\fIX\fR @@ -80,4 +80,4 @@ .B normalize-audio(1) Man page .SH "NOTES" -This page was provided by Eduardo Maçan +This page was provided by Eduardo Ma\[,c]an --- a/doc/normalize.1 +++ b/doc/normalize.1 @@ -3,126 +3,126 @@ .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . -.TH "NORMALIZE-AUDIO" "1" "14 September 2005" "" "" +.TH "NORMALIZE\-AUDIO" "1" "14 September 2005" "" "" .SH NAME -normalize-audio \- adjusts volume levels of audio files. +normalize\-audio \- adjusts volume levels of audio files. .SH SYNOPSIS -\fBnormalize-audio\fR [ \fB\fIoptions\fB\fR ] [ \fB--\fR ] \fB\fIfile\fB\fR\fI ...\fR +\fBnormalize\-audio\fR [ \fB\fIoptions\fB\fR ] [ \fB\-\-\fR ] \fB\fIfile\fB\fR\fI ...\fR .SH "DESCRIPTION" .PP -\fBnormalize-audio\fR is used to adjust the volume of wav audio +\fBnormalize\-audio\fR is used to adjust the volume of wav audio files to a standard volume level. This is useful for things like creating mp3 mixes, where different recording levels on different albums can cause the volume to vary greatly from song to song. .PP -\fBnormalize-audio\fR operates in two phases. In the first phase, it +\fBnormalize\-audio\fR operates in two phases. In the first phase, it analyzes the specified files as wav audio files, and computes the volume of each file. In the second phase, it applies a volume adjustment to each file to set each file's volume to a standard level. .SH "OPTIONS" .TP -\fB-a, --amplitude=\fIAMPLITUDE\fB\fR +\fB\-a, \-\-amplitude=\fIAMPLITUDE\fB\fR Adjust the RMS volume to the target amplitude AMPLITUDE; must be between 0.0 and 1.0. If a number suffixed by "dB" or "dBFS" is specified, the amplitude is assumed to be in decibels from full scale. -The default is -12dBFS. +The default is \-12dBFS. .TP -\fB-b, --batch\fR +\fB\-b, \-\-batch\fR Enable batch mode: see BATCH MODE, below. .TP -\fB-c, --compression\fR +\fB\-c, \-\-compression\fR \fBDeprecated\fR\&. In previous versions, this enabled the limiter, but now the limiter is enabled by default. .TP -\fB--clipping\fR +\fB\-\-clipping\fR Disable the limiter, and just clip any samples that are too large. -Same effect as -l 0dBFS. +Same effect as \-l 0dBFS. .TP -\fB--fractions\fR +\fB\-\-fractions\fR Display all values as decimal fractions instead of in decibels. By default, volume adjustments are shown in decibels, and volume levels in dBFS, where 0 dBFS is the level of a square wave of maximum amplitude. .TP -\fB-g, --gain=\fIGAIN\fB\fR +\fB\-g, \-\-gain=\fIGAIN\fB\fR Skip the volume computation phase: don't compute the volume adjustment from the current volumes of the files. Instead, just apply the given gain as a volume adjustment to all files. As a plain number this is just a multiplier applied to all samples, If a number suffixed by "dB" is specified, all volumes are adjusted by that many decibels. .TP -\fB--id3-compat\fR +\fB\-\-id3\-compat\fR Use this option when adjusting MPEG audio files if your MP3 player does not recognize ID3v2.4 tags. See MPEG AUDIO ADJUSTMENT, below, for details. .TP -\fB--id3-unsync\fR +\fB\-\-id3\-unsync\fR Use this option when adjusting MPEG audio files if your MP3 player does not recognize ID3v2 tags and has trouble playing some ID3v2 tagged MP3 files. See MPEG AUDIO ADJUSTMENT, below, for details. .TP -\fB-l, --limiter=\fILEVEL\fB\fR +\fB\-l, \-\-limiter=\fILEVEL\fB\fR This controls the behavior of the limiter. By default, all samples -above -6dBFS (0.5) are limited, but this option sets the limiting +above \-6dBFS (0.5) are limited, but this option sets the limiting level to \fILEVEL\fR\&. Setting \fILEVEL\fR to 1 (or 0dBFS) does no limiting (clipping is done instead); setting \fILEVEL\fR to 0 does limiting on all samples. The default value is recommended unless you know what you're doing. .TP -\fB-m, --mix\fR +\fB\-m, \-\-mix\fR Enable mix mode: see MIX MODE, below. Batch mode and mix mode are mutually exclusive. .TP -\fB-n, --no-adjust\fR +\fB\-n, \-\-no\-adjust\fR Compute and output the volume adjustment that would set the volume to the target, but don't apply it to any of the files (i.e. skip the second phase). If you use this option, your files will not be altered in any way. .TP -\fB--no-progress\fR +\fB\-\-no\-progress\fR Don't print any progress information. All other messages are printed as normal according to the verbosity level. .TP -\fB--peak\fR +\fB\-\-peak\fR Adjust using peak levels instead of RMS levels. Each file will be adjusted so that its maximum sample is at full scale. This just gives a file the maximum volume possible without clipping; no normalization is done. .TP -\fB-q, --quiet\fR +\fB\-q, \-\-quiet\fR Don't output progress information. Only error messages are printed. .TP -\fB-t, --average-threshold=\fITHRESHOLD\fB\fR +\fB\-t, \-\-average\-threshold=\fITHRESHOLD\fB\fR When averaging volume levels for batch mode or mix mode, throw out any volumes that are more than \fITHRESHOLD\fR decibels from the average. A high value here (say, 50) will make sure that the volumes of all files are considered in the average. .TP -\fB-T, --adjust-threshold=\fITHRESHOLD\fB\fR +\fB\-T, \-\-adjust\-threshold=\fITHRESHOLD\fB\fR If an adjustment to be made to a file is smaller than \fITHRESHOLD\fR decibels, consider the file already normalized and don't do the adjustment. This is 0.125 by -default, or 0 if the \fB-g\fR option is given. +default, or 0 if the \fB\-g\fR option is given. .TP -\fB-v, --verbose\fR +\fB\-v, \-\-verbose\fR Increase verbosity. This option can be repeated for more messages. .TP -\fB-w, --output-bitwidth\fR +\fB\-w, \-\-output\-bitwidth\fR Force output files to have samples that are W bits wide. This option is ignored when adjusting MP3 files. .TP -\fB-h, --help\fR +\fB\-h, \-\-help\fR Display usage information and exit. .TP -\fB-V, --version\fR +\fB\-V, \-\-version\fR Print version information and exit. .TP -\fB--\fR +\fB\-\-\fR Terminate option list. .SH "MIX MODE" .PP @@ -167,18 +167,18 @@ tag with the same format as an RVA2 tag. This isn't a native frame, but since it starts with an "X", it's considered experimental and therefore legal, according to the ID3 spec. The -\fB--id3-compat\fR option turns on this behavior. +\fB\-\-id3\-compat\fR option turns on this behavior. The disadvantage of the first method is that your MP3 player may no longer read the ID3 tags on your files. Bug the author of your favorite MP3 player to support ID3v2.4 tags! .PP The disadvantage of the second method is that the XRVA frame is only -recognized by the xmms-rva plugin that is packaged with normalize. On +recognized by the xmms\-rva plugin that is packaged with normalize. On the other hand, I don't know of any MP3 players that recognize the RVA2 frame, either, so it may not make any difference. .PP The other option related to ID3 tags, -\fB--id3-unsync\fR, is only necessary for +\fB\-\-id3\-unsync\fR, is only necessary for compatibility with old MP3 players that don't recognize ID3v2 tags at all. If your MP3 player complains of garbage at the start of tagged files, or is unable to play the files at all, turn this option on. @@ -186,7 +186,7 @@ ID3v2 tags, you don't need it. .SH "CAVEATS" .PP -Note that your version of \fBnormalize-audio\fR must be +Note that your version of \fBnormalize\-audio\fR must be compiled with MAD library support to analyze MP3 file volume levels. .SH "AUTHOR" .PP debian/docs0000644000000000000000000000001411702650736010043 0ustar README TODO