README

NAME
    Music::Tag - Interface for collecting information about music files.

VERSION
    Music-Tag-0.4103

DESCRIPTION
    Extendable module for working with Music Tags. Music::Tag Is powered by
    various plugins that collect data about a song based on whatever
    information has already been discovered.

    The motivation behind this was to provide a convenient method for fixing
    broken tags in music files. This developed into a universal interface to
    various music file tagging schemes and a convenient way to augment this
    from online databases.

    Several plugin modules to find information about a music file and write
    it back into the tag are available. These modules will use available
    information (REQUIRED DATA VALUES and USED DATA VALUES) and set various
    data values back to the tag.

INSTALLATION
    To install this module type the following:

       perl Makefile.PL
       make
       make test
       make install

  IMPORTANT NOTE
    If you have installed older versions (older than .25) PLEASE delete the
    following scripts from your bin folder: autotag, safetag, quicktag,
    musicsort, musicinfo.

    If you used any of these scripts, create a symbolic link to musictag for
    each.

  QUICK INSTALL OF ALL PACKAGES
    A bundle is available to quickly install Music::Tag with all plugins. To
    install it use:

       perl -MCPAN -eshell

    At the cpan shell prompt type:

       install Bundle::Music::Tag

DEPENDENCIES
    This module requires these other modules and libraries:

       Encode
       File::Spec
       Locale::Country
       Digest::SHA1
       Config::Options
       Time::Local
       Test::More
       File::Copy
       File::Slurp
       File::stat
       IO::File
       Scalar::Util
       DateTimeX::Easy

    I strongly recommend the following to improve web searches:

       Lingua::EN::Inflect
       Text::LevenshteinXS
       Text::Unaccent::PurePerl

    The following just makes things pretty:

       Term::ANSIColor

EXECUTABLE SCRIPT
    An executable script, musictag is included. This script allows quick
    tagging of MP3 files and access to the plugins. To learn more, use:

       musictag --help 
       musictag --longhelp

SOURCE
    Source is available at github: http://github.com/riemann42/Music-Tag.

AUTHOR
    Edward Allen III <ealleniii _at_ cpan _dot_ org>

COPYRIGHT
    Copyright © 2007,2008,2010 Edward Allen III. Some rights reserved.

LICENSE
    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself, either:

    a) the GNU General Public License as published by the Free Software
    Foundation; either version 1, or (at your option) any later version, or

    b) the "Artistic License" which comes with Perl.

    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 either the GNU
    General Public License or the Artistic License for more details.

    You should have received a copy of the Artistic License with this Kit,
    in the file named "Artistic". If not, I'll be glad to provide one.

    You should also have received a copy of the GNU General Public License
    along with this program in the file named "Copying". If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA or visit their web page on the Internet at
    http://www.gnu.org/copyleft/gpl.html.