                               MP3LINT
                               -------

mp3lint is a tool to check collections of audio files for various
problems. It is highly configurable, allowing you to specify your
preferred format for filenames, minimum bitrate, tests to ignore,
etc. Formats checked are currently mp3, ogg, wav, flac, au, and m3u
playlists.  mp3lint is implemented as separate tools (perl modules),
each of which implements a set of tests. There are a total of 33
different tests.

DOWNLOADING

The latest version is at http://nessie.mcc.ac.uk/~ianb/projects/mp3lint/

You will first need to install libmp3-archive-perl, available from the
same place, which provides the perl module MP3::Archive.

After installing, see the mp3lint(1) manpage for details of other
software mp3lint can use to extend its abilities.

INSTALLING

To install, you use the standard perl installation method of:

$ tar xzvvf mp3lint-VERSION.tar.gz
$ cd mp3lint-VERSION
$ perl Makefile.PL
$ make

then, as root:

# make install

VERSION is the current version, eg 0.9

PORTABILITY

mp3lint should run on any modern unix system. I haven't yet tried it
under windows. If anyone tries, I would appreciate feedback.

I've tried to avoid the latest features of perl, but you may run into
problems if you have an old version of ExtUtils::MakeMaker (perl's
installer). Version 6.16 definately works. See mp3lint(1) for more
details of software and versions needed.

TODO

Windows support
A configurator, to make configuring .mp3lintrc easier.
A gui (if I'm feeling ambitious) to help fix problems found by mp3lint.

FEEDBACK

Bug reports, fixes, compliments or (constructive) criticisms would be
appreciated, to ianb@nessie.mcc.ac.uk.

COPYRIGHT

Copyright 2003 Ian Beckwith <ianb@nessie.mcc.ac.uk>

This program 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 program 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, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.



