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:

1. the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or
2. 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.